Skip to content

MCP Tools

Four tools are exposed by this MCP server. All tools work identically across the Go and C# implementations.

Tool Description
query_search_analytics Query clicks, impressions, CTR, and average position
list_sites List all Search Console properties the service account can access
list_sitemaps List submitted sitemaps and their status for a property
inspect_url Inspect Google's indexed status and available per-URL enhancement details

Common Notes

Property URL (site_url)

All tools that accept a site_url parameter support flexible input:

  • Bare domain: devleader.ca
  • Full URL: https://www.devleader.ca
  • Canonical GSC form: sc-domain:devleader.ca or https://www.devleader.ca/

The server normalizes the input and automatically retries with property discovery on 403 errors.

Error Responses

All tools return a JSON error object when an exception occurs:

{
  "error": "ExceptionType: message"
}