Skip to content

A Search Console MCP server for your AI assistant

Ask Claude, ChatGPT, Cursor or VS Code about your Google Search Console data in plain words. Serpwright's MCP server gives them your top queries and pages, the searches close to page one, low click rates and pages that compete with each other. It only reads.

Start free trial

No card. The server comes with every plan.

What you can ask

  • Which of my pages rank between 4 and 20 but get fewer clicks than they should?
  • Do any of my pages compete for the same search? Which one should I keep?
  • How did clicks and impressions change over the last 90 days?
  • Read my article on cold brew and suggest a better title from the queries it shows up for.

The tools it gives your assistant

Nine read-only tools. Your assistant picks the ones it needs for your question.

get_site
Your site, its articles by status, and how fresh the Search Console data is.
search_console_overview
Clicks, impressions, CTR and average position, as totals and one row per day.
top_queries
The searches your site shows up for, for the whole site or for one page.
top_pages
Your pages with impressions, and how many searches each one shows up for.
find_opportunities
Page and search pairs at positions 4 to 20, with the CTR you could expect there and a flag when yours is far below it.
find_cannibalization
Searches split between two or more of your pages, and the page pairs that split the most.
list_articles
Articles Serpwright wrote for your site, by status.
get_article
One article with its keywords, SEO title, meta description and full text.
list_suggestions
Refresh suggestions Serpwright made from your Search Console numbers.

Set it up in three steps

  1. Connect Search Console in Serpwright

    Start a free trial, add your site and connect Google Search Console. Serpwright syncs your queries and pages and keeps them up to date every week.

  2. Add the server to your AI assistant

    In claude.ai or ChatGPT, add a custom connector with the server URL and sign in to Serpwright when it asks. In Claude Code, Cursor or VS Code, paste the URL with an API key (examples below).

  3. Pick the site and ask

    Choose which of your sites the assistant may read. Then ask your question in plain words. Each connection sees one site and can be revoked in Settings, API keys.

claude.ai and ChatGPT

Add a custom connector and paste the server URL. No key to copy: you sign in to Serpwright, choose the site and allow read-only access.

https://serpwright.com/api/mcp

Claude Code

With an API key from your site's Settings, API keys (shown once, one site per key).

claude mcp add --transport http serpwright https://serpwright.com/api/mcp \
  --header "Authorization: Bearer swk_your_key"

Cursor

In ~/.cursor/mcp.json. VS Code takes the same URL and header in .vscode/mcp.json.

{
  "mcpServers": {
    "serpwright": {
      "url": "https://serpwright.com/api/mcp",
      "headers": { "Authorization": "Bearer swk_your_key" }
    }
  }
}

The server speaks the Model Context Protocol over Streamable HTTP. The full reference is under Settings, API keys in the app.

Questions

Does it change anything on my site or in Search Console?
No. Every tool only reads. The server can't publish, edit, delete or start a job, and it doesn't use your article allowance.
Why not connect Search Console to my assistant directly?
You can, but then you set up a Google Cloud project, OAuth and a local server yourself. Here Search Console is already connected once in Serpwright, and the server adds checks the raw data doesn't have: expected CTR by position and pages competing for the same search.
Are the numbers the same as in Search Console?
Close, but lower. Serpwright stores the query and page rows Google returns, and Google leaves out anonymized queries from those rows, so totals are lower than the Search Console report. Serpwright syncs once a week, so the newest day can be about 10 days old.
Does it work with ChatGPT or claude.ai?
Yes. Add it as a custom connector with the server URL. The connector sends you to Serpwright to sign in and pick one site, then gets its own read-only key. Custom connectors need a plan that allows them in claude.ai or ChatGPT. Claude Code, Cursor and VS Code can also use an API key in a header.

Ask your assistant about your own searches