Quickstart

One install line, one call. No key needed to start.

1. Install

Claude Code

claude mcp add --transport http travel https://mcp.travel-gateway.codeblocks.sk/mcp

Cursor — ~/.cursor/mcp.json

{
  "mcpServers": {
    "travel": {
      "url": "https://mcp.travel-gateway.codeblocks.sk/mcp"
    }
  }
}

VS Code — .vscode/mcp.json

{
  "servers": {
    "travel": {
      "type": "http",
      "url": "https://mcp.travel-gateway.codeblocks.sk/mcp"
    }
  }
}

Hermes — config.yaml

mcp_servers:
  travel:
    url: https://mcp.travel-gateway.codeblocks.sk/mcp

ChatGPT

Add https://mcp.travel-gateway.codeblocks.sk/mcp as an MCP server in developer mode. No authentication needed to start.

Claude Desktop

Claude Desktop takes remote servers through custom connectors, which expect OAuth. Until that is in place, bridge it over stdio:
npx mcp-remote https://mcp.travel-gateway.codeblocks.sk/mcp --header "Authorization: Bearer $TRAVEL_API_KEY"

2. Optional: a key

Anonymous calls are limited to a modest number per minute per address, and their references belong to nobody. A free key gives you your own limit and receipts: every quote your agent produced and what became of it.

Get a key

With a key, add the header to any of the configs above:

claude mcp add --transport http travel https://mcp.travel-gateway.codeblocks.sk/mcp --header "Authorization: Bearer $TRAVEL_API_KEY"

3. Call something

curl -N -X POST https://mcp.travel-gateway.codeblocks.sk/mcp \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

The reply is a server-sent event stream, so each message arrives on a data: line rather than as one JSON document. That is normal, and a real client unwraps it for you. Piping this straight into a JSON parser will not work.

Sending MCP-Protocol-Version: 2026-07-28 by hand commits you to the stateless protocol, which requires a _meta envelope on every request. Omit the header for a hand-written curl and the server answers on the older revision instead. Use a real client and this never comes up.

No MCP client? The job router answers over plain HTTP:

curl -X POST https://mcp.travel-gateway.codeblocks.sk/job \
  -H "content-type: application/json" \
  -d '{"job":"22 people from Bratislava to Paris in November"}'

Rules worth knowing

Show the traveller the reference. Every quote carries one. It is how their booking gets connected back to the quote your agent found. If you hide it, attribution breaks and so does your reporting.

Nothing books. Every quote ends in a handoff the person acts on. For group airfare that is a message to a human desk, not a link.

Tools that return a handoff

Tool	Handoff
`egf_prepare_group_quote`	whatsapp

Machine-readable

server.json · llms.txt · openapi.json · .well-known/mcp.json · install.json · tools.json · evals.json