SEOPro / BYOKSearch IndexActive in MCP

Inspect Domain

inspect_domain(domain: string)

Compact factual snapshot for one domain.

High-level organic overview containing estimated traffic, ranked keyword count, top 10 keywords, and top 5 organic competitors.

Input Parameters

1 argument

Parameter	Type	Requirement	Default / Constraints	Description
`domain`	`string`	required	Valid hostname or apex domain (e.g. stripe.com)	The apex domain or subdomain to snapshot.

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

High-level organic overview containing estimated traffic, ranked keyword count, top 10 keywords, and top 5 organic competitors.

`coverage` & Freshness

Reports returned count vs total items, observation timestamp as_of, and scope notes. Cached in KV for 24 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
`seo.domain_summary`	Estimated monthly organic visits and total ranked keyword count.	`estimated_organic_trafficranked_keyword_count`
`seo.keyword_ranking`	Top ranked organic keywords with absolute rank and monthly volume.	`keywordpositionsearch_volume`
`seo.top_page`	Aggregated organic performance and traffic for top landing pages.	`urltotal_ranked_keywordstotal_estimated_traffic`
`seo.competitor`	Top organic competitor domains and shared keyword intersections.	`competitor_domainshared_keyword_count`

Registered Entities

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

domain

Target domain and competitor domains.

keyword

Top organic ranking keywords.

Request & Response Examples

Live MCP Payloads

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

1. Client Tool Invocationinspect_domain request.json
{
  "tool": "inspect_domain",
  "arguments": {
    "domain": "stripe.com"
  }
}

2. Server Envelope Responseinspect_domain response.json
{
  "schema_version": "ofe/1.0",
  "domain": "seo",
  "data": {
    "domain": "stripe.com"
  },
  "facts": [
    {
      "type": "seo.domain_summary",
      "subject": [
        "urn:domain:stripe.com"
      ],
      "data": {
        "estimated_organic_traffic": 12450000,
        "ranked_keyword_count": 842000
      },
      "provenance": {
        "source_class": "search_index",
        "method": "domain_overview",
        "confidence": 0.75,
        "observed_at": "2026-09-24T00:00:00Z",
        "cache_hit": false
      }
    },
    {
      "type": "seo.keyword_ranking",
      "subject": [
        "urn:domain:stripe.com",
        "urn:keyword:online+payments"
      ],
      "data": {
        "keyword": "online payments",
        "position": 1,
        "search_volume": 74000
      },
      "provenance": {
        "source_class": "search_index",
        "method": "ranked_keywords",
        "confidence": 0.75,
        "observed_at": "2026-09-24T00:00:00Z",
        "cache_hit": false
      }
    },
    {
      "type": "seo.competitor",
      "subject": [
        "urn:domain:stripe.com",
        "urn:domain:adyen.com"
      ],
      "data": {
        "competitor_domain": "adyen.com",
        "shared_keyword_count": 28400
      },
      "provenance": {
        "source_class": "search_index",
        "method": "organic_competitors",
        "confidence": 0.75,
        "observed_at": "2026-09-24T00:00:00Z",
        "cache_hit": false
      }
    }
  ],
  "entities": [
    {
      "id": "urn:domain:stripe.com",
      "kind": "domain",
      "label": "stripe.com"
    },
    {
      "id": "urn:keyword:online+payments",
      "kind": "keyword",
      "label": "online payments"
    },
    {
      "id": "urn:domain:adyen.com",
      "kind": "domain",
      "label": "adyen.com"
    }
  ],
  "coverage": {
    "returned": 16,
    "total": null,
    "as_of": "2026-09-24T00:00:00Z",
    "scope_note": "top 10 keywords and top 5 competitors only; use research_keywords/discover_competitors for more"
  },
  "deltas": [],
  "resources": [],
  "next_actions": [
    {
      "tool": "discover_competitors",
      "args": {
        "domain": "stripe.com"
      },
      "use_when": "deep competitor research is needed"
    },
    {
      "tool": "research_keywords",
      "args": {
        "seedKeywords": [
          "online payments"
        ]
      },
      "use_when": "expanding keyword demand"
    }
  ]
}

LLM Agent Workflow

Claude & Cursor Integration

Step 1

Prompt Trigger

"Give me an organic search snapshot of stripe.com."

Step 2

Agent Decision & Reasoning

The model runs inspect_domain to get estimated traffic volume, primary ranking keywords, and top competitors in a single compound call before drilling into specific keywords.

Step 3

Recommended Follow-up Tools

discover_competitors →research_keywords →inspect_backlinks →

Provenance Guarantees & Error Handling

Reliability

Source Classsearch_index

Inspection Methoddomain_overview

OFE Calibration Score0.75 (OFE 1.0 scale)

Cache Duration24 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

Paid market data, on Pro and Team. A call typically costs about $0.038 per call of market data, so Pro's included $4 covers roughly 105 calls. Self-hosted, it uses your own DataForSEO key and bills you directly, with nothing added. See pricing for what each tool costs.