Spy-Rival / docs / mcp

MCP for AI assistants

Ask Claude, ChatGPT, or Cursor questions about your tracked competitors — ads, angles, alerts, and strategy overviews — without leaving the chat.

A. Claude.ai and ChatGPT (OAuth)

Add a custom connector with this URL — OAuth is automatic, no API key needed:

https://spy-rival.com/api/mcp/mcp

B. Claude Code and Cursor (API key)

Log in → Settings MCP / AI assistants → Generate API key. Copy it immediately — we only show it once.

Claude Code

claude mcp add rival --transport http https://spy-rival.com/api/mcp/mcp --header "Authorization: Bearer YOUR_KEY"

Cursor

Add to Settings → MCP (mcp.json):

{
  "mcpServers": {
    "rival": {
      "url": "https://spy-rival.com/api/mcp/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      }
    }
  }
}

What can I ask?

read-only and private — Spy-Rival only ever reads your own competitor data. Nothing in MCP can change your account, trigger scrapes, or access another user's data.

Rate limit: 60 calls/min and 1000/day per API key or OAuth connection.