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.

Functions
6
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just Xola

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/xola
Every site

One MCP server for Xola 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

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

Read 6
  • 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

    NameTypeRequired
    sitestring
    An operator's own booking page url, a checkout.xola.app/checkout.xola.com link, or a bare seller id.
    Yes

    Returns XolaFindSellerResult

    interface 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/findSeller

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    experienceIdstring
    The experience id listExperiences returns.
    Yes

    Returns XolaAvailability

    interface 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/getAvailability

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    experienceIdstring
    The experience id listExperiences returns.
    Yes

    Returns XolaExperienceDetail

    interface 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/getExperience

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    experienceIdstringYes
    datestring
    "YYYY-MM-DD", from getAvailability().sessions[].date.
    Yes
    timestring
    Session start, from getAvailability().sessions[].time, e.g. "1000".
    Yes
    party{ demographicId: string; quantity: number }[]
    How many of each demographic.
    Yes

    Returns XolaPriceQuote

    interface 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/getPriceQuote

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    sellerIdstring
    The seller id findSeller returns.
    Yes

    Returns XolaListExperiencesResult

    interface 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/listExperiences

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    experienceIdstring
    The experience id listExperiences returns.
    Yes

    Returns XolaWaivers

    interface 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/listWaivers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.xola.listWaivers({ experienceId: "5ebedc0f2291e101d549b673" });

Use it from code