{"openapi":"3.1.0","info":{"title":"musicbrainz-lookup","version":"0.1.0","description":"listed:true — OpenAPI pre-register shape. Discovery submit HOLD until Board origin list.","x-guidance":"POST /v1/musicbrainz-lookup with application/json per requestBody schema. Unauthenticated probes receive HTTP 402 (x402 exact USDC on Base / eip155:8453). After payment settles, empty or invalid bodies return 400 with charged:false. Free health: GET /healthz and GET /readyz. Contact nicsins@gmail.com.","contact":{"email":"nicsins@gmail.com"}},"paths":{"/v1/musicbrainz-lookup":{"post":{"operationId":"musicbrainz_lookup","summary":"MusicBrainz WS/2 lookup/search (keyless; User-Agent required; 1 req/s). entity + mbid OR query → trimmed JSON.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.003000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"entity":{"type":"string","description":"artist|release|recording|release-group|work|label|area|place|annotation|tag|url|instrument|series|event","maxLength":32},"mbid":{"type":"string","maxLength":36,"description":"MusicBrainz UUID (lookup mode)"},"id":{"type":"string","maxLength":36},"query":{"type":"string","maxLength":200,"description":"Lucene search query (search mode)"},"q":{"type":"string","maxLength":200},"limit":{"type":"integer","minimum":1,"maximum":25,"default":5},"offset":{"type":"integer","minimum":0,"maximum":100,"default":0},"inc":{"type":"string","maxLength":200,"description":"Optional includes for lookup (space/comma separated)"},"request_id":{"type":"string"}}}}}},"responses":{"200":{"description":"ok envelope","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"skill":{"type":"string"},"charged":{"type":"boolean"},"summary":{"type":"string"},"data":{},"request_id":{"type":"string"}},"required":["ok"]}}}},"400":{"description":"empty/invalid after settle — charged:false"},"402":{"description":"payment required"},"503":{"description":"service disabled (kill-switch)"}}}},"/healthz":{"get":{"operationId":"healthz","security":[],"summary":"Liveness","responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}}}}},"/readyz":{"get":{"operationId":"readyz","security":[],"summary":"Readiness","responses":{"200":{"description":"ready","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}},"503":{"description":"not ready"}}}}}}