List every Google Search Console property the authenticated user can access.

Returns a table of site URLs and permission levels. Use the exact siteUrl string returned here when calling other tools — the format matters (domain properties use 'sc-domain:example.com' prefix).

Run a flexible Search Analytics query against a property.

This is the general-purpose analytics tool. For common cases, prefer the convenience tools gsc_top_queries or gsc_top_pages. Use this tool when you need multi-dimensional grouping (e.g. query x device x country) or non-default search types (image, video, news, discover).

Returns clicks, impressions, CTR and average position per row.

Return the top N search queries for a site over a recent period.

Convenience wrapper over gsc_query_search_analytics. Use this when you want a quick ranking of which queries are driving impressions/clicks — ideal for weekly SEO check-ins.

Return the top N landing pages for a site over a recent period.

Convenience wrapper over gsc_query_search_analytics. Use this to spot which URLs drive the most organic traffic and which are underperforming.

Run the URL Inspection API for a specific page.

Returns indexing verdict, coverage state, last crawl time, Google-chosen canonical, mobile usability, rich results — everything the Inspect URL panel in Search Console shows. Use this to diagnose why a page isn't ranking, confirm indexing after a publish, or spot canonical mismatches.

Rate limit: ~2000 calls per property per day. For bulk inspections, add a sleep between calls (a future bulk tool will handle this).

List every sitemap registered for a property, with status and error counts.

Useful for: verifying a sitemap was accepted, spotting sitemaps that have parse errors, and confirming fresh submission dates.

Diagnostic: confirm the OAuth token is valid and the Search Console API is reachable.

Run this first when setting up the server or after errors to determine whether the issue is auth, network, or a specific site.