{"openapi":"3.1.0","info":{"title":"Verdicts","version":"0.1.0","description":"x402-paid attestation verdicts: is this citation still current, and is this domain agent-ready. REST twin of the MCP server at https://verdictmcp.com/mcp.","contact":{"name":"ux-xd","url":"https://agie.sh","email":"ops@agie.sh"}},"servers":[{"url":"https://verdictmcp.com"}],"paths":{"/tools/attest_freshness":{"post":{"operationId":"attest_freshness","summary":"Freshness verdict for a factual claim + its source URL: returns current/stale/disputed with observed publish-times, content hash and archive snapshot URL. Free sample of the paid x402 rail at https://verdictmcp.com/verdict/freshness. Use when an agent is about to cite a fact and must know it still holds.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"claim":{"type":"string","minLength":3,"maxLength":500,"description":"The factual claim to attest, verbatim, e.g. \"left-pad latest version is 1.3.0, published 2016\""},"source_url":{"type":"string","format":"uri","description":"The URL the claim came from or points at"},"task_context":{"type":"string","minLength":1,"maxLength":500,"description":"One sentence on what the user is ultimately trying to do (the task this call serves). Required; it tunes the result and is how this free service learns what agents need."}},"required":["claim","source_url","task_context"],"additionalProperties":false}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/tools/attest_readiness":{"post":{"operationId":"attest_readiness","summary":"Agent-readiness verdict for a domain: checks llms.txt, .well-known/mcp.json, a reachable MCP endpoint, docs .md mirrors and npm keyword hygiene. Use when deciding whether a property is discoverable to agents or worth crawling.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"domain":{"type":"string","minLength":4,"maxLength":200,"description":"The domain to check, e.g. example.com"},"task_context":{"type":"string","minLength":1,"maxLength":500,"description":"One sentence on what the user is ultimately trying to do (the task this call serves). Required; it tunes the result and is how this free service learns what agents need."}},"required":["domain","task_context"],"additionalProperties":false}}}},"responses":{"200":{"description":"Tool result","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/verdict/freshness":{"post":{"operationId":"verdict_freshness","summary":"Freshness verdict (x402 $0.01, class 1)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["claim","source_url"],"properties":{"claim":{"type":"string"},"source_url":{"type":"string","format":"uri"}}}}}},"responses":{"200":{"description":"Verdict record (settled)"},"402":{"description":"x402 payment required"},"422":{"description":"ok:false — unverifiable, never settled"}}}},"/verdict/freshness/deep":{"post":{"operationId":"verdict_freshness_deep","summary":"Freshness verdict incl. archive reconstruction (x402 $0.04, class 2)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["claim","source_url"],"properties":{"claim":{"type":"string"},"source_url":{"type":"string","format":"uri"}}}}}},"responses":{"200":{"description":"Verdict record (settled)"},"402":{"description":"x402 payment required"},"422":{"description":"ok:false — never settled"}}}},"/verdict/freshness/attest":{"post":{"operationId":"verdict_freshness_attest","summary":"Freshness verdict with evidence pack (x402 $0.12, class 3)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["claim","source_url"],"properties":{"claim":{"type":"string"},"source_url":{"type":"string","format":"uri"}}}}}},"responses":{"200":{"description":"Verdict record (settled)"},"402":{"description":"x402 payment required"},"422":{"description":"ok:false — never settled"}}}},"/verdict/readiness":{"post":{"operationId":"verdict_readiness","summary":"Agent-readiness verdict for a domain (FREE trial surface)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["domain"],"properties":{"domain":{"type":"string"}}}}}},"responses":{"200":{"description":"Readiness record (free)"}}}}}}