# Blue Pillow Hotels & Stays

> Neutral hotel & stay price comparison for AI agents. Live prices from 16+ booking sites via REST or MCP. Anonymous-friendly: agents can issue a permanent key without signup.

## Manifests

- [MCP server card](https://b2a.bluepillow.com/.well-known/mcp/server-card.json): JSON manifest describing the MCP endpoint, tools, and auth flow.
- [MCP discovery manifest](https://b2a.bluepillow.com/.well-known/mcp.json): minimal endpoint + auth manifest (well-known discovery draft).
- [OpenAPI spec](https://b2a.bluepillow.com/.well-known/openapi.yaml): full REST API contract.

## Introduction

- [B2A docs](https://b2a.bluepillow.com/docs/index/): Booking access for AI agents. Anonymous-friendly API, MCP server, and per-stack quickstarts.
- [Quickstart](https://b2a.bluepillow.com/docs/quickstart/): Make your first /v1/decide call in under 5 minutes. No signup, no sandbox.

## API reference

- [POST /v1/keys](https://b2a.bluepillow.com/docs/api/keys/): Issue an anonymous API key. No signup, no email, persistent.
- [POST /v1/decide](https://b2a.bluepillow.com/docs/api/decide/): Stateless top-1 booking recommendation for a travel intent.
- [POST /v1/search/stays](https://b2a.bluepillow.com/docs/api/search-stays/): Ranked discovery search across millions of properties.
- [POST /v1/validate](https://b2a.bluepillow.com/docs/api/validate/): Re-price a previously-seen offer with ±2% tolerance.
- [GET /v1/properties/{id}](https://b2a.bluepillow.com/docs/api/properties/): Canonical property record — amenities, reviews, OTA coverage, dedup metadata.
- [Destinations](https://b2a.bluepillow.com/docs/api/destinations/): Resolve a place name or discover destinations near a coordinate.
- [POST /v1/recommendations/by-hotel](https://b2a.bluepillow.com/docs/api/recommendations/): Best OTA for a property the user has already chosen.
- [POST /v1/bookings/initiate](https://b2a.bluepillow.com/docs/api/bookings/): Generate a tracked booking deep link for the end user.
- [Instrumentation & observability](https://b2a.bluepillow.com/docs/api/instrumentation/): Request IDs, rate-limit headers, usage stats, and how B2A attributes agent traffic.

## MCP server

- [MCP server](https://b2a.bluepillow.com/docs/mcp/): Connect any MCP-compatible agent to the B2A travel decision engine.
- [MCP tools](https://b2a.bluepillow.com/docs/mcp/tools/): Reference for the six MCP tools exposed by the B2A server.

## Agent quickstart

- [Claude Code](https://b2a.bluepillow.com/docs/agents/claude-code/): Add B2A as an MCP server to Claude Code in one command.
- [Cursor](https://b2a.bluepillow.com/docs/agents/cursor/): Wire B2A into Cursor via .cursor/mcp.json.
- [Windsurf](https://b2a.bluepillow.com/docs/agents/windsurf/): Connect B2A from Windsurf (Cascade) via mcp_config.json.
- [Devin](https://b2a.bluepillow.com/docs/agents/devin/): Add B2A to a Devin workspace via .devin/mcp.yaml.
- [ChatGPT Apps](https://b2a.bluepillow.com/docs/agents/chatgpt-apps/): Wire B2A into ChatGPT Apps via the OpenAPI manifest.
- [OpenAI Agents SDK](https://b2a.bluepillow.com/docs/agents/openai-agents-sdk/): Wrap B2A endpoints as Agents SDK function_tools.
- [LangChain](https://b2a.bluepillow.com/docs/agents/langchain/): Wrap B2A endpoints as LangChain @tool functions.
- [CrewAI](https://b2a.bluepillow.com/docs/agents/crewai/): Define B2A tools as CrewAI BaseTool subclasses.
- [Other stacks](https://b2a.bluepillow.com/docs/agents/others/): Generic recipe for any agent stack — REST endpoints + MCP server.