Model Context Protocol

Structured web data
ready for agent workflows

Give an MCP-enabled agent a public URL and receive concise Schema.org JSON-LD or field-level Product evidence. Start with a free preflight, choose the result you need, and pay only for a successful paid response.

JSON Recon gives agents a compact, machine-readable result instead of an entire page of content. Each paid result follows a published JSON contract and includes the signals an agent needs to decide whether to use, review, or reject the data.

Useful structure without carrying an entire page into context

Use JSON Recon when an agent needs structured page data, predictable fields, or Product evidence without repeating page-reading work in every downstream step.

Concise agent context

Receive the primary structured entity and useful response metadata instead of passing raw page content through every later step.

Predictable contracts

Full, Lite, and Verified Product advertise reusable JSON Schemas through MCP, OpenAPI, and x402 discovery so agents can validate and route results consistently.

Evidence when it matters

Verified Product reports field-level support, conflicts, coverage, observation time, and a content hash. Its verdict describes consistency within the requested page, not an independent guarantee about the seller or item.

Predictable purchasing

Use a prepaid API key or an x402 wallet. Prices are fixed by result type, preflight is free, and failed paid requests are not charged.

Keep web research structured and bounded

The service is designed for tasks where a compact entity or explicit Product evidence is more useful than a large page payload.

Common Uses

Agent-ready web data

  • • Catalog and research enrichment
  • • Structured-data audits and implementation assistance
  • • Product comparison and purchasing workflows
  • • Content classification and routing
  • • Compact inputs for later agent steps
Customer-Visible Benefits

Clear inputs and outputs

  • • One public URL as the required input
  • • JSON Schema contracts for paid successes
  • • Confidence, provenance, and timing metadata
  • • Explicit low-information and conflict signals
  • • Fixed per-success prices

Actual context and latency savings depend on the page, client, and workflow. JSON Recon returns concise JSON so agents can avoid carrying unnecessary page content forward.

Clear outcomes for public-page requests

Public pages vary in accessibility and data quality. JSON Recon returns an explicit success or failure and charges only successful paid responses.

Input

Simple input

Submit a public URL and the requested result type. No page-specific configuration is required.

Preflight

Free preflight

Check whether a URL is a reasonable candidate before authorizing a paid request.

Metadata

Explicit metadata

Paid successes include a primary type, confidence, timing, and other result-specific quality signals.

Per-success billing: Preflight is free. Failed paid requests do not consume prepaid balance, and x402 authorization settles only for a successful paid response.

Three MCP Tools

Start with the free check. Then choose Lite for published markup, Full for a useful page-level entity, or Verified Product for field-level Product evidence.

Quick choice: need exactly what the page publishes? Choose Lite. Need a useful primary entity? Choose Full. Need field-level Product evidence and conflicts? Choose Verified Product.

Primary Tool · $0.01

extract_schema

Choose Full for a concise page-level Schema.org entity at $0.01 or Lite for Schema.org JSON-LD published by the page at $0.005. Lite marks navigation-only or container-only results as low information.

// Every response includes provenance metadata:
schema_type: "Recipe"
confidence: "high"
source: "json-ld (native)"
extraction_ms: 214
Verified Product · $0.02

verify_product

Checks Product fields against multiple representations on the requested page. Returns field-level evidence, contradictions, observation time, a content hash, and a verified, conflicted, or insufficient_evidence verdict. Non-product pages do not consume balance.

Pre-flight · Free

check_extractability

A free check that tells an agent whether a public URL is a reasonable extraction candidate before spending. It returns a concise difficulty and confidence assessment without requiring credentials.

// Pre-flight response example:
extractable: true
difficulty: "easy"
expected_type: "Recipe"
cost: $0.00
$0.005
Lite

Published Schema.org data, with low-information signaling.

$0.01
Full

A concise page-level Schema.org entity.

$0.02
Verified Product

Field-level corroboration and contradiction evidence.

Designed for reliable downstream use

Each paid success follows a published result contract. Agents can validate required fields, inspect quality signals, and handle each result type without guessing its shape.

Entity

Schema.org entity

Full and Lite return JSON-LD with a primary schema_type.

Quality

Quality signals

Responses expose confidence and provenance metadata. Lite also identifies a result that contains only navigation or container markup.

Verdict

Product verdicts

Verified Product returns verified, conflicted, or insufficient_evidence with field-level support and contradictions.

