Skip to content
Get MCP AdsGet MCP Ads, home

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.
filtersarrayOptionalFilters combined according to this tool's query schema. Use provider field names and the declared operators.
searchTypestringOptionalSearch surface to report, such as web, image, video, news or Discover. Availability depends on the property. One of: web, image, video, news, discover, googleNews. Default: "web".
datePresetstringOptionalNamed reporting period. Use the custom date range when you need exact start and end dates. One of: today, yesterday, last7days, last28days, last3months, last6months, last12months, last16months. Default: "last28days".
dateRangeobjectOptionalExplicit reporting start and end dates in YYYY-MM-DD format.
orderBystringOptionalField used to order report rows. One of: clicks, impressions, ctr, position, ctrOpportunity, clicksPerImpression, impressionShare, clickShare. Default: "clicks".
orderDirectionstringOptionalSort direction for the selected ordering field. One of: ASC, DESC. Default: "DESC".
limitintegerOptionalMaximum number of returned items or rows. The declared bounds and default apply; use pagination for additional results. Default: 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