Setup Guide

Setting up Blotato with 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:

• Claude Cowork and Desktop + Blotato MCP

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

• Claude Code + Blotato MCP

• The ULTIMATE Claude Code Tutorial (brand voice, quality gates, subagents)

Prerequisites

1. A paid Blotato subscription

2. At least one connected social account in Settings

3. For 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.

---

Claude Code (Terminal)

1. Start a Claude Code session

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

   claude mcp add \
     --transport http \
     Blotato https://mcp.blotato.com/mcp

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.

---

Other MCP Clients (Cursor, Antigravity, 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:

{
  "mcpServers": {
    "blotato": {
      "url": "https://mcp.blotato.com/mcp",
      "headers": {
        "blotato-api-key": "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.

---

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.

---

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 (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.

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.

Video walkthrough: Build Your AI Personal Assistant for Social Media Marketing