# bluerails402

> Protocol-agnostic registry and settlement layer for agentic payments. Discover EU/DACH publishers, hotels, ecommerce stores, and SaaS companies, and book & pay for hotel stays end-to-end with x402 USDC micropayments via MCP.

bluerails402 is a discovery and settlement layer for AI agents that need to find, and pay for, premium content and services. Agents connect to the MCP endpoint at https://402.bluerails.com/mcp and call the public discovery tools (`list_publishers`, `get_publisher`, `list_hotels`, `get_hotel`, `list_ecommerce`, `get_ecommerce_store`, `list_saas`, `get_saas_company`, `hotel_check_availability`) to browse the registry — all public, no API key required. Payment and settlement tools (`get_fx_quote`, `fetch_content`, `hotel_book`, `hotel_capture`, `hotel_cancel`) require an API key issued to agent operators.

## Endpoints

- [Full publisher list (inline)](https://402.bluerails.com/llms-full.txt): All active non-test publishers in one file. Includes name, slug, website, content types, tags, trust tier, traffic tier, USDC price per request, supported protocols, and EURAU settlement availability.
- [OpenAPI 3.1 spec](https://402.bluerails.com/openapi.json): Machine-readable API surface including `GET /api/publishers`, `GET /api/publishers/{slug}`, and `POST /mcp`. Includes root-level `x-payment-info` extension per the MPP discovery draft.
- [Sitemap](https://402.bluerails.com/sitemap.xml): One entry per active publisher detail page.

## MCP

- Endpoint: https://402.bluerails.com/mcp (streamable HTTP, JSON-RPC 2.0)
- 14 tools total (9 public, 5 require an operator API key via the X-API-Key header)
- Public discovery tools (no auth): `list_publishers`, `get_publisher`, `list_hotels`, `get_hotel`, `list_ecommerce`, `get_ecommerce_store`, `list_saas`, `get_saas_company`, `hotel_check_availability`
- Authenticated payment/settlement tools (X-API-Key): `get_fx_quote`, `fetch_content`, `hotel_book`, `hotel_capture`, `hotel_cancel`
- Hotel booking flow: `hotel_check_availability` → `hotel_book` (x402 USDC settlement) → `hotel_capture` / `hotel_cancel`

## Optional

- [Agent card (A2A v1.0.0)](https://402.bluerails.com/.well-known/agent-card.json)
- [MCP server card (SEP-1649)](https://402.bluerails.com/.well-known/mcp/server-card.json)
- [VS Code MCP config](https://402.bluerails.com/.well-known/mcp.json)