MCP

Connect Cursor, Claude, and other MCP clients to Sellm async analysis.

The Sellm MCP server exposes the async analysis API as a small set of tools. Agents can submit a brand-visibility job, poll until it finishes, and read compact share-of-voice results without calling the REST API directly.

The endpoint is a remote Streamable HTTP server:

https://sellm.io/mcp

It uses the same API keys and rate limits as /api/v1/async-analysis. Webhooks are not available over MCP; poll get_analysis instead.

Authentication

Send a Sellm API key as a Bearer token on every MCP request:

Authorization: Bearer sellm_your_api_key_here

Project API keys analyze the project's configured brand. Do not pass brandName.
Organization API keys require brandName per job and spend prepaid API credits.

Create keys from Project Settings or Organization API Integrations. See Authentication.

Cursor

Add this to .cursor/mcp.json or ~/.cursor/mcp.json:

{
  "mcpServers": {
    "sellm": {
      "url": "https://sellm.io/mcp",
      "headers": {
        "Authorization": "Bearer sellm_your_api_key_here"
      }
    }
  }
}

Store the key in an environment variable when you can:

{
  "mcpServers": {
    "sellm": {
      "url": "https://sellm.io/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SELLM_API_KEY}"
      }
    }
  }
}

Restart Cursor or toggle the server under Customize. The tools submit_analysis, get_analysis, and list_providers should appear.

Other MCP clients

Any client that supports remote Streamable HTTP can use the same URL and Authorization header. Claude Desktop, VS Code Copilot, and similar hosts typically accept:

{
  "mcpServers": {
    "sellm": {
      "url": "https://sellm.io/mcp",
      "headers": {
        "Authorization": "Bearer sellm_your_api_key_here"
      }
    }
  }
}

Tools

submit_analysis queues a job and returns analysisId immediately. Credits reserved equal prompts × providers × locations × replicates.

get_analysis returns running until the job finishes, then compact metrics: share of voice, coverage, average position, competitors, and per-provider breakdown. Raw provider transcripts are omitted.

list_providers lists the provider IDs accepted by submit_analysis: chatgpt, perplexity, gemini, grok, google_aio, google_ai_mode, and copilot. Locations are ISO 3166-1 alpha-2 codes such as US or DE.

Typical jobs finish in 1-2 minutes. Poll get_analysis every 5-10 seconds. Do not submit a second job while waiting.

Registry listing

The server metadata lives in server.json as com.sellm/mcp. Publishing that record to the official MCP Registry is a separate step after DNS namespace verification for sellm.io. Until then, clients can still add https://sellm.io/mcp by URL.