MCP Server

Search Console server

Google Search Console over MCP: property management, search-analytics reporting, URL inspection, and sitemaps.

Google Search Console over MCP: properties, search-analytics reports, URL inspection, and sitemaps.

How it helps

Ask which pages are losing search traffic. Call gsc_compare_periods across two date ranges to surface the movers, then gsc_inspect_url on a page that dropped to check whether Google still has it indexed and why.

Connect

Point your MCP client at the search console route:

You need an API key to connect

Every request must carry an X-API-Key header. Sign in to create one.

Search Console

https://go-mcp-server-latest.onrender.com/gsc/mcp

Drop this into your client’s config and swap in the key you mint on the Keys page:

mcp.json

{
  "mcpServers": {
    "gsc": {
      "type": "http",
      "url": "https://go-mcp-server-latest.onrender.com/gsc/mcp",
      "headers": {
        "X-API-Key": "<your-api-key>"
      }
    }
  }
}

What you provide

Every request carries your X-API-Key header — mint one on the Keys page. That single key admits the whole server.

This namespace also runs against your own your own Google Search Console credentials — a service-account JSON (or OAuth via Application Default Credentials) for the Google account whose properties you want to read, connected to your account.

Good to know

Mounts even without credentials: every tool reports the config problem instead of failing the server. Call gsc_capabilities first to check auth status. Mutating tools (add/delete site, submit/delete sitemap) require GSC_ALLOW_DESTRUCTIVE=true.

Tools

gsc_capabilitiestool

Report this server's configuration and readiness: whether credentials resolved, the auth source, the default data-state, whether mutations are enabled, and the tool catalogue. Call this first if other tools error.

gsc_list_propertiestool

List every Search Console property the authenticated principal can access, with permission level.

gsc_get_site_detailstool

Get details (permission level) for a single property identified by site_url.

site_urlrequired: stringThe Search Console property.

gsc_add_sitetool

Add a property to the account (Sites.add). Mutating; requires GSC_ALLOW_DESTRUCTIVE=true.

site_urlrequired: stringThe property to add.

gsc_delete_sitetool

Remove a property from the account (Sites.delete). Mutating; requires GSC_ALLOW_DESTRUCTIVE=true.

site_urlrequired: stringThe property to remove.

gsc_search_analyticstool

Search-traffic report for a property over the last N days: top rows by dimension.

site_urlrequired: stringThe Search Console property.
days: int · default 28Look-back window in days ending today.
dimensions: string · default queryComma-separated: query, page, country, device, date, searchAppearance.
row_limit: int · default 20Max rows to return.

gsc_advanced_search_analyticstool

Full-featured Search Analytics query: explicit dates, dimensions, filters, sorting, pagination, and data-state.

site_urlrequired: stringThe Search Console property.
start_date: stringYYYY-MM-DD; defaults to 28 days before end_date.
end_date: stringYYYY-MM-DD; defaults to today.
search_type: string · default WEBWEB, IMAGE, VIDEO, NEWS, DISCOVER or GOOGLE_NEWS.
row_limit: int · default 1000Max rows, up to 25000.
data_state: string · default ALLALL (fresh data) or FINAL (finalized only).

gsc_performance_overviewtool

High-level performance summary for a property over the last N days: total clicks, impressions, CTR, position.

site_urlrequired: stringThe Search Console property.
days: int · default 28Look-back window in days.

gsc_compare_periodstool

Compare Search Analytics between two explicit date ranges (period1 vs period2), grouped by dimension.

site_urlrequired: stringThe Search Console property.
period1_startrequired: stringYYYY-MM-DD start of the baseline period.
period1_endrequired: stringYYYY-MM-DD end of the baseline period.
period2_startrequired: stringYYYY-MM-DD start of the comparison period.
period2_endrequired: stringYYYY-MM-DD end of the comparison period.
limit: int · default 10Max keys to compare (ranked by period-2 clicks).

gsc_search_by_page_querytool

For a single page URL, the search queries that drove impressions/clicks to it over the last N days.

site_urlrequired: stringThe Search Console property.
page_urlrequired: stringThe exact page URL to break down by query.
days: int · default 28Look-back window in days.
row_limit: int · default 20Max queries to return.

gsc_inspect_urltool

Inspect a single URL's Google index status (URL Inspection API): verdict, coverage state, and more.

site_urlrequired: stringThe property that owns the URL.
page_urlrequired: stringThe fully-qualified URL to inspect.

gsc_batch_inspect_urlstool

Inspect up to 10 URLs concurrently and return each one's index status.

site_urlrequired: stringThe Search Console property.
urlsrequired: stringURLs to inspect, one per line or comma-separated (max 10).

gsc_check_indexing_issuestool

Inspect up to 10 URLs and summarize indexing problems: which are indexed vs not, and why.

site_urlrequired: stringThe Search Console property.
urlsrequired: stringURLs to inspect (max 10).

gsc_list_sitemapstool

List sitemaps for a property with status detail: submitted/downloaded dates, type, pending status.

site_urlrequired: stringThe Search Console property.
sitemap_index: stringOptional sitemap-index URL to list child sitemaps of.

gsc_get_sitemaptool

Get full detail for a single sitemap by its feedpath URL, including content breakdown.

site_urlrequired: stringThe Search Console property.
sitemap_urlrequired: stringThe full sitemap URL (feedpath).

gsc_submit_sitemaptool

Submit (or resubmit) a sitemap to Search Console. Mutating; requires GSC_ALLOW_DESTRUCTIVE=true.

site_urlrequired: stringThe Search Console property.
sitemap_urlrequired: stringThe full sitemap URL to submit.

gsc_delete_sitemaptool

Delete/unsubmit a sitemap from Search Console. Mutating; requires GSC_ALLOW_DESTRUCTIVE=true.

site_urlrequired: stringThe Search Console property.
sitemap_urlrequired: stringThe full sitemap URL to delete.