getyourguide-mcp

通过 getyourguide-mcp 这一 MCP 服务器调用 GetYourGuide 合作伙伴 API，只读搜索和发现旅游团、活动与景点门票，支持按地点、分类、日期筛选，并提供行程详情、可预订选项、用户评价及连接健康检查；预订仍需在 GetYourGuide 侧完成。

chrischall

热度 80.30

最近更新 2026-10-18 00:15:39

分类：生活依赖：MCP 服务 / 第三方 API / 代码执行应用场景：旅行 / 推荐 / 研究

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add getyourguide-mcp

Metadata

name: getyourguide-mcp
description: This skill should be used when the user asks about GetYourGuide tours, activities, or attraction tickets. Triggers on phrases like "find tours on GetYourGuide", "things to do in Paris", "skip-the-line tickets", "GetYourGuide reviews", "book an activity", or any request involving searching tours, activities, day trips, or attraction tickets.

getyourguide-mcp

MCP server for GetYourGuide — read-only search and discovery of tours, activities, and attraction tickets via the GetYourGuide Partner API.

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

Setup

Add to .mcp.json in your project or ~/.claude/mcp.json:

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

Get an API key by joining the free partner program at partner.getyourguide.com. Optional env: GYG_CURRENCY (e.g. USD), GYG_LANGUAGE (e.g. en).

Tools

Tool	Use it to
`gyg_search_tours`	Find tours by free text / location / category / date range. Start here.
`gyg_get_tour`	Pull the full record once a tour is chosen
`gyg_get_tour_options`	See bookable options (ticket types, times) for a tour, optionally within dates
`gyg_get_tour_reviews`	Read customer reviews for a tour
`gyg_list_categories`	Discover category IDs to filter searches
`gyg_list_category_tours`	Browse tours in one category
`gyg_get_location`	Resolve a location ID (city / POI / region)
`gyg_list_location_tours`	Browse everything bookable at a location
`gyg_healthcheck()`	Is this connector working? Reports which credential resolved, whether api.getyourguide.com accepted it, and what to fix. Start here when another tool fails — an empty result can mean "no data" or "never authenticated", and this separates them.

Response shape

Every data tool takes view: "compact" | "full", and compact is the default — you get the slim response without asking for it. On the tour listings (gyg_search_tours, gyg_list_category_tours, gyg_list_location_tours) compact is a slim projection; everywhere else it strips image URLs and keeps every other field. Pass view: "full" for the whole GetYourGuide record.

(This replaced an opt-in compact: true flag. Passing compact now does nothing — zod drops the unknown key and you get the compact rung regardless, which is what the flag used to ask for.)

Usage notes

Everything is read-only — booking still happens on getyourguide.com (tour records include the url).
Results honor currency / language args (fall back to the env defaults).
If a response looks structurally off, the server has already logged a precise drift warning to stderr and returned the raw body — report the warning text upstream rather than working around it silently. gyg_search_tours and gyg_get_tour_options accept extraParams for raw query params if the API needs something the schema doesn't expose. It can't override the tool's own arguments: a colliding key (limit, currency, …) is ignored, so set those through the real arguments.
A 401/403 error means the key is wrong or its partner tier doesn't cover that endpoint — check the partner dashboard before assuming the key is dead.