Search ConsoleFreeFirst-Party Ground TruthRequires Search Console OAuthActive in MCP

List Sitemaps

list_sitemaps(domain: string)

Submitted sitemaps for a tracked website: last-read status, warnings/errors, submitted counts (Google's indexed count here is deprecated, always 0).

Lists all XML sitemaps submitted to Google Search Console for this website, their last submission/read timestamp, processing warnings/errors, and submitted URL counts.

Input Parameters

1 argument

Parameter	Type	Requirement	Default / Constraints	Description
`domain`	`string`	required	none	A tracked website's primary_domain (e.g. example.com).

Return Envelope (OFE / 1.0)

Open Fact Envelope

Every response adheres to the strict ofe/1.0 envelope schema, returning verified data, typed facts, entity references, and follow-up tool suggestions:

`data` Payload

Lists all XML sitemaps submitted to Google Search Console for this website, their last submission/read timestamp, processing warnings/errors, and submitted URL counts.

`coverage` & Freshness

Reports returned count vs total items, observation timestamp as_of, and scope notes. Cached in KV for 6 hours.

`resources` (Dataset Exports)

If a query yields high row counts (e.g. >1,000 queries in Search Console), full unpaginated tables are persisted to R2 and linked as an mcpseo:// URI for follow-up retrieval via export_dataset.

`next_actions`

Provides suggested follow-up tool calls with pre-filled arguments so your AI agent can navigate from discovery to detailed inspection autonomously.

Emitted Facts & Entities

Knowledge Graph

Typed Facts

Facts emitted in the facts[] array with provenance receipts:

Fact Type	Claim Description	Emitted Data Fields
`gsc.sitemap_status`	Sitemap submission status, format, warnings, errors, and submitted contents.	`pathlast_submittedis_pendingis_sitemaps_indexwarningserrorscontents`

Registered Entities

Entities registered in the entities[] array to establish subject relationships:

property

Search Console property entity.

Request & Response Examples

Live MCP Payloads

Exact JSON schemas transmitted over Model Context Protocol (stdio or HTTP SSE transport):

1. Client Tool Invocationlist_sitemaps request.json
{
  "tool": "list_sitemaps",
  "arguments": {
    "domain": "example.com"
  }
}

2. Server Envelope Responselist_sitemaps response.json
{
  "schema_version": "ofe/1.0",
  "domain": "gsc",
  "data": {
    "domain": "example.com",
    "sitemapCount": 1,
    "contentsIndexedCountCaveat": "Google no longer populates each sitemap's contents[].indexed count (always 0); it's not a real signal. Use inspect_indexing for actual per-URL indexing status."
  },
  "facts": [
    {
      "type": "gsc.sitemap_status",
      "subject": [
        "urn:property:ws_12345"
      ],
      "data": {
        "path": "https://example.com/sitemap.xml",
        "last_submitted": "2026-09-20T08:00:00Z",
        "is_pending": false,
        "is_sitemaps_index": false,
        "warnings": 0,
        "errors": 0,
        "contents": [
          {
            "type": "web",
            "submitted": 245
          }
        ]
      },
      "provenance": {
        "source_class": "webmaster_console",
        "method": "searchconsole.sitemaps.list",
        "confidence": 1,
        "observed_at": "2026-09-24T00:00:00Z",
        "cache_hit": true
      }
    }
  ],
  "entities": [
    {
      "id": "urn:property:ws_12345",
      "kind": "property",
      "label": "Example Prod"
    }
  ],
  "coverage": {
    "returned": 1,
    "total": 1,
    "as_of": "2026-09-20T08:00:00Z",
    "scope_note": null
  },
  "deltas": [],
  "resources": [],
  "next_actions": [
    {
      "tool": "inspect_indexing",
      "args": {
        "domain": "example.com",
        "url": "https://example.com/"
      },
      "use_when": "verify index status of individual URLs in sitemap"
    }
  ]
}

LLM Agent Workflow

Claude & Cursor Integration

Step 1

Prompt Trigger

"Are all sitemaps for example.com successfully read by Google without errors?"

Step 2

Agent Decision & Reasoning

The agent verifies sitemap health, checks for Google parse errors, and confirms submitted URL counts match expected production routes.

Step 3

Recommended Follow-up Tools

inspect_indexing →

Provenance Guarantees & Error Handling

Reliability

Source Classwebmaster_console

Inspection Methodsearchconsole.sitemaps.list

OFE Calibration Score1.00 (OFE 1.0 scale)

Cache Duration6 hours

Every fact emitted by Vouched includes source_class, method, observed_at ISO timestamp, and a published confidence score. LLM agents can inspect these citations to distinguish first-party verified facts (e.g. Search Console) from modeled competitor estimates.

Billing & API Keys

Free on every plan: it reads your own Google data, so there's no per-call cost. Works the same when self-hosted.

Connection Required: Requires connecting your Google Search Console property via OAuth. Until it's connected, calls return a connection_required error saying where to connect it (Settings in the dashboard).

Error Conditions

ConnectionRequiredError: no Search Console site configured for domain.

More Search Console Tools

2 sibling tools

Get Search PerformanceFree

get_search_performance()

Query/page/date/country/device performance from Search Console, with filters and period-over-period comparison.

Inspect IndexingFree

inspect_indexing()

Google's own indexing status for one URL: indexed?, canonical Google chose, rich results, last crawl.

Self-host on GitHub (MIT)Try on Cloud plan