Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Setup Guide

Setting up Blotato with ChatGPT, Claude, Antigravity, or Cursor takes a few minutes.

Generate your API key: Settings > API

Tutorials

Using Claude.ai Web? Add Blotato directly here: https://claude.ai/customize/connectors?modal=add-custom-connector Paste this URL: https://mcp.blotato.com/mcp

Step-by-step video walkthrough for setting up Blotato with Claude Desktop and Cowork:

Step-by-step video walkthrough for setting up Blotato with Claude Code:

Prerequisites

  1. A paid Blotato subscription

  2. At least one connected social account in Settings

  3. For ChatGPT, Cursor, and other API-key-based clients: your Blotato API key from Settings > API

Claude.ai Web

  1. In the left sidebar, click Customize > Connectors, then click the + button > Add custom connector

  2. Name: Blotato

  3. URL: https://mcp.blotato.com/mcp

  4. Press Connect and approve access

You must be logged into your Blotato account in the same browser to complete the OAuth connection.

Claude Desktop / Claude Cowork

  1. In the left sidebar, click Customize > Connectors, then click the + button > Add custom connector

  2. Name: Blotato

  3. URL: https://mcp.blotato.com/mcp

  4. Press Connect and approve access

You must be logged into your Blotato account in your default browser to complete the OAuth connection.

On a Claude Team or Enterprise plan, only a workspace admin can add custom connectors -- if you don't see "Add custom connector," ask your Claude workspace admin to add the Blotato connector for your team.

Claude Code (Terminal)

  1. Start a Claude Code session

  2. Copy and paste the following command into your session:

  3. Let Claude apply changes

  4. Once done, run /mcp inside the session

  5. Select Blotato > Authenticate and approve access

  6. Restart Claude Code

You must be logged into your Blotato account in your default browser to complete the OAuth connection.

ChatGPT

  1. Open Settings > Plugins > MCPs.

  2. Click Add Server.

  3. Select Streamable HTTP.

  4. Set URL to https://mcp.blotato.com/mcp.

  5. Leave Bearer token env var blank.

  6. Under Headers, set the key to blotato-api-key.

  7. Paste your full API key from Blotato Settings > API into the header value. Replace the blt_ placeholder shown in the screenshot with your full key.

  8. Click Add.

Blotato MCP settings in ChatGPT

Other MCP Clients (Cursor, Antigravity, Codex, Replit Agent, etc.)

  1. Go to Settings > API in the Blotato app

  2. Under "Other MCP Clients", click Copy MCP Config

  3. Paste the JSON config into your app's MCP settings

  4. Restart your app

The config adds the Blotato MCP server with your API key:

Keep the double quotes Blotato gives you and paste the full key inside them, including any trailing = characters. The = is part of your key. Do not delete it, and do not replace the double quotes with single quotes. Single quotes apply only to shells, .env files, and scripts, not to this JSON config. A dropped or deleted trailing = causes a 401 "invalid API key" error.

Form-based setup (streamable HTTP)

Some clients, including OpenAI Codex, ask you to fill out a form instead of pasting JSON. Choose the streamable HTTP server type, then fill out the fields like this:

  1. Go to Settings > API in the Blotato app.

  2. Click Copy API Key (or click Generate API Key first if you don't have one yet).

  3. Set URL to https://mcp.blotato.com/mcp.

  4. Leave Bearer token env var blank.

  5. Under Headers, set the key to blotato-api-key and paste your API key into the Value field.

  6. Click Save.

Paste the full key into the Value field, including any trailing = characters. A dropped = causes a 401 "invalid API key" error.

Verify Your Connection

After setup, test the connection by asking your AI tool:

"What social media accounts do I have connected?"

The tool calls blotato_list_accounts and returns your connected platforms. If you see your accounts listed, the setup is complete.

Upload your own local images or videos via MCP

The Blotato MCP tools (blotato_create_post, blotato_create_visual) do not accept local file paths. Media must be a publicly accessible URL. Allowlisting egress to database.blotato.io is necessary but not enough on its own. You still upload the file first.

To use a local file:

  1. Call blotato_create_presigned_upload_url with your filename (include the extension). It returns a presignedUrl and a publicUrl.

  2. Upload the raw file bytes to presignedUrl with an HTTP PUT (for example curl -X PUT "<presignedUrl>" --data-binary "@<local_file>"). Send raw bytes, not JSON and not multipart form data.

  3. Pass the returned publicUrl in the mediaUrls field of blotato_create_post.

Do not pass the local file directly to blotato_create_post. If you allowlisted database.blotato.io but the upload still fails, the file was likely sent directly instead of being PUT to the presigned URL, or the PUT used the wrong body encoding.

Troubleshooting

If the MCP server connects but does not work as expected:

  1. OAuth clients (Claude.ai, Desktop, Cowork, Claude Code): Make sure you are logged into your Blotato account in the browser. The OAuth approval requires an active Blotato session.

  2. API key clients (ChatGPT, Cursor, etc.): Double check you copy/pasted the correct API key from Settings > API. Make sure there are no extra spaces or missing characters. If your key ends with one or more = characters, copy the full key including the trailing =, since dropping it causes a 401 "invalid API key" error.

  3. Restart your AI tool after adding the MCP server. MCP servers load on startup.

    • "Auth unsupported" or OAuth errors in API-key clients (Codex, Cursor, etc.): This means the client cannot complete the OAuth browser flow. Do not use the https://mcp.blotato.com/mcp OAuth URL on its own. Use the API-key JSON config from the "Other MCP Clients" section above, which authenticates with the blotato-api-key header instead of OAuth.

  4. Tell your AI tool the connection is correct and point it to the help docs. For example: "My Blotato MCP is connected. Reference this doc for instructions: https://help.blotato.com/api/llm"

  5. If Blotato shows "Connected" in Claude Settings but Claude.ai returns an OAuth error when you ask it to list accounts or use any Blotato tool, your Blotato subscription is not active. Go to Settings > API and click "Generate API Key" to activate your paid subscription. API access requires a paid plan.

  6. Verify you have at least one social account connected in Settings.

  7. If you get a JSON parsing error in your config file, validate it at jsonlint.com. A common mistake is a missing comma between sections.

  8. Connector shows "Connected" but never authenticates (stale connector session). If the Blotato connector in Claude Cowork or Claude Desktop shows Connected but every tool call fails with a credential error, and reconnecting does not help, the client is reusing a stale cached session. A simple reconnect reuses that same cached session, so remove it fully and add it fresh:

    1. Go to Customize > Connectors and fully remove the Blotato connector

    2. Click the + button, choose Add custom connector, and approve access again

    3. To double-check the key itself, see Settings > API

  9. "Access to this website is blocked by your network egress settings" during a presigned upload. Claude Cowork and Claude Desktop block outbound network access by default, so the PUT to the presigned upload URL cannot reach database.blotato.io. To allow it:

    1. Go to Claude Cowork/Desktop > Settings > Capabilities > Allow network egress

    2. Set "Package managers only"

    3. Under Additional allowed domains, add database.blotato.io and click Add

    4. Fully quit and restart Claude Cowork/Desktop

    5. If your settings look correct but the upload stays blocked, set Allow network egress to "Allow all" instead of "Package managers only", then restart and retry

Video walkthroughs: Claude + Blotato Beginner Setup and Build Your AI Personal Assistant for Social Media Marketing

PreviousMCP Server
NextTools Reference

Last updated