# BookingLayer — the booking layer for AI agents

> Programmatic booking for AI agents (MCP) and humans (API). Live: hotels. Coming soon: flights. Every booking is
> authorized by a human-signed EIP-712 intent mandate and settled through non-custodial escrow.

## For agents
- Discovery: https://booking-layer.ianb-sia.workers.dev/v1/discovery
- Full self-describing schema (flow, intent, errors): https://booking-layer.ianb-sia.workers.dev/v1/schema
- Catalogue of bookable services: https://booking-layer.ianb-sia.workers.dev/v1/catalogue
- Flow: POST /v1/quote → POST /v1/book (HTTP 402 → settle USDC) → signed receipt
- Authorize a human: POST /v1/intents/signing-link (emailable click-to-sign link)
- Funding: self (agent's wallet) or pull (from the human's wallet within a signed cap)
- MCP server available (tools: list_services, search_offers, get_quote, create_signing_link, book)

## Payment
- Protocol: x402 · asset: USDC · network: eip155:84532
- Non-custodial escrow; the layer never holds keys or pulls unauthorized funds.

## Testing mode (recommended, on by default)

Testing is a safe sandbox: mock suppliers, mock escrow, simulated x402 — no real money and no wallet needed. The test MCP server auto-creates an ephemeral agent wallet so you can run the full flow (verify -> search -> book -> settle) immediately.

- Test MCP (Streamable HTTP): POST https://booking-layer.ianb-sia.workers.dev/test/mcp
- Test REST base: https://booking-layer.ianb-sia.workers.dev/test/v1/...   (verify, search, quote, book, deposit/rescind, discovery)
- Prod MCP (Streamable HTTP): POST https://booking-layer.ianb-sia.workers.dev/mcp
- Prod REST base: https://booking-layer.ianb-sia.workers.dev/v1/...

Production cannot complete bookings yet: we are merchant-of-record (not a marketplace), so we must front the supplier payment off-chain, and there is no pre-funded capital yet. The prod code path is real and validated end-to-end up to settlement; only the capital is missing, so book will not settle in production. Use the /test path to run a complete booking.

Install / landing page: https://booking-layer.ianb-sia.workers.dev/install