google-search-console
Read Google Search Console data through the Search Console API: organic search performance (clicks, impressions, CTR, average position), the list of verified properties, submitted sitemaps and their processing status, and the indexing state of individual URLs (URL Inspection).
Connect this API to an AI agent Browse all specs
What you can do with google-search-console via MCP
Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.
| Method | Path | Operation | Description |
|---|---|---|---|
| GET | /webmasters/v3/sites |
listGoogleSearchConsoleSites | List Search Console properties the connected user can access Method: GET Path: /webmasters/v3/sites |
| POST | /webmasters/v3/sites/{siteUrl}/searchAnalytics/query |
queryGoogleSearchAnalytics | Query organic search performance (clicks, impressions, CTR, position) Method: POST Path: /webmasters/v3/sites/{siteUrl}/searchAnalytics/query IMPORTANT: This function has 3 REQUIRED parameter(s) and 7 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - siteUrl: The exact Search Console property string, taken verbatim from Search Console > Settings or from listGoogleSearchConsoleSites. Use a URL-prefix property with its trailing slash, e.g. "https://vxagents.net/", or a domain property, e.g. "sc-domain:vxagents.net". Pass the raw value; it is URL-encoded automatically. Do not pre-encode it. Request Body: REQUIRED: - startDate: First day of the range, YYYY-MM-DD, in the property's time zone. - endDate: Last day of the range, YYYY-MM-DD, inclusive. OPTIONAL: - dimensions: Group rows by these dimensions. Omit for a single totals row. - type: Which search surface to report on. - dimensionFilterGroups: dimensionFilterGroups array - aggregationType: How to aggregate rows. "auto" lets Google choose, "byProperty" aggregates across the whole property, "byPage" aggregates by URL. - rowLimit: Maximum number of rows to return (1 to 25000). - startRow: Zero-based first row to return, for pagination. - dataState: "final" returns only finalized data (default). "all" also includes the most recent, still-fresh days that may change. |
| GET | /webmasters/v3/sites/{siteUrl}/sitemaps |
listGoogleSearchConsoleSitemaps | List sitemaps submitted for a property Method: GET Path: /webmasters/v3/sites/{siteUrl}/sitemaps IMPORTANT: This function has 1 REQUIRED parameter(s) and 1 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - siteUrl: The exact Search Console property string, taken verbatim from Search Console > Settings or from listGoogleSearchConsoleSites. Use a URL-prefix property with its trailing slash, e.g. "https://vxagents.net/", or a domain property, e.g. "sc-domain:vxagents.net". Pass the raw value; it is URL-encoded automatically. Do not pre-encode it. Query Parameters: OPTIONAL: - sitemapIndex: Full URL of a sitemap index. When set, returns only the sitemaps contained in that index. |
| GET | /webmasters/v3/sites/{siteUrl}/sitemaps/{feedpath} |
getGoogleSearchConsoleSitemap | Get processing status of one sitemap Method: GET Path: /webmasters/v3/sites/{siteUrl}/sitemaps/{feedpath} IMPORTANT: This function has 2 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - siteUrl: The exact Search Console property string, taken verbatim from Search Console > Settings or from listGoogleSearchConsoleSites. Use a URL-prefix property with its trailing slash, e.g. "https://vxagents.net/", or a domain property, e.g. "sc-domain:vxagents.net". Pass the raw value; it is URL-encoded automatically. Do not pre-encode it. - feedpath: The full URL of the sitemap as submitted, e.g. "https://vxagents.net/sitemap.xml". Pass the raw value; it is URL-encoded automatically. |
| POST | /v1/urlInspection/index:inspect |
inspectGoogleSearchConsoleUrl | Inspect the index status of a single URL Method: POST Path: /v1/urlInspection/index:inspect IMPORTANT: This function has 2 REQUIRED parameter(s) and 1 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Request Body: REQUIRED: - inspectionUrl: The fully-qualified URL to inspect. Must belong to the property given by siteUrl. - siteUrl: The property that owns the URL, e.g. "sc-domain:vxagents.net" or "https://vxagents.net/". Passed in the body, not the path. OPTIONAL: - languageCode: BCP-47 language code for the returned messages, e.g. "vi", "en-US". |
Usage guide
Connect a Google account with OAuth2. The connected user must have access to the property in Search Console. Identify a property by its exact Search Console string: a URL-prefix property such as "https://vxagents.net/" (keep the trailing slash) or a domain property such as "sc-domain:vxagents.net". Find it under Search Console > Settings. This template is read-only. It cannot submit or delete sitemaps, add or remove properties, or change any Search Console configuration.
How to use this spec
- Create a free VX Agents account (sandbox tools included).
- Open the marketplace and connect “google-search-console” to an agent.
- Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.