{"openapi":"3.1.0","info":{"title":"AgentRead — source-grounded web context","version":"0.3.1","description":"Static web pages to bounded text, tables, links and keyword-ranked verbatim evidence. REST and remote MCP. No account; Base USDC x402 for live fetching. No JS rendering or LLM inference."},"servers":[{"url":"https://agentread-json-api.army20160422.chatgpt.site"}],"components":{"securitySchemes":{"x402":{"type":"apiKey","in":"header","name":"PAYMENT-SIGNATURE","description":"x402 v2 signed payment authorization. Never a private key."}}},"paths":{"/v1/read":{"get":{"operationId":"readWebContext","summary":"Fetch static web context with source hash and evidence; 0.01 USDC","security":[{"x402":[]}],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"}},"parameters":[{"in":"query","name":"mode","required":false,"schema":{"type":"string","enum":["full","compact"],"default":"full","description":"compact returns only provenance and bounded source passages; omits tables and links"}},{"in":"query","name":"url","required":true,"schema":{"type":"string","format":"uri","maxLength":2000,"description":"Public static HTTPS page"}},{"in":"query","name":"query","required":false,"schema":{"type":"string","maxLength":300,"description":"Optional keywords to rank verbatim evidence passages"}},{"in":"query","name":"max_chars","required":false,"schema":{"type":"integer","minimum":500,"maximum":40000,"default":40000}}],"responses":{"200":{"description":"Structured source content, context evidence, timestamp and SHA256"},"400":{"description":"Invalid URL or context options"},"402":{"description":"x402 v2 challenge; sign locally and retry the same request"},"422":{"description":"Extraction failed; no settlement"},"429":{"description":"Rate limit; respect Retry-After"},"503":{"description":"Unavailable or settlement uncertain; reuse same payment"}}}},"/v1/extract":{"post":{"operationId":"extractSuppliedHtml","security":[],"summary":"Free: parse supplied HTML without fetching","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"html":{"type":"string","maxLength":60000},"url":{"type":"string","format":"uri","description":"Base URL for relative links; never fetched"},"mode":{"type":"string","enum":["full","compact"],"default":"full","description":"compact returns only provenance and bounded source passages; omits tables and links"},"query":{"type":"string","maxLength":300,"description":"Optional keywords to rank verbatim evidence passages"},"max_chars":{"type":"integer","minimum":500,"maximum":40000,"default":40000}},"required":["html","url"],"additionalProperties":false}}}},"responses":{"200":{"description":"Extracted content and evidence; no live-source verification"},"400":{"description":"Invalid input"},"413":{"description":"Body exceeds 64 KiB"},"429":{"description":"Rate limited"}}}},"/demo":{"get":{"operationId":"demo","security":[],"summary":"Free fixed example","responses":{"200":{"description":"Example result"}}}}}}