Analytics MCP

Analytics MCP is a hosted Model Context Protocol endpoint at https://cloud.serpwise.ai/api/mcp. Point your AI assistant at it with an organization API key and it can query your own Serpwise data — read-only, scoped to your organization.

What your assistant can query

Tool area	What it returns
Domains	The domains in your organization and their status
SEO opportunities	AI-detected opportunities: striking-distance keywords, lost positions, keyword cannibalization, rankings without conversions, and more
Search Console summaries	Top pages, top queries, and weekly movers from your connected Search Console data
AI visibility runs	Brand mentions, position, sentiment, and competitor appearances across answer engines
Site Brief	The per-domain brief Serpwise maintains for your site
Weekly digest	Movers, new opportunities, and the top recommended fix

Setup

1. Create an API key

   In the Serpwise dashboard, go to your organization’s API keys and create a key with the mcp:read scope. That is the only permission the connection ever gets — Analytics MCP has no write access.

2. Add the MCP server

   Claude Code Claude Desktop Cursor

   claude mcp add --transport http serpwise https://cloud.serpwise.ai/api/mcp \
     --header "Authorization: Bearer YOUR_API_KEY"

   Add the server under Settings → Connectors with the URL https://cloud.serpwise.ai/api/mcp and your API key as a bearer token.

   {
     "mcpServers": {
       "serpwise": {
         "url": "https://cloud.serpwise.ai/api/mcp",
         "headers": {
           "Authorization": "Bearer YOUR_API_KEY"
         }
       }
     }
   }

3. Ask a question

   The Serpwise tools appear in your assistant automatically. Try:

   • “Which keywords are in striking distance on example.com?”
   • “Summarize last week’s Search Console movers.”
   • “How is our brand mentioned across AI answers this month?”
   • “What’s the top fix in this week’s digest?”

Security model

• Read-only. The endpoint only accepts keys with the mcp:read scope. No tool can write, deploy, or change configuration.
• Org-scoped. Every request is bound to the organization that owns the API key. You only ever see your own workspace.
• Revocable. Rotate or delete the key in the dashboard and access ends immediately.