API reference: Google Search Console

All tools are read-only and are called via tools/call over POST /gsc/mcp. You need an active Google Search Console subscription, and your authorized Google account must have access to the properties you query.

Endpoint: https://mcp.consile.ai/gsc/mcp. GSC is its own named connector with only its own tools. Tool names are namespaced gsc__<tool> in Claude/ChatGPT (the bare names are used here for readability). The connector is multi-instance: an extra connected instance is served under its own id (e.g. gsc-2__<tool>).

Every upstream call has a built-in 15-second timeout; there is no other client-side rate limiting (Google’s own API quotas apply upstream). Access tokens are refreshed silently on the read path; a revoked grant surfaces as AccessTokenExpiredError (“reconnect required”, raised on a 401 from Google). See Errors & limits.

Common parameters

string

required

A Search Console property. Either a URL-prefix property (https://www.example.com/) or a domain property (sc-domain:example.com). Get valid values with list_sites.

string (YYYY-MM-DD)

Date range for the report. Must be the format YYYY-MM-DD. See data freshness.

list_sites

Lists the verified properties your account has access to. Arguments: none.

array

List of properties.

Show fields

{ "name": "gsc__list_sites", "arguments": {} }

{
  "sites": [
    { "siteUrl": "sc-domain:example.com", "permissionLevel": "siteOwner" },
    { "siteUrl": "https://shop.example.com/", "permissionLevel": "siteFullUser" }
  ]
}

top_queries

The most-clicked search queries for a property over a date range.

integer

default:"10"

Max number of rows. Integer between 1 and 25000.

array

Rows sorted by clicks. Each item has query, clicks, impressions, ctr and position.

{
  "name": "top_queries",
  "arguments": {
    "siteUrl": "sc-domain:example.com",
    "startDate": "2026-05-01",
    "endDate": "2026-05-28",
    "limit": 5
  }
}

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "queries": [
    { "query": "example keyword", "clicks": 421, "impressions": 9120, "ctr": 0.046, "position": 7.8 }
  ]
}

top_pages

The most-clicked pages for a property over a date range. Same arguments as top_queries.

array

Rows sorted by clicks. Each item has page, clicks, impressions, ctr and position.

{
  "name": "top_pages",
  "arguments": {
    "siteUrl": "sc-domain:example.com",
    "startDate": "2026-05-01",
    "endDate": "2026-05-28"
  }
}

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "pages": [
    { "page": "https://example.com/", "clicks": 980, "impressions": 21340, "ctr": 0.046, "position": 5.1 }
  ]
}

query_performance

Clicks, impressions, CTR and position for a single query.

object

clicks, impressions, ctr, position. If the query has no data in the period, zeros are returned.

{
  "name": "query_performance",
  "arguments": {
    "siteUrl": "sc-domain:example.com",
    "query": "example keyword",
    "startDate": "2026-05-01",
    "endDate": "2026-05-28"
  }
}

{
  "siteUrl": "sc-domain:example.com",
  "query": "example keyword",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "metrics": { "clicks": 421, "impressions": 9120, "ctr": 0.046, "position": 7.8 }
}

page_performance

Like query_performance, but for a single page. Use page (exact page URL) instead of query.

{
  "name": "page_performance",
  "arguments": {
    "siteUrl": "sc-domain:example.com",
    "page": "https://example.com/product",
    "startDate": "2026-05-01",
    "endDate": "2026-05-28"
  }
}

{
  "siteUrl": "sc-domain:example.com",
  "page": "https://example.com/product",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "metrics": { "clicks": 132, "impressions": 4010, "ctr": 0.033, "position": 9.4 }
}

compare_periods

Compares metrics between two periods with both absolute and percentage differences. Can be broken down by a dimension.

string (enum)

Optional breakdown: query, page, country, device, searchAppearance or date. Omit to compare across the whole property.

object

{ startDate, endDate, totals }, where totals is clicks, impressions, ctr, position.

object

Differences: clicks and impressions have { absolute, percent }; ctr and position have { absolute }. percent is null if the baseline was 0.

{
  "name": "compare_periods",
  "arguments": {
    "siteUrl": "sc-domain:example.com",
    "periodAStart": "2026-04-01",
    "periodAEnd": "2026-04-28",
    "periodBStart": "2026-05-01",
    "periodBEnd": "2026-05-28"
  }
}

{
  "siteUrl": "sc-domain:example.com",
  "dimension": null,
  "periodA": { "startDate": "2026-04-01", "endDate": "2026-04-28", "totals": { "clicks": 3800, "impressions": 81000, "ctr": 0.047, "position": 8.1 } },
  "periodB": { "startDate": "2026-05-01", "endDate": "2026-05-28", "totals": { "clicks": 4200, "impressions": 86000, "ctr": 0.049, "position": 7.6 } },
  "delta": {
    "clicks": { "absolute": 400, "percent": 10.5 },
    "impressions": { "absolute": 5000, "percent": 6.2 },
    "ctr": { "absolute": 0.002 },
    "position": { "absolute": -0.5 }
  }
}

search_analytics_query

Advanced: send a raw Search Analytics query straight through to the Search Console API. For power users who want the full surface (dimensions, filters, pagination).

object

required

