{"openapi":"3.1.0","info":{"title":"Clearhouse API","description":"One search across every agent registry. Clearhouse crawls the official MCP registry, Glama, Smithery and the x402 Bazaar every six hours, deduplicates across them, and exposes one index.\n\nNo key is required. Responses are JSON. The same index is available to agents natively as an MCP server at `https://mcp.clearhouse.sh/mcp`.\n\nReceipts issued by Clearhouse verify against the key published at `/.well-known/clearhouse-keys.json`.","contact":{"name":"Clearhouse","url":"https://clearhouse.sh/","email":"contact@clearhouse.sh"},"version":"0.1.0"},"servers":[{"url":"https://api.clearhouse.sh","description":"Production"}],"paths":{"/healthz":{"get":{"tags":["Service"],"summary":"Liveness check","description":"Returns `{\"ok\": true}` when the API process is up.","operationId":"healthz_healthz_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Healthz Healthz Get"}}}}}}},"/v0/stats":{"get":{"tags":["Index"],"summary":"Index statistics","description":"How many listings are indexed, broken down by source registry, plus how many are unique after deduplication and how many are callable over the network.","operationId":"stats_v0_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Stats V0 Stats Get"}}}}}}},"/v0/search":{"get":{"tags":["Index"],"summary":"Search every registry","description":"Full-text search across names and descriptions. Duplicates across registries collapse into one result; `also_listed_on` names the other registries it appears on. Use `remote=1` for services callable right now and `source=x402_bazaar` for pay-per-call only.","operationId":"search_v0_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"title":"Q"}},{"name":"remote","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"1 = only remotely-callable","title":"Remote"},"description":"1 = only remotely-callable"},{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Search V0 Search Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v0/listing/{listing_id}":{"get":{"tags":["Index"],"summary":"One listing","description":"Full record for a single listing by its Clearhouse id.","operationId":"listing_v0_listing__listing_id__get","parameters":[{"name":"listing_id","in":"path","required":true,"schema":{"type":"integer","title":"Listing Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Listing V0 Listing  Listing Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v0/evidence/{listing_id}":{"get":{"tags":["Evidence"],"summary":"Evidence report","description":"What Clearhouse has observed about a service: a live protocol probe (handshake, latency, HTTP status) and routed-call history (count, success rate, distinct callers). Includes a summary index with published methodology and a confidence tier. Observation, not endorsement.","operationId":"evidence_v0_evidence__listing_id__get","parameters":[{"name":"listing_id","in":"path","required":true,"schema":{"type":"integer","title":"Listing Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Evidence V0 Evidence  Listing Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v0/methodology":{"get":{"tags":["Evidence"],"summary":"Scoring methodology","description":"The exact arithmetic behind the summary index, the meaning of each confidence tier, and what a report explicitly does not claim.","operationId":"methodology_v0_methodology_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Methodology V0 Methodology Get"}}}}}}},"/.well-known/clearhouse-keys.json":{"get":{"tags":["Receipts"],"summary":"Receipt signing keys","description":"Published signing keys. Verifiers MUST pin against this set (by\nkey_id) rather than trusting a key delivered alongside a receipt.","operationId":"wellknown_keys__well_known_clearhouse_keys_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Wellknown Keys  Well Known Clearhouse Keys Json Get"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"tags":[{"name":"Index","description":"Search and read the unified registry index."},{"name":"Evidence","description":"What Clearhouse has observed about a service, and how it's scored."},{"name":"Receipts","description":"Keys for verifying signed receipts."},{"name":"Service","description":"Operational endpoints."}]}