# Sourced RUN — hosted corroboration API > No-auth-required, CORS-open endpoint for Sourced corroboration verdicts: POST claims, get back how many independent origins corroborate each one, with receipts. Never "true" — only "corroborated". API keys add persistent memory and an own transparency chain. ## Endpoint POST https://sourced.run/api/v1/assess (content-type: application/json) — frozen path, v1 never breaks. (/api/assess is an alias.) Request: { "claims": [{ "id": string, "title": string, "origin": string, "publishedAt": ISO-8601 }], "clusters"?: { [claimId]: origin[] }, "config"?: { numeric threshold overrides } } Response: { "verdicts": [ { "corroboration": n, "corroboratingSources": string[], "firstSeenAt": ISO-8601, "signal": "confirmed"|"breaking"|"developing"|null } | null ], "memory": "batch"|"persistent" } — verdicts[i] belongs to claims[i]; null = unassessable claim (passes through unlabeled, never an error). Semantics (anonymous): batch-scoped — corroboration is computed across the claims in one request; same titles from different origins corroborate; copies from the same origin collapse to 1 (independence by origin); single-origin claims get signal null and no receipts. Limits: 200 claims / 200 kB / 60 requests-minute. GET the endpoint for a machine-readable usage summary. Errors: 400 { "error": string } for a malformed envelope only; 429 with Retry-After when over budget. ## API keys (persistent tier) Send `Authorization: Bearer sk_src_…` and the same endpoint gains cross-request memory: an event reported by a new origin an hour later STILL corroborates, firstSeenAt becomes the true first sighting, and limits rise to 600 requests/minute. Each key also owns a hosted transparency chain: - POST https://sourced.run/api/v1/chain { "payload": any-JSON } (key required) → hash-chained LogRecord; heads are anchored daily into public git history (github.com/Ryan-hasi/sourced/tree/main/anchors) - GET https://sourced.run/api/v1/chain?chain=&full=1 → the whole history, publicly readable by anyone (that is the point) - GET https://sourced.run/api/v1/chains → public directory of all hosted chains Keys are issued manually for now: hello@tickwire.news. Example: curl -s https://sourced.run/api/v1/assess -H "content-type: application/json" -d '{"claims":[{"id":"a","title":"Major dam breach reported upstream","origin":"reuters","publishedAt":"2026-07-10T21:00:00Z"},{"id":"b","title":"Major dam breach reported upstream","origin":"bbc","publishedAt":"2026-07-10T21:04:00Z"}]}' → verdicts[1] = { "corroboration": 2, "corroboratingSources": ["reuters"], "signal": "breaking", ... } Machine-readable contract: https://sourced.run/openapi.json (OpenAPI 3.1 — assess, verify, chain, chains). Also on this host: POST /api/v1/verify — verify a Sourced transparency chain programmatically ({ chain: LogRecord[] } or { jsonl }, optional inclusion proof via { payload, seq }). ## For AI agents MCP server (stdio): `npx -y @sourcedhq/mcp` — server name "sourced", tools: assess (session memory accumulates corroboration across calls), verify_chain, run_conformance. Persistent event memory (first-seen across runs) = an API key on this host, or run @sourcedhq/core yourself with a store. ## More - [Full specification](https://sourced.ink) · [spec llms.txt](https://sourced.ink/llms.txt) - [Proof: live adversarial suite + chain verifier](https://sourced.network)