Odybook MCP Server
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Odybook MCP Server Search for tours in Paris on 2025-06-15"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Odybook Model Context Protocol (MCP) Server
A professional-grade implementation of the Model Context Protocol (MCP) for Odybook, enabling AI assistants to interact directly with Odybook's experience management platform. This server acts as a secure proxy, providing AI tools for tour searching, availability verification, and booking management.
Overview
The Odybook MCP server allows AI models (like Claude and ChatGPT) to perform real-time operations on the Odybook platform. It implements the standard MCP Toolkit, ensuring compatibility with any MCP-compliant client.
Features
Experience Search: Discover tours and activities by location and date.
Real-time Availability: Verify slot capacity for specific dates and guest counts.
Booking Management: Create temporary booking holds for customers.
Secure Integration: Uses Odybook Partner API authentication.
Related MCP server: lastminutedeals-api
Prerequisites
Node.js 18.x or higher
An active Odybook Partner API Key
Odybook API URL (default:
https://odybook.com/api)
Installation
Clone the repository and navigate to the directory:
cd odybook-mcpInstall dependencies:
npm installBuild the project:
npm run build
Configuration
The server expects the following environment variables. You can define these in a .env file for development or pass them directly to the MCP client.
Variable | Description |
| (Optional) Your partner API key for protected routes like booking holds. |
| The Odybook API endpoint (default: |
Client Integration
Claude Desktop
Claude Desktop provides native support for MCP servers. To integrate Odybook:
Locate your Claude Desktop configuration file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Add the following to the
mcpServersobject:
{
"mcpServers": {
"odybook": {
"command": "node",
"args": ["/absolute/path/to/odybook-mcp/dist/index.js"],
"env": {
"ODYBOOK_API_KEY": "YOUR_API_KEY_HERE",
"ODYBOOK_API_URL": "https://odybook.com/api"
}
}
}
}Restart Claude Desktop.
ChatGPT (Custom GPTs)
To use Odybook with ChatGPT, you can use the Odybook backend as a Custom Action.
Open Specification: Use the provided OpenAPI spec at
specs/openapi.json.Create Action: In your Custom GPT configuration, under "Actions", click "Create new action".
Import Schema: Paste the content of
specs/openapi.json.Authentication: Select "API Key" as the authentication type and "Bearer" as the auth scheme. Paste your
ODYBOOK_API_KEY.Test: ChatGPT will now be able to call Odybook tools via the
/api/mcpbridge.
Marketplace Submission
This server is designed to meet the requirements for official MCP registries:
Safety Annotations: All tools include clear descriptions and follow security best practices.
Vendor Neutrality: Implements the standard Model Context Protocol without proprietary extensions.
Portability: Verified to run on macOS and Windows via Node.js.
Submission Links
Tool Reference
search_tours
Search for experiences by location and date.
Arguments:
location(string, optional): City or country name.date(string, optional): Target date inYYYY-MM-DDformat.
check_availability
Verify if an experience has enough capacity for a given date.
Arguments:
experience_id(string): UUID of the experience.date(string): Date inYYYY-MM-DDformat.time(string, optional): Specific time slot (e.g., "10:00").pax(number): Number of guests.
create_booking_hold
Initiate a temporary booking hold.
Arguments:
experience_id(string): UUID of the experience.date(string): Target date.time(string): Specific time slot (e.g., "14:00").pax(number): Number of guests.customer_name(string): Customer's full name.customer_email(string): Customer's email address.
Development
Run the server in development mode with automatic reloading:
npm run devSecurity
This server does not store any customer data. All requests are proxied directly to the Odybook backend. Ensure your ODYBOOK_API_KEY is kept secure and never committed to version control.
Available Tools
3 toolscheck_availabilityA
Verify real-time availability and retrieve detailed pricing for a specific experience. This tool is public and does not require an API key.
Inputs: pax (required), date (required), experience_id (required), time.
create_booking_holdB
Initialize a temporary booking hold. Reserves capacity for a limited time. This tool requires a valid ODYBOOK_API_KEY.
Inputs: pax (required), date (required), time (required), customer_name (required), +2 more.
search_toursA
Search for public tours and experiences by location and date. This tool is public and does not require an API key.
Inputs: date, location.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
search_tours finds experiences, check_availability retrieves pricing/availability for a specific one, and create_booking_hold reserves capacity. These form a clear sequential pipeline with no semantic overlap.
All three tools follow a consistent verb_noun snake_case pattern: search_, check_, create_. The naming style is uniform and predictable.
Three tools is a well-scoped minimal set covering the core pre-booking workflow. Each tool serves a distinct, necessary step and none are redundant.
The set covers search, availability, and booking hold but stops there. There are no tools to confirm, retrieve, or cancel a booking, leaving the booking lifecycle incomplete and agents unable to complete a booking.
Related MCP Connectors
Booking gateway for AI agents — discover events, movies & hotels, hand off to partner checkout.
Run hotels, apartments, job offers and real-estate listings in MyBooking.ai from your AI assistant.
Enables AI assistants to retrieve event data and execute event management operations in Nunify.
Live hotel search and booking for AI agents in DACH, the UK and 10 US cities.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to discover and search authentic Moroccan tourism experiences, cultural activities, and local operators through natural language queries with real-time data from verified sources.-
- AlicenseAqualityFmaintenanceReal-time last-minute tour and activity booking across 18 suppliers in 15 countries via the OCTO open standard. Search available slots, create Stripe checkout sessions, and check booking status.41MIT

mcp-travelcodeofficial
AlicenseNot gradedqualityCmaintenanceEnables AI assistants to search flights and hotels, manage bookings, check flight status, and access delay statistics through the TravelCode corporate travel API, all via natural language conversations.2MIT- FlicenseAqualityDmaintenanceEnables AI clients to search trips, find locations, and manage bookings through the Flowteller backend.9-