# trvl-mcp

AI travel agent MCP server. **1 smart `travel` MCP tool** — a natural-language router that advertises a single tool (~378 tokens of context) instead of a full per-domain tool list (~33,500 tokens): a **~98.9% smaller context footprint**. Covers flights, hotels, ground transport, price alerts, and more, dispatched by natural language. No personal API keys are required for default search.

Hotel trust rule: use `search_accommodations` for traveller-facing stay recommendations. Raw `search_hotels` prices are lead-in discovery prices. Before ranking a final trip cost or telling a user what to book, use criteria-matched room/apartment offers from `search_accommodations` or verify shortlisted hotels with room/detail/provider totals (`search_hotels_with_details`, `hotel_rooms`, or `trvl serpapi` when `SERPAPI_KEY` is configured). trvl provides booking handoff links; it does not book, hold, or guarantee hotel rates.

## Usage

```
npx trvl-mcp
```

## Claude Desktop

Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "trvl": {
      "command": "npx",
      "args": ["-y", "trvl-mcp"]
    }
  }
}
```

## What's included

- **1 smart `travel` MCP tool** — natural-language router; advertises one tool (~378 tokens) instead of a full per-domain list (~33,500), so your AI's context window stays lean. Older clients that call legacy per-domain tool names still work, reachable as legacy-compatible capabilities via the `intent` field (set `TRVL_MCP_TOOL_MODE=legacy` to advertise the full list for clients that require it).
- Default flight search (Google Flights, Kiwi, Skiplagged), with solo or opt-in AFKLM and low-cost-carrier integrations
- Criteria-first accommodation search plus hotel discovery (Google Hotels, Booking.com, Airbnb, Hostelworld, Trivago, HomeToGo) and verified room/detail flows for shortlisted candidates
- Ground transport (buses, trains, ferries — 22 providers)
- Destination intelligence (weather, safety, holidays, events)
- Trip planning and price alerts
- Travel hacks detection (36 detectors)

## License

PolyForm Noncommercial 1.0.0