Getyourguide MCP server

getyourguide-mcp

MCP server for GetYourGuide — search tours and activities, read tour details, bookable options, and reviews via the GetYourGuide Partner API.

🤖 This project was developed and is maintained by AI (Claude Code).

Use at your own discretion.

• npm: npmjs.com/package/getyourguide-mcp
• Source: github.com/chrischall/getyourguide-mcp

Tools

All tools are read-only — this server registers no write tools.

view — response shape

The tools marked view above take view: "compact" | "full", and compact is the default. An efficiency that has to be asked for is one that usually is not, so it is not opt-in — the old compact: true flag on gygsearchtours is gone.

projection (tourid, title, abstract, url, price, overallrating, numberofratings, durations, categories, locations), flattened to { metadata, tours }. On gygget_tour — one record, no listing envelope to project — it instead strips image URLs and keeps everything else.

• compact — on the three tour LISTINGS it returns the documented slim

• full — GetYourGuide's whole validated record, untouched.

Reach for full when you need a field the projection does not carry (picture variants, coordinates, marketing copy). Every response is minified JSON either way: formatting whitespace is dropped, whitespace inside a value is not.

Setup

You need a GetYourGuide Partner API key — join the (free) partner program at partner.getyourguide.com and copy the API key from your dashboard. The key is sent as the X-ACCESS-TOKEN header on every request.

Claude Code / any MCP host

{
  "mcpServers": {
    "getyourguide": {
      "command": "npx",
      "args": ["-y", "getyourguide-mcp"],
      "env": {
        "GYG_API_KEY": "your-partner-api-key"
      }
    }
  }
}

The server also boots with no key set (so hosts can probe tools/list at install time); the first tool call then returns an actionable error telling you which env var to set.

Environment variables

For local development, put them in a .env next to the server (gitignored; see .env.example).

Behavior notes

Shortened. The full README is on GitHub.