trvl — Claude Code MCP server: plan the whole trip, door to door
Searches flights, hotels and ground transport, merges the sources and hands back one route with the savings spelled out.
claude mcp add --env TRVL_MCP_TOKEN=<TRVL_MCP_TOKEN> --env TRVL_MCP_READ_TOKEN=<TRVL_MCP_READ_TOKEN> --env TRVL_MCP_WRITE_TOKEN=<TRVL_MCP_WRITE_TOKEN> --env TRVL_MCP_OAUTH_INTROSPECTION_URL=<TRVL_MCP_OAUTH_INTROSPECTION_URL> --env TRVL_MCP_OAUTH_CLIENT_ID=<TRVL_MCP_OAUTH_CLIENT_ID> --transport stdio trvl -- npx -y trvl-mcpWhat trvl does
trvl is a single binary running locally. Your AI client talks to it over MCP, and the server queries flight, lodging, rail and weather providers on its own, then removes duplicates and picks the cheaper option. No personal API key is needed for the default search; paid providers turn on only when you supply credentials.
The client sees one travel router tool, which takes a plain-language request and decides what to look up. Older clients calling individual tool names keep working too. There is also a set of detectors for shifting dates, mixing carriers across legs, hidden-city segments and award fares.
Some providers sit behind bot protection and may piggyback on a browser session you already have open, so read that part before installing. Search requests reach the providers the same way they would from any booking site, while whatever the server stores stays on your disk. A released build also sends one daily heartbeat to https://telemetry.revaluator.ai/v1/heartbeat; TRVL_TELEMETRY_ENDPOINT points it elsewhere and the ping can be turned off.
What it helps with
- compare a flight and a train on the same route
- build one itinerary from flight, hotel and transfer
- find a cheaper fare by moving the dates
- check whether a price hides a hidden-city segment
- keep price-drop alerts running for a route
Example prompts for the agent
- Find a weekend trip under 300 euros from Helsinki, with a hotel and a transfer
- Compare train and plane to Berlin next weekend
- Alert me if the fare to Dubrovnik drops
How to install trvl
Platform CLI
claude mcp add --env TRVL_MCP_TOKEN=<TRVL_MCP_TOKEN> --env TRVL_MCP_READ_TOKEN=<TRVL_MCP_READ_TOKEN> --env TRVL_MCP_WRITE_TOKEN=<TRVL_MCP_WRITE_TOKEN> --env TRVL_MCP_OAUTH_INTROSPECTION_URL=<TRVL_MCP_OAUTH_INTROSPECTION_URL> --env TRVL_MCP_OAUTH_CLIENT_ID=<TRVL_MCP_OAUTH_CLIENT_ID> --transport stdio trvl -- npx -y trvl-mcpReplace <…> with your own values. 17 more environment variables are in the server README
Platform CLI
codex mcp add trvl --env TRVL_MCP_TOKEN=<TRVL_MCP_TOKEN> --env TRVL_MCP_READ_TOKEN=<TRVL_MCP_READ_TOKEN> --env TRVL_MCP_WRITE_TOKEN=<TRVL_MCP_WRITE_TOKEN> --env TRVL_MCP_OAUTH_INTROSPECTION_URL=<TRVL_MCP_OAUTH_INTROSPECTION_URL> --env TRVL_MCP_OAUTH_CLIENT_ID=<TRVL_MCP_OAUTH_CLIENT_ID> -- npx -y trvl-mcpReplace <…> with your own values. 17 more environment variables are in the server README
Config file
{
"mcpServers": {
"trvl": {
"command": "npx",
"args": [
"-y",
"trvl-mcp"
],
"env": {
"TRVL_MCP_TOKEN": "<TRVL_MCP_TOKEN>",
"TRVL_MCP_READ_TOKEN": "<TRVL_MCP_READ_TOKEN>",
"TRVL_MCP_WRITE_TOKEN": "<TRVL_MCP_WRITE_TOKEN>",
"TRVL_MCP_OAUTH_INTROSPECTION_URL": "<TRVL_MCP_OAUTH_INTROSPECTION_URL>",
"TRVL_MCP_OAUTH_CLIENT_ID": "<TRVL_MCP_OAUTH_CLIENT_ID>"
}
}
}
}Replace <…> with your own values. 17 more environment variables are in the server README
Config file
{
"servers": {
"trvl": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"trvl-mcp"
],
"env": {
"TRVL_MCP_TOKEN": "<TRVL_MCP_TOKEN>",
"TRVL_MCP_READ_TOKEN": "<TRVL_MCP_READ_TOKEN>",
"TRVL_MCP_WRITE_TOKEN": "<TRVL_MCP_WRITE_TOKEN>",
"TRVL_MCP_OAUTH_INTROSPECTION_URL": "<TRVL_MCP_OAUTH_INTROSPECTION_URL>",
"TRVL_MCP_OAUTH_CLIENT_ID": "<TRVL_MCP_OAUTH_CLIENT_ID>"
}
}
}
}Replace <…> with your own values. 17 more environment variables are in the server README
Platform CLI
gemini mcp add -e TRVL_MCP_TOKEN=<TRVL_MCP_TOKEN> -e TRVL_MCP_READ_TOKEN=<TRVL_MCP_READ_TOKEN> -e TRVL_MCP_WRITE_TOKEN=<TRVL_MCP_WRITE_TOKEN> -e TRVL_MCP_OAUTH_INTROSPECTION_URL=<TRVL_MCP_OAUTH_INTROSPECTION_URL> -e TRVL_MCP_OAUTH_CLIENT_ID=<TRVL_MCP_OAUTH_CLIENT_ID> trvl npx -y trvl-mcpReplace <…> with your own values. 17 more environment variables are in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about trvl
How do I install trvl in Claude Code?
Run `claude mcp add --env TRVL_MCP_TOKEN=<TRVL_MCP_TOKEN> --env TRVL_MCP_READ_TOKEN=<TRVL_MCP_READ_TOKEN> --env TRVL_MCP_WRITE_TOKEN=<TRVL_MCP_WRITE_TOKEN> --env TRVL_MCP_OAUTH_INTROSPECTION_URL=<TRVL_MCP_OAUTH_INTROSPECTION_URL> --env TRVL_MCP_OAUTH_CLIENT_ID=<TRVL_MCP_OAUTH_CLIENT_ID> --transport stdio trvl -- npx -y trvl-mcp`.
What does trvl do?
It plans a full trip across modes: flight, hotel, train, bus, ferry and car. Results from several sources are merged into one answer with a price per leg.
Do I need API keys to search?
Not for the default search. Providers that require auth switch on when you pass their credentials.