Raw Search Analytics request body:

Show fields

{
  "name": "gsc__top_queries",
  "arguments": {
    "siteUrl": "sc-domain:example.com",
    "startDate": "2026-05-01",
    "endDate": "2026-05-28",
    "limit": 5
  }
}

{
  "name": "search_analytics_query",
  "arguments": {
    "siteUrl": "sc-domain:example.com",
    "requestBody": {
      "startDate": "2026-05-01",
      "endDate": "2026-05-28",
      "dimensions": ["query", "device"],
      "dimensionFilterGroups": [
        { "filters": [{ "dimension": "country", "operator": "equals", "expression": "dnk" }] }
      ],
      "rowLimit": 100,
      "dataState": "final"
    }
  }
}

{
  "siteUrl": "sc-domain:example.com",
  "responseAggregationType": "byProperty",
  "rows": [
    { "keys": ["example keyword", "MOBILE"], "clicks": 210, "impressions": 5400, "ctr": 0.039, "position": 8.2 }
  ]
}

Fields like ctr (0–1) and position follow the Search Console API’s own definitions. See Errors & limits for limits and data freshness.

The most-clicked pages for a property over a date range. Same arguments as top_queries (limit defaults to 10, max 25000).

{
  "name": "gsc__top_pages",
  "arguments": {
    "siteUrl": "sc-domain:example.com",
    "startDate": "2026-05-01",
    "endDate": "2026-05-28"
  }
}

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "pages": [
    { "page": "https://example.com/", "clicks": 980, "impressions": 21340, "ctr": 0.046, "position": 5.1 }
  ]
}

{
  "name": "gsc__query_performance",
  "arguments": {
    "siteUrl": "sc-domain:example.com",
    "query": "example keyword",
    "startDate": "2026-05-01",
    "endDate": "2026-05-28"
  }
}

{
  "siteUrl": "sc-domain:example.com",
  "query": "example keyword",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "metrics": { "clicks": 421, "impressions": 9120, "ctr": 0.046, "position": 7.8 }
}

Like query_performance, but for a single page. Use page (exact page URL) instead of query. Returns zeros if the page has no data in the period.

{
  "name": "gsc__page_performance",
  "arguments": {
    "siteUrl": "sc-domain:example.com",
    "page": "https://example.com/product",
    "startDate": "2026-05-01",
    "endDate": "2026-05-28"
  }
}

{
  "siteUrl": "sc-domain:example.com",
  "page": "https://example.com/product",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "metrics": { "clicks": 132, "impressions": 4010, "ctr": 0.033, "position": 9.4 }
}

Compares Search Analytics metrics between two periods with both absolute and percentage differences. Can be broken down by a dimension. Totals are summed across the rows: position is the impression-weighted average and ctr is clicks / impressions.

{
  "name": "gsc__compare_periods",
  "arguments": {
    "siteUrl": "sc-domain:example.com",
    "periodAStart": "2026-04-01",
    "periodAEnd": "2026-04-28",
    "periodBStart": "2026-05-01",
    "periodBEnd": "2026-05-28"
  }
}

{
  "siteUrl": "sc-domain:example.com",
  "dimension": null,
  "periodA": { "startDate": "2026-04-01", "endDate": "2026-04-28", "totals": { "clicks": 3800, "impressions": 81000, "ctr": 0.047, "position": 8.1 } },
  "periodB": { "startDate": "2026-05-01", "endDate": "2026-05-28", "totals": { "clicks": 4200, "impressions": 86000, "ctr": 0.049, "position": 7.6 } },
  "delta": {
    "clicks": { "absolute": 400, "percent": 10.5 },
    "impressions": { "absolute": 5000, "percent": 6.2 },
    "ctr": { "absolute": 0.002 },
    "position": { "absolute": -0.5 }
  }
}

object

required

Raw Search Analytics request body:

Show fields

string (YYYY-MM-DD)

required

string (YYYY-MM-DD)

required

{
  "name": "gsc__search_analytics_query",
  "arguments": {
    "siteUrl": "sc-domain:example.com",
    "requestBody": {
      "startDate": "2026-05-01",
      "endDate": "2026-05-28",
      "dimensions": ["query", "device"],
      "dimensionFilterGroups": [
        { "filters": [{ "dimension": "country", "operator": "equals", "expression": "dnk" }] }
      ],
      "rowLimit": 100,
      "dataState": "final"
    }
  }
}

{
  "siteUrl": "sc-domain:example.com",
  "responseAggregationType": "byProperty",
  "rows": [
    { "keys": ["example keyword", "MOBILE"], "clicks": 210, "impressions": 5400, "ctr": 0.039, "position": 8.2 }
  ]
}

Fields like ctr (0 to 1) and position follow the Search Console API’s own definitions. See Errors & limits for limits and data freshness.

Introduction

Connect an MCP client

API reference

API reference: Google Search Console

Common parameters

list_sites

top_queries

top_pages

query_performance

page_performance

compare_periods

search_analytics_query

​Common parameters

​list_sites

​top_queries

​top_pages

​query_performance

​page_performance

​compare_periods

​search_analytics_query

Common parameters

list_sites

top_queries

top_pages

query_performance

page_performance

compare_periods

search_analytics_query