dsh-postiz
npm: dsh-postiz ·
source: gitroomhq/postiz-agent
DeepSeek Harness (dsh) plugin for
Postiz, the open-source social media scheduler. It connects the agent
to the Postiz MCP server so it can list your connected channels, fetch each platform's
posting rules, and schedule, draft, or publish posts across 28+ platforms (X, LinkedIn,
Instagram, Facebook, Threads, TikTok, YouTube, Reddit, Pinterest, Bluesky, Mastodon,
Discord, Slack, Telegram, and more).
Install
From the repository:
dsh plugin --profile web add "github:gitroomhq/postiz-agent#path:/plugins/dsh-postiz"
Or from npm:
dsh plugin --profile web add dsh-postiz
Then give it a Postiz API key. Copy it from Postiz → Settings → Developers → Public API
and export it before starting dsh, or put it in $DSH_HOME/.env:
export POSTIZ_API_KEY=your-api-key
dsh web
Restart the profile after installing. Ask the agent "List my connected social media
accounts" to verify the connection.
What you get
The bundle mounts two rows:
| Row | Package | Role |
|---|
postiz | dsh-postiz (this package) | Reads the API key, exposes ctx.postiz (url, headers), and registers the postiz skill that teaches the agent the posting workflow and the HTML content rules. |
postiz-mcp | @deepseek-ai/dsh-mcp-client (shipped with dsh) | Connects to https://mcp.postiz.com/mcp over streamable HTTP with a Bearer header and registers the server's tools. |
The model sees the Postiz MCP tools under the mcp__postiz__ namespace:
| Tool | What it does |
|---|
mcp__postiz__integrationList | List connected channels (optionally filtered by group) |
mcp__postiz__groupList | List customer groups |
mcp__postiz__integrationSchema | Posting rules, character limits, and required settings for a platform |
mcp__postiz__triggerTool | Platform helpers (list Discord channels, search subreddits, list LinkedIn pages) |
mcp__postiz__schedulePostTool | Schedule, draft, or immediately publish posts |
mcp__postiz__postsListTool | List posts scheduled between two dates |
mcp__postiz__postSettingsTool | Update settings of an unpublished post |
mcp__postiz__generateImageTool | Generate an image for a post |
mcp__postiz__generateVideoOptions / videoFunctionTool / generateVideoTool | Video generation options and generation |
The tool list comes from the server at connect time, so new Postiz tools appear without a
plugin update. See the Postiz MCP tools reference.
Configuration
Override the postiz row in your profile's cordis.patch.yml ($DSH_HOME/profiles/web/cordis.patch.yml).
A bare id: configures the existing row:
- id: postiz
config:
apiKeyEnv: POSTIZ_API_KEY # env var that holds the key (default)
baseUrl: https://mcp.postiz.com # self-hosted: https://your-postiz-server.com
skill: true # register the `postiz` workflow skill
| Field | Default | Description |
|---|
apiKeyEnv | POSTIZ_API_KEY | Environment variable read at boot for the API key. |
apiKey | '' | Inline key. Prefer the env var; this exists for patch-level overrides. |
baseUrl | https://mcp.postiz.com | Postiz host. The MCP endpoint is <baseUrl>/mcp. Self-hosted instances point this at their backend. |
skill | true | Register the postiz skill on ctx.skills. |
Without a key the postiz row logs a warning naming the variable to set, and the
postiz-mcp row registers no tools. dsh keeps booting.
Self-hosted Postiz
The MCP server is part of the Postiz backend and listens at /mcp (Bearer auth). Point
baseUrl at your backend and make sure your reverse proxy forwards /mcp with streaming
HTTP enabled. See Reverse Proxies.
Development
cd plugins/dsh-postiz
pnpm install
pnpm test
Link a local checkout into a profile:
dsh plugin --profile web add /absolute/path/to/postiz-agent/plugins/dsh-postiz
Related
License
AGPL-3.0, same as the rest of this repository.
