Developers

Postmixr MCP

Connect Claude, Cursor, or VS Code to Postmixr with the Model Context Protocol. Every tool calls the same /api/v1 REST API your integrations use — one API key, one rate limit, one source of truth.

Prerequisites

A Starter or Pro workspace (MCP uses the public API plan gate).
An API key from Settings → API keys. Keys start with pmx_.
At least one connected social account in Postmixr before scheduling posts.

Endpoint & authentication

URL	https://api.postmixr.com/api/mcp/mcp
Transport	Streamable HTTP (MCP spec)
Auth	`Authorization: Bearer pmx_…` or `X-Api-Key: pmx_…`

REST reference: https://api.postmixr.com/api/docs

Claude Code

Add to ~/.claude/settings.json (or project .claude/settings.json):

{
  "mcpServers": {
    "postmixr": {
      "type": "http",
      "url": "https://api.postmixr.com/api/mcp/mcp",
      "headers": {
        "Authorization": "Bearer pmx_your_api_key_here"
      }
    }
  }
}

Claude Desktop

Claude Desktop does not support remote HTTP MCP natively. Use mcp-remote as a bridge in ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "postmixr": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.postmixr.com/api/mcp/mcp",
        "--header",
        "Authorization: Bearer pmx_your_api_key_here"
      ]
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project (or global MCP settings):

{
  "mcpServers": {
    "postmixr": {
      "url": "https://api.postmixr.com/api/mcp/mcp",
      "headers": {
        "Authorization": "Bearer pmx_your_api_key_here"
      }
    }
  }
}

VS Code (GitHub Copilot)

Add to your VS Code MCP configuration:

{
  "servers": {
    "postmixr": {
      "type": "http",
      "url": "https://api.postmixr.com/api/mcp/mcp",
      "headers": {
        "Authorization": "Bearer pmx_your_api_key_here"
      }
    }
  }
}

Tools

Each tool maps to a /api/v1 route. Arguments match the REST request body or query parameters.

Tool	Description
list_accounts	List connected social accounts
get_account	Get one account by id
list_posts	List posts (optional status/platform filters)
list_scheduled_posts	List scheduled posts
get_post	Get a post by id
create_post	Create draft, scheduled, or publish-now post
update_post	Update draft or scheduled post
delete_post	Delete draft or scheduled post
publish_post	Publish a post immediately
upload_media	Get presigned upload URL for media
get_post_analytics	Per-target analytics for a published post
list_post_analytics	Analytics for recent published posts
list_platforms	Supported platforms and capabilities
verify_api_key	Verify API key and workspace

Good to know

Drafts vs native drafts: Postmixr drafts live in your workspace until you schedule or publish — they are not Instagram or TikTok native drafts.
Media uploads: Call upload_media, PUT your file to uploadUrl, then pass publicUrl in create_post as mediaUrls.
Analytics: Metrics are per platform target (canonical fields). There is no single combined rollup yet — sum in your agent or use list_post_analytics for a table view.
Rate limits: 60 requests per minute per API key (shared between REST and MCP).

Ready to connect?

Create an API key, paste it into your MCP config, then ask your assistant to verify_api_key and list_accounts.

Get API key REST API docs