# Google Search Console MCP server

BasecampSEO is a Google Search Console analytics product. It stores search
performance beyond Google's 16 month retention window, and adds movers, brand
and non brand segmentation, page groups, annotations and indexing coverage on
top of the raw Search Console data.

The API and MCP server give you all of that outside the dashboard. Read-only,
available on paid Pro and Agency plans.

Server URL: `https://api.basecampseo.com/mcp`
Transport: Streamable HTTP. Auth: `Authorization: Bearer bcs_live_...`.

## Connect

ChatGPT. Settings, Connectors, Create. Paste the server URL, set a custom header
named Authorization with the value `Bearer <key>`. Needs a paid ChatGPT plan,
and on some plans developer mode under Settings, Connectors, Advanced.

Claude.ai. Settings, Connectors, Add custom connector. Paste the server URL and
add the Authorization header under advanced settings. Custom headers are still
beta in the browser app.

Claude Code. `claude mcp add --transport http basecampseo https://api.basecampseo.com/mcp --header "Authorization: Bearer <key>"`

Cursor. Add to `~/.cursor/mcp.json`: `{"mcpServers":{"basecampseo":{"url":"https://api.basecampseo.com/mcp","headers":{"Authorization":"Bearer <key>"}}}}`

Gemini CLI. Add to `~/.gemini/settings.json`: `{"mcpServers":{"basecampseo":{"httpUrl":"https://api.basecampseo.com/mcp","headers":{"Authorization":"Bearer <key>"}}}}`

## Tools

| Tool | Purpose |
| --- | --- |
| list_properties | Every site on the account with its canonical property string |
| get_property | Data window for one site, and whether Google is still connected |
| get_performance | Totals and daily trend, previous period compared automatically |
| get_search_breakdown | Top queries, pages, countries or devices |
| get_movers | Biggest gainers and losers against the previous period |
| get_indexing_summary | Indexed versus not indexed, by Google coverage state |
| list_indexed_urls | Individual URLs by index status, filterable and paged |
| get_segments | Brand terms, page groups and dated annotations |

Every tool takes a site as a bare domain ("example.com"), a full Search Console
property ("sc-domain:example.com"), or the property id. A domain connected twice
returns an error listing both ids rather than guessing.

## Accuracy rules

1. Search Console lags about two days. Zeros on the newest days mean "not
   published yet", not "traffic stopped".
2. The last 16 months come live from Google and are complete.
3. Older data comes from the BasecampSEO archive, which keeps the top 100
   queries and top 100 pages per day. Archive clicks are close to reality.
   Archive impressions under report the long tail.
4. A disconnected Google account makes responses fall back to the archive, and
   they say so. Do not present those figures as current.
5. get_movers cannot be filtered. To compare a segment, call
   get_search_breakdown twice with explicit dates.

## Limits

One daily allowance shared by every key on the account, resetting at midnight
UTC. Pro gets 1,000 requests a day, Agency 5,000. Repeat calls are served from
cache. A burst cap and a per property cap on live Search Console lookups sit
underneath as guard rails, and only fire if something is looping.