Xola MCP server for AI agents
Let Claude, ChatGPT or your own agent read Xola: 6 typed functions through one MCP server. No Xola API key needed.
- Site
- xola.com
- Functions
- 6
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Xola 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/xolaOne MCP server for Xola 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
Open a function to see its arguments, what it returns and how to call it.
findSellerFinds the Xola seller (the tour operator) behind an operator's own website or a checkout.xola.com link and returns its seller id, name, location and…Arguments
Name Type Required sitestringAn operator's own booking page url, a checkout.xola.app/checkout.xola.com link, or a bare seller id.Yes Returns
XolaFindSellerResultinterface XolaSeller { id: string; name: string; currency: string | null; website: string | null; city: string | null; country: string | null; countryCode: string | null; phone: string | null; email: string | null; } interface XolaFindSellerResult { seller: XolaSeller; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/xola/findSellerCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.xola.findSeller({ site: "<site>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.xola.findSeller({"site": "<site>"}))curl -X POST https://api.bowmark.ai/v1/sites/xola/findSeller \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"site":"<site>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.xola.findSeller({ site: "<site>" });getAvailabilityAn experience's open sessions over roughly the next 30 days -- each date and start time with seats left -- plus the per-person price each demographic…Arguments
Name Type Required experienceIdstringThe experience id listExperiences returns.Yes Returns
XolaAvailabilityinterface XolaSession { /** "YYYY-MM-DD". */ date: string; /** Xola's own "HHMM" string, e.g. "1000". */ time: string; seatsLeft: number; } interface XolaDemographicPrice { demographicId: string; label: string; /** Per-person price before add-ons, tax or fees. Null if the experience's * base price scheme could not be read. */ price: number | null; } interface XolaAvailability { experienceId: string; /** Roughly the next 30 days, Xola's own window, not a date range we pass. */ sessions: XolaSession[]; pricing: XolaDemographicPrice[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/xola/getAvailabilityCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.xola.getAvailability({ experienceId: "5ebedc0f2291e101d549b673" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.xola.getAvailability({"experienceId": "5ebedc0f2291e101d549b673"}))curl -X POST https://api.bowmark.ai/v1/sites/xola/getAvailability \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"experienceId":"5ebedc0f2291e101d549b673"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.xola.getAvailability({ experienceId: "5ebedc0f2291e101d549b673" });getExperienceReturns one experience's full listing: description, what is included, duration, meeting point, price schemes and demographics (Adult, Child...) with…Arguments
Name Type Required experienceIdstringThe experience id listExperiences returns.Yes Returns
XolaExperienceDetailinterface XolaExperience { id: string; sellerId: string; name: string; excerpt: string | null; photoUrl: string | null; durationMinutes: number | null; priceFrom: number | null; currency: string | null; } interface XolaExperienceDetail extends XolaExperience { description: string | null; meetingLocationName: string | null; meetingAddress: string | null; included: string[]; notIncluded: string[]; cancellationPolicy: string | null; imageUrls: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/xola/getExperienceCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.xola.getExperience({ experienceId: "5ebedc0f2291e101d549b673" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.xola.getExperience({"experienceId": "5ebedc0f2291e101d549b673"}))curl -X POST https://api.bowmark.ai/v1/sites/xola/getExperience \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"experienceId":"5ebedc0f2291e101d549b673"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.xola.getExperience({ experienceId: "5ebedc0f2291e101d549b673" });getPriceQuotePrices a party (how many of each demographic) for one session the way Xola Checkout does before payment -- ticket lines, taxes and fees, the total…Arguments
Name Type Required experienceIdstringYes datestring"YYYY-MM-DD", from getAvailability().sessions[].date.Yes timestringSession start, from getAvailability().sessions[].time, e.g. "1000".Yes party{ demographicId: string; quantity: number }[]How many of each demographic.Yes Returns
XolaPriceQuoteinterface XolaQuoteLine { /** "demographic" for tickets; "partner_fee", "tax", "fee"... for the rest. */ type: string; name: string; quantity: number | null; unitPrice: number | null; amount: number; } interface XolaPriceQuote { experienceId: string; sellerId: string; date: string; time: string; currency: string; lines: XolaQuoteLine[]; /** What checkout would charge, taxes and fees included. */ total: number; dueNow: number | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/xola/getPriceQuoteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.xola.getPriceQuote({ experienceId: "<experienceId>", date: "<date>", time: "<time>", party: {} });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.xola.getPriceQuote({ "experienceId": "<experienceId>", "date": "<date>", "time": "<time>", "party": {} }))curl -X POST https://api.bowmark.ai/v1/sites/xola/getPriceQuote \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"experienceId":"<experienceId>","date":"<date>","time":"<time>","party":{}}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.xola.getPriceQuote({ experienceId: "<experienceId>", date: "<date>", time: "<time>", party: {} });listExperiencesLists one seller's bookable experiences -- id, name, short description, duration, price from, currency, photo, and location.Arguments
Name Type Required sellerIdstringThe seller id findSeller returns.Yes Returns
XolaListExperiencesResultinterface XolaExperience { id: string; sellerId: string; name: string; excerpt: string | null; photoUrl: string | null; durationMinutes: number | null; priceFrom: number | null; currency: string | null; } interface XolaListExperiencesResult { sellerId: string; experiences: XolaExperience[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/xola/listExperiencesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.xola.listExperiences({ sellerId: "5ebec194cd624c639c5303a7" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.xola.listExperiences({"sellerId": "5ebec194cd624c639c5303a7"}))curl -X POST https://api.bowmark.ai/v1/sites/xola/listExperiences \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"sellerId":"5ebec194cd624c639c5303a7"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.xola.listExperiences({ sellerId: "5ebec194cd624c639c5303a7" });listWaiversReturns the waiver a seller asks travelers to sign for one experience: its template id, the signable waiver page link, and whether every guest must…Arguments
Name Type Required experienceIdstringThe experience id listExperiences returns.Yes Returns
XolaWaiversinterface XolaWaiver { /** Xola's waiver template id, read off the template url. */ templateId: string | null; /** The signable waiver page Xola Checkout links a traveler to. */ url: string; } interface XolaWaivers { experienceId: string; sellerId: string; /** Empty when the seller asks no waiver for this experience. */ waivers: XolaWaiver[]; /** The seller wants each guest named, not only the lead traveler. */ requiresGuestNames: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/xola/listWaiversCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.xola.listWaivers({ experienceId: "5ebedc0f2291e101d549b673" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.xola.listWaivers({"experienceId": "5ebedc0f2291e101d549b673"}))curl -X POST https://api.bowmark.ai/v1/sites/xola/listWaivers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"experienceId":"5ebedc0f2291e101d549b673"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.xola.listWaivers({ experienceId: "5ebedc0f2291e101d549b673" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/xola/<function> - OpenAPI
/v1/sites/xola/openapi.json