Skip to main content
Glama
Odybook MCP Server

Odybook MCP Server

Official
by Odybook

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

  1. Clone the repository and navigate to the directory:

    cd odybook-mcp
  2. Install dependencies:

    npm install
  3. Build 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

ODYBOOK_API_KEY

(Optional) Your partner API key for protected routes like booking holds.

ODYBOOK_API_URL

The Odybook API endpoint (default: https://odybook.com/api).

Client Integration

Claude Desktop

Claude Desktop provides native support for MCP servers. To integrate Odybook:

  1. Locate your Claude Desktop configuration file:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  2. Add the following to the mcpServers object:

{
  "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"
      }
    }
  }
}
  1. Restart Claude Desktop.

ChatGPT (Custom GPTs)

To use Odybook with ChatGPT, you can use the Odybook backend as a Custom Action.

  1. Open Specification: Use the provided OpenAPI spec at specs/openapi.json.

  2. Create Action: In your Custom GPT configuration, under "Actions", click "Create new action".

  3. Import Schema: Paste the content of specs/openapi.json.

  4. Authentication: Select "API Key" as the authentication type and "Bearer" as the auth scheme. Paste your ODYBOOK_API_KEY.

  5. Test: ChatGPT will now be able to call Odybook tools via the /api/mcp bridge.

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.

Tool Reference

search_tours

Search for experiences by location and date.

  • Arguments:

    • location (string, optional): City or country name.

    • date (string, optional): Target date in YYYY-MM-DD format.

check_availability

Verify if an experience has enough capacity for a given date.

  • Arguments:

    • experience_id (string): UUID of the experience.

    • date (string): Date in YYYY-MM-DD format.

    • 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 dev

Security

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 tools
check_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

    A3.8/5.0

    Scored across 3 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    All three tools follow a consistent verb_noun snake_case pattern: search_, check_, create_. The naming style is uniform and predictable.

    Tool Count5/5

    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.

    Completeness2/5

    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

    Related MCP Servers