io.github.chrischall由 GitHub 帳號 chrischall 發布v2.2.0更新於 Nov 7, 2026
GetYourGuide tours & activities for Claude — search, details, options, and reviews
GetYourGuide 唯讀 MCP 伺服器：讓助理透過合作夥伴 API 搜尋旅遊與活動，查看選項、可預訂日期與評價。
Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。
參照 儲存庫 中的啟動說明。
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.
All tools are read-only — this server registers no write tools.
view — response shapeEvery data tool takes 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 gyg_search_tours is gone.
compact — on the three tour LISTINGS it returns the documented slim
projection (tour_id, title, abstract, url, price, overall_rating,
number_of_ratings, durations, categories, locations), flattened to
{ _metadata, tours }. On gyg_get_tour — one record, no listing envelope to
project — and on every other tool (options, availability, reviews,
categories, location) — it instead strips image URLs and keeps everything else.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.
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.
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.
For local development, put them in a .env next to the server (gitignored;
see .env.example).
429/503 honoring Retry-After
(capped at 10s). If it still fails, the error tells you to back off.GYG_REQUEST_TIMEOUT_MS, or never reaches the API (DNS, refused, reset),
comes back as a tool error naming the request path, with a hint to raise
the timeout or check GYG_BASE_URL and your network. Cancelling a call is
not wrapped — it stays a cancellation.currency: "" or
language: "") is dropped rather than sent, so the env default / USD /
en fallback applies instead of the API rejecting a blank value.401/403 names both possible causes — a wrong key, or
a key whose partner tier doesn't cover that endpoint.docs/GETYOURGUIDE-API.md — routes and request shapes
are live-verified against the API and its official OpenAPI spec; real 200
bodies still need pinning from a keyed capture.extraParams: gyg_search_tours and gyg_get_tour_options accept
extraParams to pass raw query params the schema doesn't model. A key that
collides with one of the tool's own arguments (limit, offset,
currency, cnt_language, q, …) is ignored — the typed argument, or
its default, always wins. (Before 2.1.6 extraParams overrode them.)Releases are automated with release-please; don't hand-bump versions. PR
titles must be conventional commits (feat:, fix:, …) because the repo
squash-merges.
MIT
來源：README.md，提交 1635bc6
Search GetYourGuide tours and activities. Filter by free text (or "iata:<code>" for airports), location ID, category ID, and date range; sort by popularity, price, or rating. Returns slim summaries by default; pass view:"full" for the whole records.
qviewlimitdateTooffsetcurrencydateFromlanguagesortFieldcategoryIdlocationIdextraParams另有 1 個Get the full GetYourGuide record for one tour/activity by its numeric ID. Image URLs are stripped by default; pass view:"full" to keep them.
viewtourId必填currencylanguageList the bookable options of a tour (ticket types, times, languages offered), optionally within a date range. Image URLs are stripped by default; pass view:"full" to keep them.
viewlimitdateTotourId必填currencydateFromlanguageextraParamsGet booking availability for a tour: bookable participant categories, addons, and the list of available dates (with participant ranges). Lighter than gyg_get_tour_options when you only need "when can I go". Image URLs are stripped by default; pass view:"full" to keep them.
viewtourId必填languageList customer reviews for a tour (rating outline plus individual review items). Image URLs are stripped by default; pass view:"full" to keep them.
viewlimitoffsettourId必填currencylanguagesortFieldsortDirectionList GetYourGuide activity categories (use the IDs to filter tour searches). Image URLs are stripped by default; pass view:"full" to keep them.
viewlimitoffsetlanguageList tours in one GetYourGuide category.
viewlimitoffsetcurrencylanguagecategoryId必填Get details for a GetYourGuide location (city, POI, or region) by its numeric ID. Image URLs are stripped by default; pass view:"full" to keep them.
viewlanguagelocationId必填List tours available at one GetYourGuide location (city, POI, or region).
viewlimitoffsetcurrencylanguagelocationId必填Verify credentials and upstream reachability
Resolves the credential the way real tools do, then makes one authenticated request to api.getyourguide.com. Reports which source supplied the credential, whether api.getyourguide.com accepted it, the round-trip time, and a plain-English hint distinguishing 'no credential' from 'credential rejected' from 'a api.getyourguide.com-side problem'. Read-only; never returns the credential itself. Call this when a real tool fails and you want to know which hop broke.
無需輸入參數。
已滿足適用檢查項的 90%
該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。
請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。
{ "mcpServers": { "getyourguide": { "command": "npx", "args": ["-y", "getyourguide-mcp"], "env": { "GYG_API_KEY": "your-partner-api-key" } } }}npm installnpm run build # tsc + esbuild bundle → dist/npm test # tsc typecheck + vitest (no network — everything mocked)npm run test:coverage # tsc typecheck + the CI gate: 100% lines/branches/functions/statements