Skip to content
Get MCP AdsGet MCP Ads, home
Start free

gsc_query_search_analytics

Query Google Search Console Search Analytics. One of 18 Search Console tools on the Get MCP Ads MCP gateway.

Query Google Search Console Search Analytics. Returns clicks, impressions, CTR, and average position for queries, pages, countries, devices, dates, and search appearances. Use gsc://metrics, gsc://dimensions, gsc://filters, and gsc://compatibility for available fields and rules.

Kind
Read
Discovery
Announced in the tool list
Account parameter
siteUrl
Endpoint
https://mcp.getmcpads.com/search-console/mcp

ParametersLink to this section

NameTypeRequiredNotes
siteUrlstringOptionalSearch Console property URL, e.g. https://example.com/ or sc-domain:example.com. Uses GSC_SITE_URL when omitted.
metricsarrayOptionalNative: clicks, impressions, ctr, position. Calculated: ctrOpportunity, clicksPerImpression, impressionShare, clickShare.
dimensionsarrayOptionalUp to 5 dimensions: query, page, country, device, date, searchAppearance.
filtersarrayOptional
searchTypestringOptionalOne of: web, image, video, news, discover, googleNews. Default: "web".
datePresetstringOptionalOne of: today, yesterday, last7days, last28days, last3months, last6months, last12months, last16months. Default: "last28days".
dateRangeobjectOptional
orderBystringOptionalOne of: clicks, impressions, ctr, position, ctrOpportunity, clicksPerImpression, impressionShare, clickShare. Default: "clicks".
orderDirectionstringOptionalOne of: ASC, DESC. Default: "DESC".
limitintegerOptionalDefault: 1000.
startRowintegerOptionalOptional 0-based row offset for explicit pagination.
autoPaginatebooleanOptionalWhen true, omit rowLimit so the GSC client auto-paginates until exhaustion. Default: false.

Calling itLink to this section

jsonDirectly, since it is announced
{
  "name": "gsc_query_search_analytics",
  "arguments": {}
}
Esc

Type to search