# Voyagier

Wires your agent into Voyagier so it can search flights, hotels and activities, price a trip and book it from the terminal.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: Voyagier-Travel
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Voyagier-Travel/voyagier-cli
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/voyagier

## What it does

Voyagier is an MCP server for booking actual travel. Each tool the server publishes becomes its own CLI command, `voyagier <tool_name> --<param> <value>`, assembled at runtime from the live tool list. Add a tool on the server side and it shows up in your terminal without a package upgrade.

A trip is built as a goal graph. You create a plan with dates, destination and travellers, run a flight or hotel search, attach the finished search to a goal on that plan, then pick from the returned options. Searches run asynchronously, so you poll the status until it reaches a terminal state. Booking is price-gated: `book_plan` takes an expected total in cents, and the reservation only goes through if it matches the quote.

You need a Voyagier token. `voyagier auth login` opens a browser flow and keeps the token out of your shell history. Where installs are blocked — a sandboxed agent or CI — every command still runs through `npx` with `VOYAGIER_TOKEN` set. The tool list is cached in `~/.voyagier/tools-cache.json` for 24 hours; `voyagier doctor` refreshes it and reports the connection state.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `VOYAGIER_TOKEN`, `VOYAGIER_API_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env VOYAGIER_TOKEN=<VOYAGIER_TOKEN> --env VOYAGIER_API_URL=<VOYAGIER_API_URL> --transport stdio voyagier -- npx -y @voyagier/cli
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add voyagier --env VOYAGIER_TOKEN=<VOYAGIER_TOKEN> --env VOYAGIER_API_URL=<VOYAGIER_API_URL> -- npx -y @voyagier/cli
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "voyagier": {
            "command": "npx",
            "args": [
                "-y",
                "@voyagier/cli"
            ],
            "env": {
                "VOYAGIER_TOKEN": "<VOYAGIER_TOKEN>",
                "VOYAGIER_API_URL": "<VOYAGIER_API_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "voyagier": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@voyagier/cli"
            ],
            "env": {
                "VOYAGIER_TOKEN": "<VOYAGIER_TOKEN>",
                "VOYAGIER_API_URL": "<VOYAGIER_API_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e VOYAGIER_TOKEN=<VOYAGIER_TOKEN> -e VOYAGIER_API_URL=<VOYAGIER_API_URL> voyagier npx -y @voyagier/cli
```
Replace <…> with your own values

## When to use it
- search flights for a route and date, then attach the result to a trip goal
- compare hotel options and their prices
- create a client record and scaffold a plan with the travelling party
- pull a plan quote and book at that exact price
- find the right tool for a task with `search_tools`

## Example prompts
- Search flights from BWI to LIS on 2026-11-20 and show me the options
- Create a plan for Lisbon from 2026-11-20 to 2026-11-27 for one adult
- Book the plan at the current quote

## Similar
- [pp-booking-com](https://affpapa.org/en/nevibecode/skills/pp-booking-com.md) — skill · 458 installs
- [Tripyana London Chauffeur](https://affpapa.org/en/nevibecode/mcp/tripyana-london-chauffeur.md) — MCP server
- [flightclaw](https://affpapa.org/en/nevibecode/skills/flightclaw.md) — skill · 1100 installs
- [hotelbooking-ai](https://affpapa.org/en/nevibecode/mcp/hotelbooking-ai.md) — MCP server · ★ 86
- [hotelbooking](https://affpapa.org/en/nevibecode/mcp/hotelbooking.md) — MCP server · ★ 51
- [Ourway – Camino de Santiago](https://affpapa.org/en/nevibecode/mcp/ourway-camino-de-santiago.md) — MCP server

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md