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- Claude.ai: Settings → Connectors → Add custom connector → paste the URL above → sign in and approve read-only access on the consent screen.
- ChatGPT: Settings → Connectors → Developer mode → create connector with the same URL → complete the OAuth consent flow when prompted.
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?
- What are my competitors' longest-running ads on Meta?
- What angles is Acme Corp using that I'm not?
- Any competitor moves in the last 7 days?
- Show organic posts and insights for adidas.com.
- What deals and cadence show up in their captured emails?
- Which landing pages get the most bottom-funnel ad traffic?
- What is their strategy map journey end goal — paths, deals, and creatives?
- Search my copy vault for "free trial" messaging.
- How many competitors am I tracking on my plan?
- Show the strategy overview for northwindhealth.com if it's cached.
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.