Contracts

Shared definitions

The same contracts are advertised through MCP, OpenAPI, and x402 discovery to reduce integration drift.

Compact results with decision-ready signals

Paid successes provide the structured entity plus the metadata defined for that result type. Values vary with the requested public page.

Full and Lite

Structured entity response

Expect success, data, schema_type, confidence, cached, and extraction_ms, with additional public metadata when available.

Verified Product

Evidence response

Expect a Product entity, verdict, observed time, content hash, field evidence, contradictions, coverage counts, and an estimate of context avoided.

Full or Lite response shape
{
  "success": true,
  "data": { "@type": "Product", ... },
  "schema_type": "Product",
  "confidence": "high",
  "cached": false,
  "extraction_ms": 1200
}
Route

Use the type

Route the entity to the part of your workflow that handles its declared schema_type.

Review

Use the quality signal

Stop, retry, or request review when confidence is low, Lite reports low information, or Product evidence conflicts.

Provenance

Keep useful provenance

Retain the public confidence, source, observation time, and content hash fields required by your application.

Install once, then choose a payment option

Free preflight: install the MCP server with no credentials and use check_extractability before paying. Paid tools explain which credential is missing.
Prepaid API key: generate a key in the developer dashboard, add balance, and set JSONRECON_API_KEY.
x402 wallet: use a dedicated low-balance wallet funded with USDC on Base mainnet. No JSON Recon account is required.

Add the configuration to Claude Desktop, Cursor, or another MCP client, then restart that client. Keep API keys and wallet keys only in its environment configuration. When both payment options are present, prepaid API-key billing is used by default.

Create a prepaid API key →
claude_desktop_config.json
Prepaid API key
{
  "mcpServers": {
    "jsonrecon": {
      "command": "npx",
      "args": ["-y", "@jsonrecon/mcp-server"],
      "env": {
        "JSONRECON_API_KEY": "jr_liv_xxxxx"
      }
    }
  }
}
Agent-controlled x402 wallet
{
  "mcpServers": {
    "jsonrecon": {
      "command": "npx",
      "args": ["-y", "@jsonrecon/mcp-server"],
      "env": {
        "JSONRECON_PAYMENT_MODE": "x402",
        "JSONRECON_EVM_PRIVATE_KEY": "0x_your_private_key",
        "JSONRECON_X402_SESSION_LIMIT_USDC": "1.00"
      }
    }
  }
}

Check, choose, call, consume

The MCP server exposes all three tools immediately. A practical agent flow is short and explicit.

01

Check the URL

Call check_extractability with the public URL.

02

Choose the result

Select Lite, Full, or Verified Product based on the decision the agent needs to make.

03

Authorize payment

Use prepaid balance or the configured x402 wallet for the published price.

04

Use the JSON

Validate the result and pass only the fields needed by the next workflow step.

Prompts an agent can use immediately

“Check whether this URL is a good JSON Recon candidate before spending anything.”

“Use Lite to retrieve the Schema.org JSON-LD published on this page and flag a low-information result.”

“Use Full to return the primary page-level Schema.org entity, then summarize only the fields relevant to my task.”

“Verify this product page and stop if the price, availability, or identity fields conflict.”

Clear behavior for unattended agents

Successful responses are charged

Preflight is free. Lite is $0.005, Full is $0.01, and Verified Product is $0.02. Failed paid requests and non-product Verified requests do not consume balance.

Keep credentials private

Never paste an API key or private key into a prompt, support message, repository, or website form. Use your MCP client's environment configuration.

Set a wallet budget

Use a dedicated low-balance wallet and set JSONRECON_X402_SESSION_LIMIT_USDC to the maximum authorization total appropriate for the task.

Public pages only

Login-only content, private networks, and pages that deny automated access may fail. Use preflight first when access is uncertain.

Evidence has a defined scope

Verified Product reports consistency among representations on one page at one observation time. It is not seller authentication, inventory confirmation, or an independent product guarantee.

Common responses

401: check the API key. 402: fund or authorize payment. 422: revise the URL or requested result. 429: wait and retry.

Important: JSON Recon helps agents obtain and evaluate Schema.org data. Search engines and other consumers apply their own eligibility, quality, and ranking policies; a structured result is not a ranking or rich-result guarantee.

Schema.org
Structured Entities
$0
Free Preflight
3
Paid Result Options
2
Payment Options
JSON Schema
Published Contracts