Client Setup

Claude Desktop

Add the following to your Claude Desktop MCP configuration file:

{
  "mcpServers": {
    "postiz": {
      "url": "https://api.postiz.com/mcp/your-api-key"
    }
  }
}

Your API key lives in Postiz under Settings → Developers → Public API. Click the reveal icon to show it, then copy. You can rotate it from the same place, rotating immediately invalidates the old key, so update anything using it (scripts, n8n, MCP clients, the CLI) at the same time.

Claude Code

The fastest way is the CLI:

claude mcp add postiz --transport http --url https://api.postiz.com/mcp/your-api-key

Or add it to your Claude Code config directly:

{
  "mcpServers": {
    "postiz": {
      "url": "https://api.postiz.com/mcp/your-api-key"
    }
  }
}

The Bearer-token transport works too, pick whichever your client supports better. Both authenticate the same way:

claude mcp add postiz --transport http \
  --url https://api.postiz.com/mcp \
  --header "Authorization: Bearer your-api-key"

Cursor

In Cursor, go to Settings > MCP and add a new server:

• Name: Postiz
• Type: HTTP
• URL: https://api.postiz.com/mcp/your-api-key

Other MCP Clients

Any MCP-compatible client can connect to Postiz. Use the streamable HTTP transport:

• URL: https://api.postiz.com/mcp/your-api-key
• Transport: Streamable HTTP

Or, if your client supports Bearer token authentication:

• URL: https://api.postiz.com/mcp
• Transport: Streamable HTTP
• Authorization: Bearer your-api-key

Base URL

Every URL on this page assumes Postiz Cloud. On a self-hosted instance, swap the host:

So the endpoint becomes https://your-postiz-server.com/mcp/your-api-key.

Verify Connection

Once connected, ask your AI agent:

"List my connected social media accounts"

If the connection is working, the agent will call the integrationList tool and return your connected accounts.