How It Works
Postiz exposes an MCP server that provides 8 tools to AI agents. The agent discovers these tools, understands their schemas, and calls them on your behalf.Available Tools
| Tool | Description |
|---|---|
integrationList | List all connected social media accounts |
integrationSchema | Get platform-specific posting rules and settings schema |
triggerTool | Execute platform-specific helpers (e.g., list Discord channels) |
schedulePostTool | Schedule, draft, or immediately publish posts |
generateImageTool | Generate AI images for posts |
generateVideoOptions | List available video generation options |
videoFunctionTool | Get video generator settings (e.g., available voices) |
generateVideoTool | Generate videos for posts |
Authentication
There are two ways to authenticate with the MCP server:API Key
Get your API key from Settings > Developers > Public API in Postiz. Use it directly in the MCP endpoint URL or as a Bearer token.OAuth Token
If you’re building an app for other Postiz users, use OAuth2 to obtain tokens. OAuth tokens start withpos_ and work the same way as API keys.
Connecting
- Bearer Token
- API Key in URL
Use the This method supports both API keys and OAuth tokens (prefixed with
/mcp endpoint with your API key or OAuth token as a Bearer token:pos_).For self-hosted instances, replace
https://api.postiz.com with your NEXT_PUBLIC_BACKEND_URL.Quick Example
Here’s what a typical interaction looks like when an AI agent uses Postiz MCP:- Agent calls
integrationList— gets back your connected accounts (X, LinkedIn, etc.) - Agent calls
integrationSchemawithplatform: "x"— learns X’s character limits, settings, and rules - Agent calls
schedulePostTool— schedules your post with the correct format
“Schedule a post to X for tomorrow at 10am: Excited to announce our new feature!”