Google Search Console MCP Server

What a call looks like

These are real tool names from the live server, with the shape of what they return.

{
  "site": "sc-domain:example.com",
  "date_range": "2026-09-18 to 2026-10-15",
  "rows": [
    { "query": "garden tool rental", "clicks": 412, "impressions": 9810, "ctr": "4.20%", "position": 3.8 },
    { "query": "hedge trimmer hire", "clicks": 96,  "impressions": 7420, "ctr": "1.29%", "position": 9.6 }
  ]
}

{
  "site": "sc-domain:example.com",
  "summary": {
    "period1": { "date_range": "2026-08-21 to 2026-09-17", "total_clicks": 6120, "total_impressions": 188400 },
    "period2": { "date_range": "2026-09-18 to 2026-10-15", "total_clicks": 5240, "total_impressions": 191020 },
    "clicks_change_pct": -14.4
  },
  "period2_rows": [
    { "page": "https://example.com/hedge-trimmers/", "clicks": 310, "impressions": 22100, "ctr": "1.40%", "position": 8.9 }
  ]
}

{
  "inspectionResult": {
    "indexStatusResult": {
      "verdict": "PASS",
      "coverageState": "Submitted and indexed",
      "robotsTxtState": "ALLOWED",
      "indexingState": "INDEXING_ALLOWED",
      "lastCrawlTime": "2026-10-12T04:18:33Z"
    }
  }
}

{
  "site": "sc-domain:example.com",
  "sitemaps": [
    { "path": "https://example.com/sitemap_index.xml", "lastDownloaded": "2026-10-17T02:11:09Z",
      "isPending": false, "errors": "0", "warnings": "0" }
  ]
}

What the 22 Search Console tools are

They map onto the reports you already use in Search Console, so a prompt that names the report usually lands in one call. The full list with parameters is in the Search Console tool reference.

• Performance — gsc_search_analytics for any dimension combination, gsc_top_keywords, gsc_top_pages, gsc_page_keywords for the queries behind one page, gsc_date_trend, gsc_compare_periods, gsc_device_breakdown, gsc_country_breakdown, gsc_search_appearance and gsc_discover_performance
• Indexing — gsc_inspect_url, gsc_index_coverage, gsc_crawl_errors, gsc_video_indexing and gsc_rich_results
• Experience — gsc_core_web_vitals and gsc_mobile_usability
• Sitemaps and links — gsc_sitemaps, gsc_submit_sitemap, gsc_delete_sitemap and gsc_links
• Properties — gsc_list_sites lists every property your Google identity can see, domain and URL-prefix alike

Connect Search Console in three steps

Search Console uses the same Google sign-in as GA4 and Google Ads. Sign in with the Google identity that is an owner or user on the property; another identity will authorise and see no sites.

• Add MCP Ads to your AI client: paste https://mcp-ads.com/mcp-slim as a custom connector in Claude or ChatGPT, or add it to the MCP config in Cursor, Codex or Gemini CLI. OAuth opens in the browser; there is no API key.
• In the MCP Ads dashboard, connect Google and leave Search Console ticked on the consent screen. The token is stored encrypted on the MCP Ads side and never reaches the AI client.
• Ask a first question, such as "list my Search Console properties, then show the queries ranking between positions 8 and 20 on the main one". That is the page-two list, and usually the quickest win.

Questions it answers well

The point of a GSC MCP server is not a prettier report; it is asking the follow-up question without building a new filter. A few that work in one or two calls:

• Position drops: which pages lost clicks period over period, and whether the loss is impressions (demand or ranking) or CTR (the snippet)
• CTR gaps: queries with high impressions and a CTR well under what their position would suggest, which are title and description rewrites
• Page-two terms: queries sitting at positions 8 to 20, grouped by the page that ranks for them
• Indexing: why a URL is not in the index, according to URL inspection, and whether the sitemap that lists it was read
• Paid and organic overlap: queries you rank in the top three for and also bid on in Google Ads, from the same conversation

What it can change

Almost nothing, by design. Search Console reports on what Google sees; it does not let anyone change rankings. The only writes are gsc_submit_sitemap and gsc_delete_sitemap, and like every write in MCP Ads they wait for your approval in the AI client before they run. The fixes the data points to happen on your site — and if the site is WordPress, the same connector can make them through the WordPress MCP, with the same approval step. Search Console keeps about 16 months of performance data; that limit is Google's, and no tool can read further back.

Price and licence

MCP Ads is $49/month or $490/year after a 7-day free trial, with Search Console, GA4, Google Ads, Google Tag Manager, WordPress and the other platforms included — see pricing. It works with Claude, ChatGPT, Cursor, Codex, Gemini CLI, Grok, OpenClaw and Hermes. The server is open source under the MIT licence at github.com/RoyAzran/mcp-ads. Connection details are in the Search Console guide.