---
title: "Analytics MCP - Serpwise Documentation"
description: "Connect an MCP client to Serpwise and query rankings, Search Console trends, SEO opportunities, AI visibility, site briefs, and weekly digests."
url: "https://serpwise.ai/docs/analytics-mcp/"
source: "https://serpwise.ai/docs/analytics-mcp/"
---
[Back to Serpwise](/)

Serpwise Documentation

Connect · Configure · Execute

Search documentation

`/`

No documentation found.

↑↓ Navigate Enter to open

Browse documentation

**Analytics MCP** is a hosted [Model Context Protocol](https://modelcontextprotocol.io/) 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.