Contract

schema_version 2026-09-14 · header X-Research-MCP-Schema-Version

Caller-visible gate: meta.billable, quotes_verified, quote_gate, fail_gate. Only meta.billable === true is charged.

Deep links (GitHub)

schema.json — also local copy
happy-research-brief.json — local
fail-gate.json — local
TOOLS.md

Shared envelope (summary)

{
  "tldr": "string",
  "body": {},
  "confidence": "high | medium | low | unknown",
  "sources": [{ "title", "url", "publisher", "accessed", "type", "supports", "retrieved_at?" }],
  "gaps": ["string"],
  "as_of": "YYYY-MM-DD",
  "schema_version": "2026-09-14",
  "meta": { "mode": "golden|sample|live", "billable": true },
  "fail_gate": { "reason": "string", "retryable": false },
  "claims": [{ "claim", "quote", "source_url" }],
  "retrieved_at": "ISO-8601"
}

Density bars

quick

≥2 unique · ≥1 primary

standard

≥4 unique · ≥2 primary

Deep (preview): ≥6 unique · ≥3 primary + counter-arguments + gaps — always $0 with flag.

Also at /contract/ · Tools guide · Home