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.
- Source
- Search Console
- Kind
- Read
- Discovery
- Announced in the tool list
- Account parameter
siteUrl- Endpoint
- https:/
/ mcp. getmcpads. com/ search-console/ mcp
ParametersLink to this section
| Name | Type | Required | Notes |
|---|---|---|---|
siteUrl | string | Optional | Search Console property URL, e.g. https:/ |
metrics | array | Optional | Native: clicks, impressions, ctr, position. Calculated: ctrOpportunity, clicksPerImpression, impressionShare, clickShare. |
dimensions | array | Optional | Up to 5 dimensions: query, page, country, device, date, searchAppearance. |
filters | array | Optional | Filters combined according to this tool's query schema. Use provider field names and the declared operators. |
searchType | string | Optional | Search 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". |
datePreset | string | Optional | Named 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". |
dateRange | object | Optional | Explicit reporting start and end dates in YYYY-MM-DD format. |
orderBy | string | Optional | Field used to order report rows. One of: clicks, impressions, ctr, position, ctrOpportunity, clicksPerImpression, impressionShare, clickShare. Default: "clicks". |
orderDirection | string | Optional | Sort direction for the selected ordering field. One of: ASC, DESC. Default: "DESC". |
limit | integer | Optional | Maximum number of returned items or rows. The declared bounds and default apply; use pagination for additional results. Default: 1000. |
startRow | integer | Optional | Optional 0-based row offset for explicit pagination. |
autoPaginate | boolean | Optional | When true, omit rowLimit so the GSC client auto-paginates until exhaustion. Default: false. |
Calling itLink to this section
{
"name": "gsc_query_search_analytics",
"arguments": {}
}