Bookeo MCP server for AI agents

Let Claude, ChatGPT or your own agent read Bookeo: 7 typed functions through one MCP server. No Bookeo API key needed.

Functions
7
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Bookeo

An MCP server for Bookeo alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/bookeo
Every site

One MCP server for Bookeo and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 7
  • findOperatorFinds a Bookeo operator from what a caller actually holds -- its bookeo.com short name ("kayaktours") or a bookeo.com/<name> link -- and returns the…

    Arguments

    NameTypeRequired
    operatorstring
    A bookeo.com short name ("kayaktours") or a bookeo.com/<name> link.
    Yes

    Returns BookeoOperator

    interface BookeoOperator {
      shortName: string;
      accountId: string | null;
      name: string | null;
      email: string | null;
      website: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bookeo/findOperator

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bookeo.findOperator({ operator: "foodtours" });
  • getAvailabilityReturns a fixed/recurring-schedule product's bookable days and time slots over the site's own near-term window: start/end time, seats free, price…

    Arguments

    NameTypeRequired
    shortNamestring
    The operator's short name, from findOperator.
    Yes
    productIdstring
    The product's id, from listProducts.
    Yes

    Returns BookeoAvailability

    interface BookeoAvailabilitySlot {
      /** The id getPriceQuote/bookSlot will need to price and book this slot. */
      eventScheduleId: number;
      /** ISO, no offset -- the operator's own local time, as the site renders it. */
      start: string;
      stop: string;
      freeSeats: number;
      price: number | null;
      currency: string | null;
      available: boolean;
      tooLateToBook: boolean;
      waitable: boolean;
      cancelled: boolean;
    }
    
    interface BookeoAvailabilityDay {
      /** ISO calendar date, YYYY-MM-DD. */
      date: string;
      slots: BookeoAvailabilitySlot[];
    }
    
    interface BookeoAvailability {
      productId: string;
      days: BookeoAvailabilityDay[];
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bookeo/getAvailability

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bookeo.getAvailability({ shortName: "foodtours", productId: "3619638" });
  • getPriceQuotePrices a party of adults for one slot from getAvailability, returning the sellable participant categories and their limits plus the priced total.

    Arguments

    NameTypeRequired
    shortNamestring
    The operator's short name, from findOperator.
    Yes
    productIdstring
    The product's id, from listProducts.
    Yes
    slot{ eventScheduleId: number; start: string; stop: string }
    The slot to price -- eventScheduleId, start and stop straight off one of getAvailability's own days[].slots[].
    Yes
    party{ adults: number }
    Party size. Only adults is priced today; a product selling child or infant tickets throws naming the gap.
    Yes

    Returns BookeoPriceQuote

    interface BookeoPriceQuoteCategory {
      name: "adults" | "children" | "infants";
      min: number;
      max: number;
    }
    
    interface BookeoPriceQuote {
      productId: string;
      eventScheduleId: number;
      categories: BookeoPriceQuoteCategory[];
      total: number;
      currency: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bookeo/getPriceQuote

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bookeo.getPriceQuote({
      shortName: "<shortName>",
      productId: "<productId>",
      slot: {},
      party: {}
    });
  • getProductReturns one product's full info page: its title, main image, and every tab of free text the operator filled in (General, Itinerary, What to bring…

    Arguments

    NameTypeRequired
    shortNamestring
    The operator's short name, from findOperator.
    Yes
    productIdstring
    The product's id, from listProducts.
    Yes

    Returns BookeoProductInfo

    interface BookeoProductSection {
      label: string;
      text: string;
    }
    
    interface BookeoProductInfo {
      name: string;
      imageUrl: string | null;
      sections: BookeoProductSection[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bookeo/getProduct

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bookeo.getProduct({ shortName: "kayaktours", productId: "4662367" });
  • listGroupOperatorsLists the operators under a Bookeo multi-operator portal (one short name fronting several businesses) with each one's name and the short name to pass…

    Arguments

    NameTypeRequired
    shortNamestring
    The group portal's own short name, from findOperator (e.g. "boattours").
    Yes

    Returns BookeoGroupOperator[]

    interface BookeoGroupOperator {
      /** Pass this to listProducts/getAvailability etc, not the portal's own short name. */
      shortName: string;
      name: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bookeo/listGroupOperators

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bookeo.listGroupOperators({ shortName: "boattours" });
  • listMyBookingsLists the signed-in caller's bookings with one operator from that operator's Bookeo customer area, each with its public booking id and the operator's…

    Arguments

    NameTypeRequired
    shortNamestring
    The operator's short name, from findOperator.
    Yes

    Returns BookeoMyBookings

    interface BookeoMyBooking {
      publicId: string;
      /** The operator's own printable booking page for this booking. */
      printUrl: string;
    }
    
    interface BookeoMyBookings {
      shortName: string;
      bookings: BookeoMyBooking[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bookeo/listMyBookings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bookeo.listMyBookings({ shortName: "escapehuntmelbourne" });
  • listProductsLists an operator's bookable products (tours, activities, classes, rentals): product id, name, duration, image and whether a membership is required.

    Arguments

    NameTypeRequired
    shortNamestring
    The operator's short name, from findOperator.
    Yes

    Returns BookeoProduct[]

    interface BookeoProduct {
      id: string;
      name: string;
      durationText: string | null;
      imageUrl: string | null;
      membershipRequired: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/bookeo/listProducts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.bookeo.listProducts({ shortName: "kayaktours" });

Use it from code