How to Use the GetYourGuide MCP in Claude Code

Q: Can I use Claude Code to find GetYourGuide activities and pipe them to another program?

Absolutely. You can run a command like claude mcp call getyourguide-mcp searchtravelactivities --params '{"query": "food tour in Rome"}' jq to get the raw JSON output and process it with any other CLI tool.

Q: How would I script a booking with GetYourGuide using Claude Code?

You'd write a shell script that first calls checkactivityavailability with your desired activity and date. If the script gets a successful response, it then calls createtravelbooking with the necessary parameters. It's a two-step script.

Q: Is it possible to manage my existing GetYourGuide bookings from the terminal with Claude Code?

Yes. You can use the getbookingstatus tool to check on a booking's details or the canceltravelbooking tool if you need to cancel. Both are simple, one-shot commands.

Automate travel reports, run booking scripts, and monitor tour availability straight from your terminal with Claude Code and GetYourGuide.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect GetYourGuide MCP to Claude Code

Create your Vinkius account to connect GetYourGuide to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup GetYourGuide with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Headless Search and Reporting

This setup is built for the command line. You can create shell scripts to monitor travel options without ever opening a browser. For example, run a cron job that uses `search_travel_activities` to check for new weekend trips from your city and emails you the results. You can pipe the output of one command into another. Use `list_travel_destinations` to get a list of cities, then pipe that to a script that calls `search_by_destination` for each one to build a full catalog.

Scripted and Automated Booking

Use this MCP server to build command-line tools for booking. You could write a simple script that takes an activity ID and a date, runs `check_activity_availability`, and if slots are open, uses `create_travel_booking` to reserve it. This is perfect for automated environments. It's a no-frills, headless way to interact with the GetYourGuide platform, designed for developers who live in the terminal.

Integrate with CI/CD Pipelines

Because it's all command-line, you can integrate these tools directly into your CI/CD pipelines. Add a step to your GitHub Actions workflow that uses `verify_api_connection` as a health check for your production travel app. You can also build monitoring services. Have a scheduled job that runs `get_booking_status` for all corporate bookings and sends a Slack alert if any are marked as 'cancelled' or 'pending' for too long.

Setup guide

Set up GetYourGuide MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see getyourguide-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest GetYourGuide transactions." It will automatically discover and invoke the available GetYourGuide tools.

Terminal

claude mcp add --transport http getyourguide-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the GetYourGuide MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "getyourguide-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by GetYourGuide. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect GetYourGuide now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about GetYourGuide MCP in Claude Code

Absolutely. You can run a command like `claude mcp call getyourguide-mcp search_travel_activities --params '{"query": "food tour in Rome"}' | jq` to get the raw JSON output and process it with any other CLI tool.

You'd write a shell script that first calls `check_activity_availability` with your desired activity and date. If the script gets a successful response, it then calls `create_travel_booking` with the necessary parameters. It's a two-step script.

Yes. You can use the `get_booking_status` tool to check on a booking's details or the `cancel_travel_booking` tool if you need to cancel. Both are simple, one-shot commands.

Your Vinkius endpoint token handles it. When you set up the server with `claude mcp add`, that token is stored securely. Every subsequent call from your scripts uses that token to authenticate with the MCP server, so you don't need to pass credentials in plain text.

The server only handles the data needed for the task, like activity names, destinations, and booking confirmation codes. It's designed for automation, so the ephemeral Vinkius environment ensures no sensitive booking or personal data persists on the runner after your script finishes.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript