postiz-agent 0.2.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (40) hide show
  1. postiz_agent-0.2.0/LICENSE +21 -0
  2. postiz_agent-0.2.0/MANIFEST.in +4 -0
  3. postiz_agent-0.2.0/PKG-INFO +161 -0
  4. postiz_agent-0.2.0/README.md +140 -0
  5. postiz_agent-0.2.0/postiz_agent/__init__.py +68 -0
  6. postiz_agent-0.2.0/postiz_agent/__main__.py +6 -0
  7. postiz_agent-0.2.0/postiz_agent/agent/A2A_AGENTS.md +8 -0
  8. postiz_agent-0.2.0/postiz_agent/agent/AGENTS.md +12 -0
  9. postiz_agent-0.2.0/postiz_agent/agent/CRON.md +12 -0
  10. postiz_agent-0.2.0/postiz_agent/agent/CRON_LOG.md +5 -0
  11. postiz_agent-0.2.0/postiz_agent/agent/HEARTBEAT.md +28 -0
  12. postiz_agent-0.2.0/postiz_agent/agent/IDENTITY.md +15 -0
  13. postiz_agent-0.2.0/postiz_agent/agent/MCP_AGENTS.md +13 -0
  14. postiz_agent-0.2.0/postiz_agent/agent/MEMORY.md +8 -0
  15. postiz_agent-0.2.0/postiz_agent/agent/USER.md +7 -0
  16. postiz_agent-0.2.0/postiz_agent/agent/icon.png +0 -0
  17. postiz_agent-0.2.0/postiz_agent/agent_data/A2A_AGENTS.md +8 -0
  18. postiz_agent-0.2.0/postiz_agent/agent_data/CRON.md +7 -0
  19. postiz_agent-0.2.0/postiz_agent/agent_data/CRON_LOG.md +4 -0
  20. postiz_agent-0.2.0/postiz_agent/agent_data/HEARTBEAT.md +9 -0
  21. postiz_agent-0.2.0/postiz_agent/agent_data/IDENTITY.md +15 -0
  22. postiz_agent-0.2.0/postiz_agent/agent_data/MCP_AGENTS.md +25 -0
  23. postiz_agent-0.2.0/postiz_agent/agent_data/MEMORY.md +6 -0
  24. postiz_agent-0.2.0/postiz_agent/agent_data/NODE_AGENTS.md +13 -0
  25. postiz_agent-0.2.0/postiz_agent/agent_data/USER.md +4 -0
  26. postiz_agent-0.2.0/postiz_agent/agent_data/mcp_config.json +21 -0
  27. postiz_agent-0.2.0/postiz_agent/agent_server.py +79 -0
  28. postiz_agent-0.2.0/postiz_agent/auth.py +39 -0
  29. postiz_agent-0.2.0/postiz_agent/mcp_server.py +311 -0
  30. postiz_agent-0.2.0/postiz_agent/postiz_api.py +224 -0
  31. postiz_agent-0.2.0/postiz_agent/postiz_models.py +142 -0
  32. postiz_agent-0.2.0/postiz_agent.egg-info/PKG-INFO +161 -0
  33. postiz_agent-0.2.0/postiz_agent.egg-info/SOURCES.txt +38 -0
  34. postiz_agent-0.2.0/postiz_agent.egg-info/dependency_links.txt +1 -0
  35. postiz_agent-0.2.0/postiz_agent.egg-info/entry_points.txt +3 -0
  36. postiz_agent-0.2.0/postiz_agent.egg-info/requires.txt +7 -0
  37. postiz_agent-0.2.0/postiz_agent.egg-info/top_level.txt +2 -0
  38. postiz_agent-0.2.0/pyproject.toml +41 -0
  39. postiz_agent-0.2.0/requirements.txt +5 -0
  40. postiz_agent-0.2.0/setup.cfg +4 -0
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Audel Rouhi
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,4 @@
1
+ include LICENSE
2
+ include README.md
3
+ include requirements.txt
4
+ recursive-include postiz_agent *.md *.json *.yaml *.yml *.py
@@ -0,0 +1,161 @@
1
+ Metadata-Version: 2.4
2
+ Name: postiz-agent
3
+ Version: 0.2.0
4
+ Summary: Agent for interacting with Postiz Public API
5
+ Author-email: Audel Rouhi <knucklessg1@gmail.com>
6
+ License: MIT
7
+ Classifier: Development Status :: 4 - Beta
8
+ Classifier: License :: OSI Approved :: MIT License
9
+ Classifier: Environment :: Console
10
+ Classifier: Operating System :: POSIX :: Linux
11
+ Classifier: Programming Language :: Python :: 3
12
+ Requires-Python: >=3.10
13
+ Description-Content-Type: text/markdown
14
+ License-File: LICENSE
15
+ Requires-Dist: agent-utilities[mcp]>=0.2.12
16
+ Provides-Extra: agent
17
+ Requires-Dist: agent-utilities[agent,logfire]>=0.2.12; extra == "agent"
18
+ Provides-Extra: all
19
+ Requires-Dist: agent-utilities[agent,logfire,mcp]>=0.2.12; extra == "all"
20
+ Dynamic: license-file
21
+
22
+ # Postiz Agent - A2A | AG-UI | MCP
23
+
24
+ ![PyPI - Version](https://img.shields.io/pypi/v/postiz-agent)
25
+ ![MCP Server](https://badge.mcpx.dev?type=server 'MCP Server')
26
+ ![PyPI - Downloads](https://img.shields.io/pypi/dd/postiz-agent)
27
+ ![GitHub Repo stars](https://img.shields.io/github/stars/Knuckles-Team/postiz-agent)
28
+ ![GitHub forks](https://img.shields.io/github/forks/Knuckles-Team/postiz-agent)
29
+ ![GitHub contributors](https://img.shields.io/github/contributors/Knuckles-Team/postiz-agent)
30
+ ![PyPI - License](https://img.shields.io/pypi/l/postiz-agent)
31
+ ![GitHub](https://img.shields.io/github/license/Knuckles-Team/postiz-agent)
32
+
33
+ ![GitHub last commit (by committer)](https://img.shields.io/github/last-commit/Knuckles-Team/postiz-agent)
34
+ ![GitHub pull requests](https://img.shields.io/github/issues-pr/Knuckles-Team/postiz-agent)
35
+ ![GitHub closed pull requests](https://img.shields.io/github/issues-pr-closed/Knuckles-Team/postiz-agent)
36
+ ![GitHub issues](https://img.shields.io/github/issues/Knuckles-Team/postiz-agent)
37
+
38
+ ![GitHub top language](https://img.shields.io/github/languages/top/Knuckles-Team/postiz-agent)
39
+ ![GitHub language count](https://img.shields.io/github/languages/count/Knuckles-Team/postiz-agent)
40
+ ![GitHub repo size](https://img.shields.io/github/repo-size/Knuckles-Team/postiz-agent)
41
+ ![GitHub repo file count (file type)](https://img.shields.io/github/directory-file-count/Knuckles-Team/postiz-agent)
42
+ ![PyPI - Wheel](https://img.shields.io/pypi/wheel/postiz-agent)
43
+ ![PyPI - Implementation](https://img.shields.io/pypi/implementation/postiz-agent)
44
+
45
+ *Version: 0.2.0*
46
+
47
+ ## Overview
48
+
49
+ **Postiz Agent MCP Server + A2A Agent**
50
+
51
+ Agent for interacting with Postiz Public API
52
+
53
+ This repository is actively maintained - Contributions are welcome!
54
+
55
+ ## MCP
56
+
57
+ ### Using as an MCP Server
58
+
59
+ The MCP Server can be run in two modes: `stdio` (for local testing) or `http` (for networked access).
60
+
61
+ #### Environment Variables
62
+
63
+ * `POSTIZ_URL`: The URL of the target service.
64
+ * `POSTIZ_TOKEN`: The API token or access token.
65
+
66
+ #### Run in stdio mode (default):
67
+ ```bash
68
+ export POSTIZ_URL="http://localhost:8080"
69
+ export POSTIZ_TOKEN="your_token"
70
+ postiz-mcp --transport "stdio"
71
+ ```
72
+
73
+ #### Run in HTTP mode:
74
+ ```bash
75
+ export POSTIZ_URL="http://localhost:8080"
76
+ export POSTIZ_TOKEN="your_token"
77
+ postiz-mcp --transport "http" --host "0.0.0.0" --port "8000"
78
+ ```
79
+
80
+ ## A2A Agent
81
+
82
+ ### Run A2A Server
83
+ ```bash
84
+ export POSTIZ_URL="http://localhost:8080"
85
+ export POSTIZ_TOKEN="your_token"
86
+ postiz-agent --provider openai --model-id gpt-4o --api-key sk-...
87
+ ```
88
+
89
+ ## Docker
90
+
91
+ ### Build
92
+
93
+ ```bash
94
+ docker build -t postiz-agent .
95
+ ```
96
+
97
+ ### Run MCP Server
98
+
99
+ ```bash
100
+ docker run -d \
101
+ --name postiz-agent \
102
+ -p 8000:8000 \
103
+ -e TRANSPORT=http \
104
+ -e POSTIZ_URL="http://your-service:8080" \
105
+ -e POSTIZ_TOKEN="your_token" \
106
+ knucklessg1/postiz-agent:latest
107
+ ```
108
+
109
+ ### Deploy with Docker Compose
110
+
111
+ ```yaml
112
+ services:
113
+ postiz-agent:
114
+ image: knucklessg1/postiz-agent:latest
115
+ environment:
116
+ - HOST=0.0.0.0
117
+ - PORT=8000
118
+ - TRANSPORT=http
119
+ - POSTIZ_URL=http://your-service:8080
120
+ - POSTIZ_TOKEN=your_token
121
+ ports:
122
+ - 8000:8000
123
+ ```
124
+
125
+ #### Configure `mcp.json` for AI Integration (e.g. Claude Desktop)
126
+
127
+ ```json
128
+ {
129
+ "mcpServers": {
130
+ "postiz": {
131
+ "command": "uv",
132
+ "args": [
133
+ "run",
134
+ "--with",
135
+ "postiz-agent",
136
+ "postiz-mcp"
137
+ ],
138
+ "env": {
139
+ "POSTIZ_URL": "http://your-service:8080",
140
+ "POSTIZ_TOKEN": "your_token"
141
+ }
142
+ }
143
+ }
144
+ }
145
+ ```
146
+
147
+ ## Install Python Package
148
+
149
+ ```bash
150
+ python -m pip install postiz-agent
151
+ ```
152
+ ```bash
153
+ uv pip install postiz-agent
154
+ ```
155
+
156
+ ## Repository Owners
157
+
158
+ <img width="100%" height="180em" src="https://github-readme-stats.vercel.app/api?username=Knucklessg1&show_icons=true&hide_border=true&&count_private=true&include_all_commits=true" />
159
+
160
+ ![GitHub followers](https://img.shields.io/github/followers/Knucklessg1)
161
+ ![GitHub User's stars](https://img.shields.io/github/stars/Knucklessg1)
@@ -0,0 +1,140 @@
1
+ # Postiz Agent - A2A | AG-UI | MCP
2
+
3
+ ![PyPI - Version](https://img.shields.io/pypi/v/postiz-agent)
4
+ ![MCP Server](https://badge.mcpx.dev?type=server 'MCP Server')
5
+ ![PyPI - Downloads](https://img.shields.io/pypi/dd/postiz-agent)
6
+ ![GitHub Repo stars](https://img.shields.io/github/stars/Knuckles-Team/postiz-agent)
7
+ ![GitHub forks](https://img.shields.io/github/forks/Knuckles-Team/postiz-agent)
8
+ ![GitHub contributors](https://img.shields.io/github/contributors/Knuckles-Team/postiz-agent)
9
+ ![PyPI - License](https://img.shields.io/pypi/l/postiz-agent)
10
+ ![GitHub](https://img.shields.io/github/license/Knuckles-Team/postiz-agent)
11
+
12
+ ![GitHub last commit (by committer)](https://img.shields.io/github/last-commit/Knuckles-Team/postiz-agent)
13
+ ![GitHub pull requests](https://img.shields.io/github/issues-pr/Knuckles-Team/postiz-agent)
14
+ ![GitHub closed pull requests](https://img.shields.io/github/issues-pr-closed/Knuckles-Team/postiz-agent)
15
+ ![GitHub issues](https://img.shields.io/github/issues/Knuckles-Team/postiz-agent)
16
+
17
+ ![GitHub top language](https://img.shields.io/github/languages/top/Knuckles-Team/postiz-agent)
18
+ ![GitHub language count](https://img.shields.io/github/languages/count/Knuckles-Team/postiz-agent)
19
+ ![GitHub repo size](https://img.shields.io/github/repo-size/Knuckles-Team/postiz-agent)
20
+ ![GitHub repo file count (file type)](https://img.shields.io/github/directory-file-count/Knuckles-Team/postiz-agent)
21
+ ![PyPI - Wheel](https://img.shields.io/pypi/wheel/postiz-agent)
22
+ ![PyPI - Implementation](https://img.shields.io/pypi/implementation/postiz-agent)
23
+
24
+ *Version: 0.2.0*
25
+
26
+ ## Overview
27
+
28
+ **Postiz Agent MCP Server + A2A Agent**
29
+
30
+ Agent for interacting with Postiz Public API
31
+
32
+ This repository is actively maintained - Contributions are welcome!
33
+
34
+ ## MCP
35
+
36
+ ### Using as an MCP Server
37
+
38
+ The MCP Server can be run in two modes: `stdio` (for local testing) or `http` (for networked access).
39
+
40
+ #### Environment Variables
41
+
42
+ * `POSTIZ_URL`: The URL of the target service.
43
+ * `POSTIZ_TOKEN`: The API token or access token.
44
+
45
+ #### Run in stdio mode (default):
46
+ ```bash
47
+ export POSTIZ_URL="http://localhost:8080"
48
+ export POSTIZ_TOKEN="your_token"
49
+ postiz-mcp --transport "stdio"
50
+ ```
51
+
52
+ #### Run in HTTP mode:
53
+ ```bash
54
+ export POSTIZ_URL="http://localhost:8080"
55
+ export POSTIZ_TOKEN="your_token"
56
+ postiz-mcp --transport "http" --host "0.0.0.0" --port "8000"
57
+ ```
58
+
59
+ ## A2A Agent
60
+
61
+ ### Run A2A Server
62
+ ```bash
63
+ export POSTIZ_URL="http://localhost:8080"
64
+ export POSTIZ_TOKEN="your_token"
65
+ postiz-agent --provider openai --model-id gpt-4o --api-key sk-...
66
+ ```
67
+
68
+ ## Docker
69
+
70
+ ### Build
71
+
72
+ ```bash
73
+ docker build -t postiz-agent .
74
+ ```
75
+
76
+ ### Run MCP Server
77
+
78
+ ```bash
79
+ docker run -d \
80
+ --name postiz-agent \
81
+ -p 8000:8000 \
82
+ -e TRANSPORT=http \
83
+ -e POSTIZ_URL="http://your-service:8080" \
84
+ -e POSTIZ_TOKEN="your_token" \
85
+ knucklessg1/postiz-agent:latest
86
+ ```
87
+
88
+ ### Deploy with Docker Compose
89
+
90
+ ```yaml
91
+ services:
92
+ postiz-agent:
93
+ image: knucklessg1/postiz-agent:latest
94
+ environment:
95
+ - HOST=0.0.0.0
96
+ - PORT=8000
97
+ - TRANSPORT=http
98
+ - POSTIZ_URL=http://your-service:8080
99
+ - POSTIZ_TOKEN=your_token
100
+ ports:
101
+ - 8000:8000
102
+ ```
103
+
104
+ #### Configure `mcp.json` for AI Integration (e.g. Claude Desktop)
105
+
106
+ ```json
107
+ {
108
+ "mcpServers": {
109
+ "postiz": {
110
+ "command": "uv",
111
+ "args": [
112
+ "run",
113
+ "--with",
114
+ "postiz-agent",
115
+ "postiz-mcp"
116
+ ],
117
+ "env": {
118
+ "POSTIZ_URL": "http://your-service:8080",
119
+ "POSTIZ_TOKEN": "your_token"
120
+ }
121
+ }
122
+ }
123
+ }
124
+ ```
125
+
126
+ ## Install Python Package
127
+
128
+ ```bash
129
+ python -m pip install postiz-agent
130
+ ```
131
+ ```bash
132
+ uv pip install postiz-agent
133
+ ```
134
+
135
+ ## Repository Owners
136
+
137
+ <img width="100%" height="180em" src="https://github-readme-stats.vercel.app/api?username=Knucklessg1&show_icons=true&hide_border=true&&count_private=true&include_all_commits=true" />
138
+
139
+ ![GitHub followers](https://img.shields.io/github/followers/Knucklessg1)
140
+ ![GitHub User's stars](https://img.shields.io/github/stars/Knucklessg1)
@@ -0,0 +1,68 @@
1
+ #!/usr/bin/env python
2
+
3
+
4
+ import importlib
5
+ import inspect
6
+ import warnings
7
+ from typing import List
8
+
9
+ warnings.filterwarnings("ignore", message=".*urllib3.*or chardet.*")
10
+
11
+ __all__: List[str] = []
12
+
13
+ CORE_MODULES = [
14
+ "postiz_agent.postiz_api",
15
+ ]
16
+
17
+ OPTIONAL_MODULES = {
18
+ "postiz_agent.agent_server": "agent",
19
+ "postiz_agent.mcp_server": "mcp",
20
+ }
21
+
22
+
23
+ def _import_module_safely(module_name: str):
24
+ """Try to import a module and return it, or None if not available."""
25
+ try:
26
+ return importlib.import_module(module_name)
27
+ except ImportError:
28
+ return None
29
+
30
+
31
+ def _expose_members(module):
32
+ """Expose public classes and functions from a module into globals and __all__."""
33
+ for name, obj in inspect.getmembers(module):
34
+ if (inspect.isclass(obj) or inspect.isfunction(obj)) and not name.startswith(
35
+ "_"
36
+ ):
37
+ globals()[name] = obj
38
+ __all__.append(name)
39
+
40
+
41
+ for module_name in CORE_MODULES:
42
+ try:
43
+ module = importlib.import_module(module_name)
44
+ _expose_members(module)
45
+ except ImportError:
46
+ pass
47
+
48
+ for module_name, extra_name in OPTIONAL_MODULES.items():
49
+ module = _import_module_safely(module_name)
50
+ if module is not None:
51
+ _expose_members(module)
52
+ globals()[f"_{extra_name.upper()}_AVAILABLE"] = True
53
+ else:
54
+ globals()[f"_{extra_name.upper()}_AVAILABLE"] = False
55
+
56
+ _MCP_AVAILABLE = OPTIONAL_MODULES.get("postiz_agent.mcp_server") in [
57
+ m.__name__ for m in globals().values() if hasattr(m, "__name__")
58
+ ]
59
+ _AGENT_AVAILABLE = "postiz_agent.agent_server" in globals()
60
+
61
+ __all__.extend(["_MCP_AVAILABLE", "_AGENT_AVAILABLE"])
62
+
63
+
64
+ """
65
+ postiz-agent
66
+
67
+ Agent for interacting with Postiz Public API
68
+ """
@@ -0,0 +1,6 @@
1
+ #!/usr/bin/python
2
+
3
+ from postiz_agent.agent_server import agent_server
4
+
5
+ if __name__ == "__main__":
6
+ agent_server()
@@ -0,0 +1,8 @@
1
+ # A2A_AGENTS.md - Known A2A Peer Agents
2
+
3
+ This file is the local registry of other A2A agents this agent can discover and call.
4
+
5
+ ## Registered A2A Peers
6
+
7
+ | Name | Endpoint URL | Description | Capabilities | Auth | Notes / Last Connected |
8
+ |------|--------------|-------------|--------------|------|------------------------|
@@ -0,0 +1,12 @@
1
+ # AGENTS.md - Known A2A Peer Agents
2
+ Last updated: 2026-03-29
3
+
4
+ This file is the local registry of other A2A agents this agent can discover and call.
5
+
6
+ ## Registered A2A Peers
7
+
8
+ | Name | Endpoint URL | Description | Capabilities | Auth | Notes / Last Connected |
9
+ |-----------------|---------------------------------|--------------------------------------|----------------------------------|-----------|------------------------|
10
+ | SearchMaster | http://search-agent:9000/a2a | Advanced web researcher | web_search, summarize, browse | none | 2026-03-29 |
11
+
12
+ *Add new rows manually or let the agent call `register_a2a_peer(...)`.*
@@ -0,0 +1,12 @@
1
+ # CRON.md - Persistent Scheduled Tasks
2
+ Last updated: 2026-03-29
3
+
4
+ ## Active Tasks
5
+
6
+ | ID | Name | Interval (min) | Prompt | Last run | Next approx |
7
+ |-------------|-------------------|----------------|-------------------------------------|-------------------|-------------|
8
+ | heartbeat | Heartbeat | 30 | @HEARTBEAT.md | — | — |
9
+ | log-cleanup | Log Cleanup | 720 | __internal:cleanup_cron_log | — | — |
10
+
11
+ *Edit this table to add/remove tasks. The agent reloads it periodically.*
12
+ *Use `@filename.md` in the Prompt column to load a multi-line prompt from a workspace file.*
@@ -0,0 +1,5 @@
1
+ # CRON_LOG.md - Scheduled Task History
2
+ Last updated: 2026-03-29
3
+
4
+ | Timestamp | Task ID | Status | Message |
5
+ |-----------|---------|--------|---------|
@@ -0,0 +1,28 @@
1
+ # Heartbeat — Periodic Self-Check
2
+
3
+ You are running a scheduled heartbeat. Perform these checks and report results concisely.
4
+
5
+ ## Checks
6
+
7
+ 1. **Tool Availability** — Call `list_tools` or equivalent to verify your MCP tools are reachable. Report any connection failures.
8
+ 2. **Memory Review** — Read `MEMORY.md` and check for any pending follow-up tasks or action items. List any that are overdue.
9
+ 3. **Cron Log** — Read `CRON_LOG.md` and check for recent errors (❌). Summarize any failures from the last 24 hours.
10
+ 4. **Peer Agents** — Read `AGENTS.md` and note if any registered peers need attention.
11
+ 5. **Domain-Specific Checks**:
12
+ - **Service Health**: Check service health status and scan recent logs for critical errors using available tools.
13
+ 6. **Self-Diagnostics** — Report your current model, available tool count, and any anomalies.
14
+
15
+ ## Response Format
16
+
17
+ If everything is healthy:
18
+ ```
19
+ HEARTBEAT_OK — All systems nominal. [tool_count] tools available. No pending actions.
20
+ ```
21
+
22
+ If issues found:
23
+ ```
24
+ HEARTBEAT_ALERT — [summary of issues found]
25
+ - Issue 1: ...
26
+ - Issue 2: ...
27
+ - Action needed: ...
28
+ ```
@@ -0,0 +1,15 @@
1
+ # IDENTITY.md - Postiz Agent Agent Identity
2
+
3
+ ## [default]
4
+ * **Name:** Postiz Agent Agent
5
+ * **Role:** Agent for interacting with Postiz Public API
6
+ * **Emoji:** 🤖
7
+
8
+ ### System Prompt
9
+ You are the Postiz Agent Agent.
10
+ You must always first run `list_skills` to show all skills.
11
+ Then, use the `mcp-client` universal skill and check the reference documentation for `postiz-agent.md` to discover the exact tags and tools available for your capabilities.
12
+
13
+ ### Capabilities
14
+ - **MCP Operations**: Leverage the `mcp-client` skill to interact with the target MCP server. Refer to `postiz-agent.md` for specific tool capabilities.
15
+ - **Custom Agent**: Handle custom tasks or general tasks.
@@ -0,0 +1,13 @@
1
+ # MCP_AGENTS.md - Dynamic Agent Registry
2
+
3
+ This file tracks the generated agents from MCP servers. You can manually modify the 'Tools' list to customize agent expertise.
4
+
5
+ ## Agent Mapping Table
6
+
7
+ | Name | Description | System Prompt | Tools | Tag | Source MCP |
8
+ |------|-------------|---------------|-------|-----|------------|
9
+
10
+ ## Tool Inventory Table
11
+
12
+ | Tool Name | Description | Tag | Source |
13
+ |-----------|-------------|-----|--------|
@@ -0,0 +1,8 @@
1
+ # MEMORY.md - Long-term Memory
2
+ Last updated: 2026-03-29
3
+
4
+ This file stores important decisions, user preferences, and historical outcomes.
5
+ The agent should read this if the user asks "remember when" or similar.
6
+
7
+ ## Log of Important Events
8
+ - [2026-03-29] Workspace initialized with advanced agent features.
@@ -0,0 +1,7 @@
1
+ # USER.md - About the Human
2
+
3
+ * **Name:** User
4
+ * **Preferred name:** User
5
+ * **Timezone:** America/Chicago
6
+ * **Location:** Chicago, Illinois
7
+ * **Style:** Technical, concise, no fluff
File without changes
@@ -0,0 +1,8 @@
1
+ # A2A_AGENTS.md - Known A2A Peer Agents
2
+
3
+ This file is the local registry of other A2A agents this agent can discover and call.
4
+
5
+ ## Registered A2A Peers
6
+
7
+ | Name | Endpoint URL | Description | Capabilities | Auth | Notes / Last Connected |
8
+ |------|--------------|-------------|--------------|------|------------------------|
@@ -0,0 +1,7 @@
1
+ # CRON.md - Persistent Scheduled Tasks
2
+
3
+ ## Active Tasks
4
+
5
+ | ID | Name | Interval (min) | Prompt | Last run | Next approx |
6
+ |----|------|----------------|--------|----------|-------------|
7
+ | log-cleanup | Log Cleanup | 720 | __internal:cleanup_cron_log | — | — |
@@ -0,0 +1,4 @@
1
+ # CRON_LOG.md - Scheduled Task History
2
+
3
+ | Timestamp | Task ID | Status | Message |
4
+ |-----------|---------|--------|---------|
@@ -0,0 +1,9 @@
1
+ # Heartbeat — Periodic Self-Check
2
+
3
+ You are running a self-diagnostic heartbeat.
4
+ Please verify that:
5
+ 1. Your core skills and MCP tools are responsive.
6
+ 2. The user's recent instructions are still being followed.
7
+ 3. Your long-term memory (MEMORY.md) is updated if necessary.
8
+
9
+ No specific user input is required unless you detect an issue.
@@ -0,0 +1,15 @@
1
+ # IDENTITY.md - Who I Am, Core Personality, & Boundaries
2
+
3
+ ## [default]
4
+ * **Name:** AI Agent
5
+ * **Role:** A versatile AI agent capable of research, task delegation, and workspace management.
6
+ * **Emoji:** 🤖
7
+ * **Vibe:** Professional, efficient, helpful
8
+
9
+ ### System Prompt
10
+ You are a highly capable AI Agent.
11
+ You have access to various tools and MCP servers to assist the user.
12
+ Your responsibilities:
13
+ 1. Analyze the user's request.
14
+ 2. Use available tools and skills to gather information or perform actions.
15
+ Synthesize findings into clear, well-structured responses.
@@ -0,0 +1,25 @@
1
+ # MCP_AGENTS.md - Dynamic Agent Registry
2
+
3
+ This file tracks the generated agents from MCP servers. You can manually modify the 'Tools' list to customize agent expertise.
4
+
5
+ ## Agent Mapping Table
6
+
7
+ | Name | Description | System Prompt | Tools | Tag | Source MCP |
8
+ |------|-------------|---------------|-------|-----|------------|
9
+ | Postiz Analytics Specialist | Expert specialist for analytics domain tasks. | You are a Postiz Analytics specialist. Help users manage and interact with Analytics functionality using the available tools. | postiz_analytics_toolset | analytics | postiz |
10
+ | Postiz Integrations Specialist | Expert specialist for integrations domain tasks. | You are a Postiz Integrations specialist. Help users manage and interact with Integrations functionality using the available tools. | postiz_integrations_toolset | integrations | postiz |
11
+ | Postiz Notifications Specialist | Expert specialist for notifications domain tasks. | You are a Postiz Notifications specialist. Help users manage and interact with Notifications functionality using the available tools. | postiz_notifications_toolset | notifications | postiz |
12
+ | Postiz Posts Specialist | Expert specialist for posts domain tasks. | You are a Postiz Posts specialist. Help users manage and interact with Posts functionality using the available tools. | postiz_posts_toolset | posts | postiz |
13
+ | Postiz Uploads Specialist | Expert specialist for uploads domain tasks. | You are a Postiz Uploads specialist. Help users manage and interact with Uploads functionality using the available tools. | postiz_uploads_toolset | uploads | postiz |
14
+ | Postiz Video Specialist | Expert specialist for video domain tasks. | You are a Postiz Video specialist. Help users manage and interact with Video functionality using the available tools. | postiz_video_toolset | video | postiz |
15
+
16
+ ## Tool Inventory Table
17
+
18
+ | Tool Name | Description | Tag | Source |
19
+ |-----------|-------------|-----|--------|
20
+ | postiz_analytics_toolset | Static hint toolset for analytics based on config env. | analytics | postiz |
21
+ | postiz_integrations_toolset | Static hint toolset for integrations based on config env. | integrations | postiz |
22
+ | postiz_notifications_toolset | Static hint toolset for notifications based on config env. | notifications | postiz |
23
+ | postiz_posts_toolset | Static hint toolset for posts based on config env. | posts | postiz |
24
+ | postiz_uploads_toolset | Static hint toolset for uploads based on config env. | uploads | postiz |
25
+ | postiz_video_toolset | Static hint toolset for video based on config env. | video | postiz |
@@ -0,0 +1,6 @@
1
+ # MEMORY.md - Long-term Memory
2
+
3
+ This file stores important decisions, user preferences, and historical outcomes.
4
+
5
+ ## Log of Important Events
6
+ - [2026-04-08 15:06] Workspace initialized.
@@ -0,0 +1,13 @@
1
+ # NODE_AGENTS.md - Dynamic Agent Registry
2
+
3
+ This file tracks the generated agents from MCP servers, Universal Skills, and Skill Graphs.
4
+
5
+ ## Agent Mapping Table
6
+
7
+ | Name | Description | System Prompt | Tools | Tag / ID | Source MCP / Skill |
8
+ |------|-------------|---------------|-------|----------|--------------------|
9
+
10
+ ## Tool Inventory Table
11
+
12
+ | Tool Name | Description | Tag | Source |
13
+ |-----------|-------------|-----|--------|
@@ -0,0 +1,4 @@
1
+ # USER.md - About the Human
2
+
3
+ * **Name:** User
4
+ * **Emoji:** 👤
@@ -0,0 +1,21 @@
1
+ {
2
+ "mcpServers": {
3
+ "postiz": {
4
+ "command": "postiz-mcp",
5
+ "args": [
6
+ "--transport",
7
+ "stdio"
8
+ ],
9
+ "env": {
10
+ "POSTIZ_URL": "${POSTIZ_URL:-http://localhost:8080}",
11
+ "POSTIZ_TOKEN": "${POSTIZ_TOKEN}",
12
+ "ANALYTICSTOOL": "${ ANALYTICSTOOL:-True }",
13
+ "INTEGRATIONSTOOL": "${ INTEGRATIONSTOOL:-True }",
14
+ "NOTIFICATIONSTOOL": "${ NOTIFICATIONSTOOL:-True }",
15
+ "POSTSTOOL": "${ POSTSTOOL:-True }",
16
+ "UPLOADSTOOL": "${ UPLOADSTOOL:-True }",
17
+ "VIDEOTOOL": "${ VIDEOTOOL:-True }"
18
+ }
19
+ }
20
+ }
21
+ }