Checkfront MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on Checkfront: 14 typed functions through one MCP server. No Checkfront API key needed.

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

Connect

Just Checkfront

An MCP server for Checkfront 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/checkfront
Every site

One MCP server for Checkfront 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 11
  • findOperatorFinds a Checkfront operator from what a caller actually holds -- its subdomain ("thewilds"), a <operator>.checkfront.com link or booking-page URL, or…

    Arguments

    NameTypeRequired
    inputstringYes

    Returns CheckfrontOperator

    interface CheckfrontOperator {
      host: string;
      name: string;
      currency: string | null;
      publicApiEnabled: boolean;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.checkfront.findOperator("thewilds");
  • getAvailabilityPrices and checks a date for an operator's items, for a given party (e.g. { adult: 2 }) and optional discount code: per item whether it is available…

    Arguments

    NameTypeRequired
    hoststringYes
    startDatestringYes
    endDatestringNo
    itemIdstringNo
    categoryIdstringNo
    partyRecord<string, number>No
    discountCodestringNo

    Returns CheckfrontAvailability | CheckfrontAvailability[]

    interface CheckfrontAvailability {
      itemId: string;
      name: string;
      status: string; // the site's own labels, read the values off a result, never guess one from prose
      available: number;
      slip: string | null; // the opaque token addToCart takes; null unless status is AVAILABLE
      totalPrice: string | null;
      subTotal: string | null;
      errorTitle: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.checkfront.getAvailability({
      host: "sandbox.checkfront.com",
      startDate: { $daysFromNow: 7 }
    });
  • getAvailabilityCalendarReturns which days in a range each item (or one category, or one item) can be booked, so a caller can find the next open date before pricing it.

    Arguments

    NameTypeRequired
    hoststringYes
    startDatestringYes
    endDatestringYes
    itemIdstringNo

    Returns CheckfrontItemCalendar[]

    interface CheckfrontCalendarDay {
      date: string;
      available: number;
    }
    
    interface CheckfrontItemCalendar {
      itemId: string;
      unit: string;
      spanClosed: boolean;
      days: CheckfrontCalendarDay[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/checkfront/getAvailabilityCalendar

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.checkfront.getAvailabilityCalendar({
      host: "sandbox.checkfront.com",
      startDate: { $daysFromNow: 3 },
      endDate: { $daysFromNow: 9 }
    });
  • getBookingFormReturns the guest details an operator asks for at checkout -- name, email, phone, address, and its own custom questions (dietary needs, waivers) --…

    Arguments

    NameTypeRequired
    hoststringYes

    Returns CheckfrontFormField[]

    interface CheckfrontFormField {
      fieldId: string;
      label: string;
      type: string;
      required: boolean;
      tip: string;
      options: Record<string, string> | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/checkfront/getBookingForm

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.checkfront.getBookingForm({ host: "sandbox.checkfront.com" });
  • getCartReads a booking cart back by its id: line items, add-ons, taxes, discount, deposit, total and amount due.

    Arguments

    NameTypeRequired
    hoststringYes
    sessionIdstringNo

    Returns CheckfrontCart

    interface CheckfrontCartTax {
      name: string;
      total: string;
    }
    
    interface CheckfrontCartLine {
      lineId: string;
      itemId: string;
      name: string;
      unit: string;
      rateTotal: string;
      slip: string;
      available: number;
    }
    
    interface CheckfrontCart {
      id: string;
      summary: string;
      dateDesc: string;
      subTotal: string;
      taxes: CheckfrontCartTax[];
      taxTotal: string;
      total: string;
      due: string;
      deposit: string | null;
      lines: CheckfrontCartLine[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/checkfront/getCart

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.checkfront.getCart({ host: "sandbox.checkfront.com" });
  • getItemReturns one item in full: description, images, video, unit and length, the guest types with their min/max rules and labels, package add-ons, and the…

    Arguments

    NameTypeRequired
    hoststringYes
    itemIdstringYes

    Returns CheckfrontItemDetail

    interface CheckfrontItemImage {
      url: string;
      urlMedium: string;
      urlSmall: string;
      title: string;
    }
    
    interface CheckfrontItemGuestRule {
      param: string;
      min: number;
      max: number;
    }
    
    interface CheckfrontItemDetail {
      id: string;
      sku: string;
      name: string;
      summary: string;
      details: string;
      unit: string;
      len: number;
      categoryId: string;
      category: string;
      type: string;
      status: string;  // the site's own labels, read the values off a result, never guess one from prose
      stock: number | null;
      images: CheckfrontItemImage[];
      guestRules: CheckfrontItemGuestRule[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/checkfront/getItem

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.checkfront.getItem({ host: "sandbox.checkfront.com", itemId: "305" });
  • getMyBookingsLists the signed-in customer's own bookings with one operator: booking id, items, dates, total, and amount paid and due.

    Arguments

    NameTypeRequired
    args{ host: string }Yes

    Returns CheckfrontMyBookings

    interface CheckfrontMyBookingItem {
      name: string;
      date: string | null;
      amount: number | null;
    }
    
    interface CheckfrontMyBooking {
      id: string;
      url: string;
      created: string | null;
      bookingDate: string | null;
      items: CheckfrontMyBookingItem[];
      currency: string | null;
      total: number | null;
      paid: number | null;
      due: number | null;
    }
    
    interface CheckfrontMyBookings {
      host: string;
      bookings: CheckfrontMyBooking[];
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/checkfront/getMyBookings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.checkfront.getMyBookings({ host: "sandbox.checkfront.com" });
  • getOperatorReturns an operator's own business card from its booking host: name, address, city, region, country, phone, email, currency and timezone.

    Arguments

    NameTypeRequired
    hoststringYes

    Returns CheckfrontOperatorDetails

    interface CheckfrontOperatorDetails {
      host: string;
      name: string;
      publicApiEnabled: boolean;
      businessId: string | null;
      email: string | null;
      address: string | null;
      city: string | null;
      region: string | null;
      country: string | null;
      postalCode: string | null;
      phone: string | null;
      currency: string | null;
      timezone: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/checkfront/getOperator

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.checkfront.getOperator({ host: "sandbox.checkfront.com" });
  • listCategoriesLists an operator's item categories ("Kids Club", "Surf Boards", "General Admission") with each category's id, name, description, display order…

    Arguments

    NameTypeRequired
    hoststringYes

    Returns CheckfrontCategory[]

    interface CheckfrontCategory {
      id: string;
      name: string;
      description: string;
      pos: number;
      imageUrl: string;
      itemCount: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/checkfront/listCategories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.checkfront.listCategories({ host: "sandbox.checkfront.com" });
  • listGiftCertificatesLists the gift certificates an operator sells: id, name, SKU, category, price and thumbnail.

    Arguments

    NameTypeRequired
    hoststringYes

    Returns CheckfrontGiftCertificate[]

    interface CheckfrontGiftCertificate {
      id: string;
      name: string;
      sku: string;
      categoryId: string;
      price: string; // "0" means buyer-chosen amount, not a fixed face value
      thumbnailUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/checkfront/listGiftCertificates

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.checkfront.listGiftCertificates({ host: "sandbox.checkfront.com" });
  • listItemsLists an operator's bookable items (tours, rentals, rooms, tickets, packages, gift certificates) with item id, name, SKU, category, unit (day, night…

    Arguments

    NameTypeRequired
    hoststringYes
    categoryIdstringNo
    keywordstringNo
    limitnumberNo

    Returns CheckfrontItem[]

    interface CheckfrontItem {
      id: string;
      sku: string;
      name: string;
      summary: string;
      unit: string;
      categoryId: string;
      category: string;
      type: string;
      status: string; // the site's own status code (e.g. A for active), read the values off a real result
      stock: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/checkfront/listItems

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.checkfront.listItems({ host: "sandbox.checkfront.com" });
Act 3
  • addToCartStarts (or adds to) a booking cart on the operator's booking host from one or more slip tokens getAvailability returned, holding that stock against…

    Arguments

    NameTypeRequired
    hoststringYes
    slipsstring[]Yes
    sessionIdstringNo

    Returns CheckfrontCart

    interface CheckfrontCartTax {
      name: string;
      total: string;
    }
    
    interface CheckfrontCartLine {
      lineId: string;
      itemId: string;
      name: string;
      unit: string;
      rateTotal: string;
      slip: string;
      available: number;
    }
    
    interface CheckfrontCart {
      id: string;
      summary: string;
      dateDesc: string;
      subTotal: string;
      taxes: CheckfrontCartTax[];
      taxTotal: string;
      total: string;
      due: string;
      deposit: string | null;
      lines: CheckfrontCartLine[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/checkfront/addToCart

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.checkfront.addToCart({ host: "<host>", slips: [] });
  • bookItemsBooks a cart for a guest with the details getBookingForm asks for, and completes it only when nothing is due.

    Arguments

    NameTypeRequired
    hoststringYes
    sessionIdstringYes
    formRecord<string, string | number | boolean>Yes

    Returns CheckfrontBooking

    interface CheckfrontBooking {
      bookingId: string;
      status: string;  // the site's own labels, read the values off a result, never guess one from prose
      total: string;
      amountPaid: string;
      amountDue: string;
      completed: boolean;
      paymentUrl: string;
      customerName: string;
      customerEmail: string;
      items: Array<{ itemId: string; name: string; qty: number | null; status: string }>;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/checkfront/bookItems

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.checkfront.bookItems({ host: "<host>", sessionId: "<sessionId>", form: "<form>" });
  • updateCartChanges a booking cart: set a line's quantity, remove a line, opt in or out of a package add-on, or empty the cart entirely, returning the updated…

    Arguments

    NameTypeRequired
    hoststringYes
    sessionIdstringYes
    alterRecord<string, number | "remove" | "optin" | "optout">No
    clearbooleanNo

    Returns CheckfrontCart

    interface CheckfrontCartTax {
      name: string;
      total: string;
    }
    
    interface CheckfrontCartLine {
      lineId: string;
      itemId: string;
      name: string;
      unit: string;
      rateTotal: string;
      slip: string;
      available: number;
    }
    
    interface CheckfrontCart {
      id: string;
      summary: string;
      dateDesc: string;
      subTotal: string;
      taxes: CheckfrontCartTax[];
      taxTotal: string;
      total: string;
      due: string;
      deposit: string | null;
      lines: CheckfrontCartLine[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/checkfront/updateCart

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.checkfront.updateCart({ host: "<host>", sessionId: "<sessionId>" });

Use it from code