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 |
| POST | /webmasters/v3/sites/{siteUrl}/searchAnalytics/query |
queryGoogleSearchAnalytics | Query organic search performance (clicks, impressions, CTR, position) |
| GET | /webmasters/v3/sites/{siteUrl}/sitemaps |
listGoogleSearchConsoleSitemaps | List sitemaps submitted for a property |
| GET | /webmasters/v3/sites/{siteUrl}/sitemaps/{feedpath} |
getGoogleSearchConsoleSitemap | Get processing status of one sitemap |
| POST | /v1/urlInspection/index:inspect |
inspectGoogleSearchConsoleUrl | Inspect the index status of a single URL |
Authentication
GoogleSearchConsoleOAuth2
OAuth 2.0
Scopes: https://www.googleapis.com/auth/webmasters.readonly
Google OAuth2 Authorization Code flow with PKCE. The authorization URL requests offline access and explicit consent so Google can return a refresh token. The connected Google account must have Search Console access to the property.
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.