{"openapi":"3.1.0","info":{"title":"bluerails402 Publisher Registry","version":"1.0.0","description":"Protocol-agnostic publisher registry for agentic payments. Discover EU news and media publishers that accept AI agent payments via MCP.","contact":{"name":"Bluerails","url":"https://bluerails402.com"},"license":{"name":"CC-BY-4.0","url":"https://creativecommons.org/licenses/by/4.0/"},"x-guidance":"How to use this API as an agent:\n1) Discovery: GET /openapi.json for full spec. GET /.well-known/x402 for paid resource list if you prefer a minimal catalog.\n2) List publishers: GET /api/publishers?q=<topic>&protocol=x402 — returns paginated array. All public, no auth.\n3) Get publisher detail: GET /api/publishers/<slug> — returns full publisher record.\n4) Use MCP (preferred): POST /mcp with list_publishers or get_publisher tool calls. Public tools need no auth. get_fx_quote and fetch_content require X-API-Key header.\n5) Payment: If an endpoint returns 402, read the PAYMENT-REQUIRED header for the payment spec.","x-service-info":{"categories":["media","news","micropayments","publishers"],"docs":{"homepage":"https://bluerails402.com","apiReference":"https://bluerails402.com/openapi.json","llms":"https://bluerails402.com/llms.txt","llmsFull":"https://bluerails402.com/llms-full.txt","mcp":"https://bluerails402.com/mcp"}}},"servers":[{"url":"https://bluerails402.com","description":"Production"}],"x-payment-info":{"protocol":"x402","facilitator":"bluerails402","currency":"USDC","network":"base-mainnet"},"paths":{"/api/publishers":{"get":{"summary":"List publishers","description":"Paginated list of active non-test publishers. Public, no auth.","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Full-text search"},{"name":"protocol","in":"query","schema":{"type":"string","enum":["x402","mpp","l402"]}},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":100}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}}],"x-payment-info":{"authMode":"none"},"responses":{"200":{"description":"Array of publishers","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Publisher"}}}}}}}},"/api/publishers/{slug}":{"get":{"summary":"Get publisher by slug","description":"Single publisher by slug. Public, no auth.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"x-payment-info":{"protocols":["x402","mpp"],"offers":[{"amount":"1000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"USDC on Base — access one publisher record","intent":"charge","method":"x402","network":"base-mainnet"}]},"responses":{"200":{"description":"Publisher","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Publisher"}}}},"404":{"description":"Publisher not found"}}}},"/mcp":{"post":{"summary":"MCP JSON-RPC endpoint","description":"Streamable HTTP MCP endpoint. Public tools: list_publishers, get_publisher. Authenticated tools (X-API-Key): get_fx_quote, fetch_content.","x-payment-info":{"authMode":"none"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"responses":{"200":{"description":"JSON-RPC response"},"401":{"description":"Missing or invalid API key for authenticated tool"}}}}},"components":{"schemas":{"Publisher":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"shortDescription":{"type":"string"},"websiteUrl":{"type":"string","format":"uri"},"contentTypes":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"trustTier":{"type":"string","enum":["bronze","silver","gold","platinum"]},"trafficTier":{"type":"string","enum":["high","medium","low","unknown"]},"usdcPricePerRequest":{"type":["string","null"]},"supportedProtocols":{"type":"array","items":{"type":"string"}},"eurauSettlementAvailable":{"type":"boolean"}},"required":["slug","name","websiteUrl","trustTier"]}}}}