CoreFreeFirst-Party Ground TruthActive in MCP

List Websites

list_websites()

List tracked websites and their connection state.

Lists all tracked client websites in your workspace, along with their connected Search Console site URLs and GA4 property IDs.

Input Parameters

0 arguments

This tool takes no arguments.

{}

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 tracked client websites in your workspace, along with their connected Search Console site URLs and GA4 property IDs.

coverage & Freshness

Reports returned count vs total items, observation timestamp as_of, and scope notes. Evaluated live per request.

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

Registered Entities

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

property

Website workspace entity with primary_domain and active Google connections.

Request & Response Examples

Live MCP Payloads

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

1. Client Tool Invocation

list_websites request.json
{
  "tool": "list_websites",
  "arguments": {}
}

2. Server Envelope Response

list_websites response.json
{
  "schema_version": "ofe/1.0",
  "domain": "core",
  "data": {
    "connection_required": false
  },
  "facts": [],
  "entities": [
    {
      "id": "urn:property:ws_987654",
      "kind": "property",
      "label": "Vouched Production",
      "attrs": {
        "primary_domain": "vouchedhq.com",
        "connections": {
          "search_console": "connected",
          "website_analytics": "connected"
        }
      }
    }
  ],
  "coverage": {
    "returned": 1,
    "total": 1,
    "as_of": null,
    "scope_note": null
  },
  "deltas": [],
  "resources": [],
  "next_actions": []
}

LLM Agent Workflow

Claude & Cursor Integration
Step 1

Prompt Trigger

"Which websites do I have connected to Search Console and GA4?"
Step 2

Agent Decision & Reasoning

Agents call list_websites first when resolving which domain to run audits, performance reports, or indexing checks against.

Provenance Guarantees & Error Handling

Reliability
Source Classcore
Inspection Methodcore.list_websites
OFE Calibration Score1.00 (OFE 1.0 scale)
Cache DurationNone (Live)

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.

More Core Tools

2 sibling tools
Describe CapabilitiesFree
describe_capabilities()

Enabled domains, tools, fact types, source classes.

Export DatasetFree
export_dataset()

Fetch a full dataset by mcpseo:// uri.

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