API and MCP: connect Posto to other apps

With the API and MCP you can create carousels from n8n, Zapier, your agency systems, or AI assistants such as Claude and Cursor, without opening Posto.

Who can use it?

• The Agency plan, or the Starter, Pro, and Ultimate plans with the API & MCP add-on. See How to upgrade your plan.
• Only the workspace owner or an admin can manage API keys, and their email must be verified.
• This feature is opening gradually. If the page shows API & MCP is coming soon, your account isn't included yet.

Create an API key

1. Open Brand & social accounts → API & MCP (/app/settings/api) and click Create API key.
2. Enter a Key name (e.g. "n8n production") and pick only the Permissions you need: Read (view carousels, schedules, AI credit balance), Create content (uses AI credits), and Schedule (scheduled posts and webhooks).
3. Click Create key, then Copy key and store it somewhere safe. The key is shown only once; after I've saved it you can't see it again.

Key leaked or no longer used? Click Revoke: programs using it lose access immediately. You can have up to 20 active keys per workspace. Every call is listed in Call history (request contents are never stored).

Calling the API

Base URL: https://posto.id/api/v1. Send the key in the Authorization: Bearer <key> header. The Idempotency-Key header is required for POST /carousels, POST /carousels/{id}/images, and POST /batches: a request repeated with the same key never creates content or charges AI credits twice.

curl -X POST https://posto.id/api/v1/carousels \
  -H "Authorization: Bearer pk_live_xxx" \
  -H "Idempotency-Key: blog-1203" \
  -H "Content-Type: application/json" \
  -d '{"source":{"type":"link","value":"https://contoh.id/blog/1203"},"slides":5,"ratio":"4:5","lang":"id","images":true}'

The 202 response contains the carousel id with status queued. Poll GET /api/v1/carousels/{id} until it is ready, or add a webhook for carousel.ready.

• Limits per key: 60 requests per minute and 10 simultaneous generations. Over the limit → 429 with a Retry-After header.
• AI credits work the same as in the app: Posto sets the rate per AI action (by default 1 AI credit per slide, AI images Standard 10, High 30), charged before the AI runs and refunded if it fails. Posting, scheduling, and exports use no AI credits. See How AI credits work.
• Every endpoint, with cURL, Node and n8n examples, is in the API documentation.
• Reels videos and recurring schedules also work through the API and MCP. See Reels and recurring schedules via API & MCP.

Connect an AI assistant (MCP)

The Posto MCP server is at https://posto.id/mcp and uses the same API key.

1. In Brand & social accounts → API & MCP, under Connect an AI assistant (MCP), choose the Claude Desktop, Cursor, Claude Code, or Other apps tab.
2. Click Copy. If you just created a key, the configuration already contains it; otherwise replace pk_live_XXXXXXXXXXXXXXXX with your key.
3. Claude Desktop: paste into claude_desktop_config.json, then restart Claude Desktop. Cursor: paste into .cursor/mcp.json in your project folder. Claude Code: run the command in your terminal.

Configuration for Claude Desktop and Cursor:

{
  "mcpServers": {
    "posto": {
      "type": "streamable-http",
      "url": "https://posto.id/mcp",
      "headers": {
        "Authorization": "Bearer pk_live_XXXXXXXXXXXXXXXX"
      }
    }
  }
}

The Other apps tab is for apps that don't support Streamable HTTP yet (requires Node.js):

{
  "mcpServers": {
    "posto": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://posto.id/mcp",
        "--header",
        "Authorization:${POSTO_AUTH_HEADER}"
      ],
      "env": {
        "POSTO_AUTH_HEADER": "Bearer pk_live_XXXXXXXXXXXXXXXX"
      }
    }
  }
}

Rules when using MCP:

• Actions that use AI credits ask for your approval first: carousels above 5 AI credits, AI images (by default Standard 10, High 30 AI credits), and running a batch. The assistant shows the AI credit amount before continuing. AI text actions (e.g. rewriting a slide) also use AI credits.
• If you don't have enough AI credits for the slides plus AI photos, the carousel is made without AI photos (still neat), unless the assistant explicitly asks for photos; that request is declined with a not-enough-AI-credits message.
• One MCP session is currently capped at 500 AI credits per hour (set by Posto, separate from your workspace's daily limit). If you hit it, wait for the next hour.

Still stuck? Contact [email protected].