# virail-mcp

An [MCP](https://modelcontextprotocol.io) server for [Virail](https://www.virail.com) transport search — trains, buses, flights, ferries, and carpooling across Europe and beyond. Gives any MCP-compatible AI agent (Claude Desktop, Cursor, Claude.ai, etc.) the ability to search real, live travel connections with real prices, schedules, and booking links.

## Hosted endpoint

Virail runs this server for you at:

```
https://virail.ai/mcp
```

No install, no API key — just point your MCP client at that URL. For clients that support remote MCP servers via a config file, the shape typically looks like:

```json
{
  "mcpServers": {
    "virail": {
      "url": "https://virail.ai/mcp"
    }
  }
}
```

The exact config key/format for adding a remote MCP server varies by client and changes over time — check your client's own docs for "remote MCP server" or "custom connector" setup if the snippet above doesn't match what it expects. Claude.ai / Claude Desktop, for instance, let you add one directly from Settings without editing a config file at all.

This HTTP endpoint is the only supported way to use virail-mcp right now — there's no local/CLI install.

Step-by-step setup for Claude.ai, Claude Desktop, Cursor, and other clients: **[virail.ai/mcp-setup](https://virail.ai/mcp-setup)**.

## Tools

### `search_transport`

Search for connections between two places on a date.

| Argument | Type | Required | Description |
|---|---|---|---|
| `departure` | string | yes | Origin city or station name |
| `arrival` | string | yes | Destination city or station name |
| `date` | string | yes | Travel date, `YYYY-MM-DD` |
| `adults` | number | no | Number of adult passengers (default `1`) |
| `tld` | string | no | Virail market, e.g. `com`, `it`, `fr`, `de`, `es` (default `com`) |
| `locale` | string | no | Response language, e.g. `en`, `it`, `fr` (default `en`) |
| `currency` | string | no | Price currency, e.g. `EUR`, `USD` (default `EUR`) |

Returns a list of trip options, each with departure/arrival times and stations, duration, number of transfers, total price, carrier(s), transport mode(s), and a booking link.

## Development

```bash
npm install
npm run build   # compile to dist/
npm test        # run unit tests
```

## License

MIT