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.
- Site
- bookeo.com
- Functions
- 7
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
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/bookeoOne MCP server for Bookeo and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth 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.
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
Name Type Required operatorstringA bookeo.com short name ("kayaktours") or a bookeo.com/<name> link.Yes Returns
BookeoOperatorinterface 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/findOperatorCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bookeo.findOperator({ operator: "foodtours" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bookeo.findOperator({"operator": "foodtours"}))curl -X POST https://api.bowmark.ai/v1/sites/bookeo/findOperator \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"operator":"foodtours"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required shortNamestringThe operator's short name, from findOperator.Yes productIdstringThe product's id, from listProducts.Yes Returns
BookeoAvailabilityinterface 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/getAvailabilityCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bookeo.getAvailability({ shortName: "foodtours", productId: "3619638" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bookeo.getAvailability({"shortName": "foodtours", "productId": "3619638"}))curl -X POST https://api.bowmark.ai/v1/sites/bookeo/getAvailability \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"shortName":"foodtours","productId":"3619638"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required shortNamestringThe operator's short name, from findOperator.Yes productIdstringThe 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
BookeoPriceQuoteinterface 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/getPriceQuoteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bookeo.getPriceQuote({ shortName: "<shortName>", productId: "<productId>", slot: {}, party: {} });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bookeo.getPriceQuote({ "shortName": "<shortName>", "productId": "<productId>", "slot": {}, "party": {} }))curl -X POST https://api.bowmark.ai/v1/sites/bookeo/getPriceQuote \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"shortName":"<shortName>","productId":"<productId>","slot":{},"party":{}}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required shortNamestringThe operator's short name, from findOperator.Yes productIdstringThe product's id, from listProducts.Yes Returns
BookeoProductInfointerface BookeoProductSection { label: string; text: string; } interface BookeoProductInfo { name: string; imageUrl: string | null; sections: BookeoProductSection[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bookeo/getProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bookeo.getProduct({ shortName: "kayaktours", productId: "4662367" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bookeo.getProduct({"shortName": "kayaktours", "productId": "4662367"}))curl -X POST https://api.bowmark.ai/v1/sites/bookeo/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"shortName":"kayaktours","productId":"4662367"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required shortNamestringThe 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/listGroupOperatorsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bookeo.listGroupOperators({ shortName: "boattours" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bookeo.listGroupOperators({"shortName": "boattours"}))curl -X POST https://api.bowmark.ai/v1/sites/bookeo/listGroupOperators \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"shortName":"boattours"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required shortNamestringThe operator's short name, from findOperator.Yes Returns
BookeoMyBookingsinterface 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/listMyBookingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bookeo.listMyBookings({ shortName: "escapehuntmelbourne" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bookeo.listMyBookings({"shortName": "escapehuntmelbourne"}))curl -X POST https://api.bowmark.ai/v1/sites/bookeo/listMyBookings \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"shortName":"escapehuntmelbourne"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required shortNamestringThe 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/listProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bookeo.listProducts({ shortName: "kayaktours" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bookeo.listProducts({"shortName": "kayaktours"}))curl -X POST https://api.bowmark.ai/v1/sites/bookeo/listProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"shortName":"kayaktours"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bookeo.listProducts({ shortName: "kayaktours" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/bookeo/<function> - OpenAPI
/v1/sites/bookeo/openapi.json