Your AI CMO, in your own tools

Claude Desktopclaude_desktop_config.json

Settings → Developer → Edit Config, paste this, then restart Claude Desktop. Needs Node.js. mcp-remote bridges Claude Desktop to Cosmo's remote server; the header is passed through an env var because Claude Desktop on Windows mangles spaces in args.

{
  "mcpServers": {
    "cosmo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://cosmocmo.com/mcp",
        "--header",
        "Authorization:${COSMO_AUTH}"
      ],
      "env": {
        "COSMO_AUTH": "Bearer cosmo_live_YOUR_KEY"
      }
    }
  }
}

Claude.ai connector

Claude.ai and Claude Desktop custom connectors (Settings → Connectors → Add custom connector) sign in with OAuth, which Cosmo doesn't offer yet. Request-header auth is in beta for some organizations: if you see a Request headers section, add the header below. Otherwise use the Claude Desktop config above.

Server URL:  https://cosmocmo.com/mcp
Header:      Authorization
Value:       Bearer cosmo_live_YOUR_KEY

Claude Code

claude mcp add --transport http cosmo https://cosmocmo.com/mcp \
  --header "Authorization: Bearer cosmo_live_YOUR_KEY"

ChatGPT

ChatGPT developer mode (Settings → Apps & Connectors → Advanced → Developer mode, then Create) connects remote MCP servers. Its dialog offers OAuth or no auth, and in some releases an API key / bearer option. If you see one, paste the key there. OAuth for Cosmo is coming; until then, Zapier or n8n with the REST API works everywhere.

MCP server URL:  https://cosmocmo.com/mcp
Authentication:  API key / Bearer (if offered)
Key:             cosmo_live_YOUR_KEY

Cursor.cursor/mcp.json

Put this in .cursor/mcp.json in your project (or ~/.cursor/mcp.json for every project).

{
  "mcpServers": {
    "cosmo": {
      "url": "https://cosmocmo.com/mcp",
      "headers": {
        "Authorization": "Bearer cosmo_live_YOUR_KEY"
      }
    }
  }
}

curl

Write tools only queue a card. Approving needs a key with the approve scope.

# Status, plan and waiting cards
curl https://cosmocmo.com/api/v1/me -H "Authorization: Bearer cosmo_live_YOUR_KEY"

# Cards waiting for a yes
curl "https://cosmocmo.com/api/v1/approvals?status=pending" -H "Authorization: Bearer cosmo_live_YOUR_KEY"

# Run a read tool
curl -X POST https://cosmocmo.com/api/v1/tools/connection_status -H "Authorization: Bearer cosmo_live_YOUR_KEY" \
  -H "content-type: application/json" -d '{"input": {}}'

# Talk to Cosmo (write scope)
curl -X POST https://cosmocmo.com/api/v1/chat -H "Authorization: Bearer cosmo_live_YOUR_KEY" \
  -H "content-type: application/json" -d '{"message": "What should we post this week?"}'

# Approve a card (approve scope: it goes out)
curl -X POST https://cosmocmo.com/api/v1/approvals/CARD_ID/approve -H "Authorization: Bearer cosmo_live_YOUR_KEY"

Zapier / n8n

Use an HTTP request step (Zapier Webhooks, n8n HTTP Request) with the header below, or n8n's MCP Client Tool node pointed at the MCP URL with header auth.

URL:     https://cosmocmo.com/api/v1/chat   (or any endpoint in the OpenAPI spec)
Method:  POST
Headers: Authorization: Bearer cosmo_live_YOUR_KEY
         Content-Type: application/json
Body:    {"message": "Draft 3 LinkedIn posts about our launch"}

MCP URL: https://cosmocmo.com/mcp