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.
- Site
- checkfront.com
- Functions
- 14
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
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/checkfrontOne MCP server for Checkfront 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 Checkfront operator from what a caller actually holds -- its subdomain ("thewilds"), a <operator>.checkfront.com link or booking-page URL, or…Arguments
Name Type Required inputstringYes Returns
CheckfrontOperatorinterface CheckfrontOperator { host: string; name: string; currency: string | null; publicApiEnabled: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/checkfront/findOperatorCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.checkfront.findOperator("thewilds");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.checkfront.findOperator("thewilds"))curl -X POST https://api.bowmark.ai/v1/sites/checkfront/findOperator \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"input":"thewilds"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/getAvailabilityCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.checkfront.getAvailability({ host: "sandbox.checkfront.com", startDate: { $daysFromNow: 7 } });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.checkfront.getAvailability({ "host": "sandbox.checkfront.com", "startDate": {"$daysFromNow": 7} }))curl -X POST https://api.bowmark.ai/v1/sites/checkfront/getAvailability \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"host":"sandbox.checkfront.com","startDate":{"$daysFromNow":7}}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/getAvailabilityCalendarCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.checkfront.getAvailabilityCalendar({ host: "sandbox.checkfront.com", startDate: { $daysFromNow: 3 }, endDate: { $daysFromNow: 9 } });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.checkfront.getAvailabilityCalendar({ "host": "sandbox.checkfront.com", "startDate": {"$daysFromNow": 3}, "endDate": {"$daysFromNow": 9} }))curl -X POST https://api.bowmark.ai/v1/sites/checkfront/getAvailabilityCalendar \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"host":"sandbox.checkfront.com","startDate":{"$daysFromNow":3},"endDate":{"$daysFromNow":9}}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/getBookingFormCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.checkfront.getBookingForm({ host: "sandbox.checkfront.com" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.checkfront.getBookingForm({"host": "sandbox.checkfront.com"}))curl -X POST https://api.bowmark.ai/v1/sites/checkfront/getBookingForm \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"host":"sandbox.checkfront.com"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required hoststringYes sessionIdstringNo Returns
CheckfrontCartinterface 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/getCartCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.checkfront.getCart({ host: "sandbox.checkfront.com" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.checkfront.getCart({"host": "sandbox.checkfront.com"}))curl -X POST https://api.bowmark.ai/v1/sites/checkfront/getCart \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"host":"sandbox.checkfront.com"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required hoststringYes itemIdstringYes Returns
CheckfrontItemDetailinterface 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/getItemCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.checkfront.getItem({ host: "sandbox.checkfront.com", itemId: "305" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.checkfront.getItem({"host": "sandbox.checkfront.com", "itemId": "305"}))curl -X POST https://api.bowmark.ai/v1/sites/checkfront/getItem \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"host":"sandbox.checkfront.com","itemId":"305"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required args{ host: string }Yes Returns
CheckfrontMyBookingsinterface 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/getMyBookingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.checkfront.getMyBookings({ host: "sandbox.checkfront.com" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.checkfront.getMyBookings({"host": "sandbox.checkfront.com"}))curl -X POST https://api.bowmark.ai/v1/sites/checkfront/getMyBookings \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"host":"sandbox.checkfront.com"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required hoststringYes Returns
CheckfrontOperatorDetailsinterface 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/getOperatorCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.checkfront.getOperator({ host: "sandbox.checkfront.com" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.checkfront.getOperator({"host": "sandbox.checkfront.com"}))curl -X POST https://api.bowmark.ai/v1/sites/checkfront/getOperator \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"host":"sandbox.checkfront.com"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/listCategoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.checkfront.listCategories({ host: "sandbox.checkfront.com" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.checkfront.listCategories({"host": "sandbox.checkfront.com"}))curl -X POST https://api.bowmark.ai/v1/sites/checkfront/listCategories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"host":"sandbox.checkfront.com"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.checkfront.listCategories({ host: "sandbox.checkfront.com" });listGiftCertificatesLists the gift certificates an operator sells: id, name, SKU, category, price and thumbnail.Arguments
Name Type Required 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/listGiftCertificatesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.checkfront.listGiftCertificates({ host: "sandbox.checkfront.com" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.checkfront.listGiftCertificates({"host": "sandbox.checkfront.com"}))curl -X POST https://api.bowmark.ai/v1/sites/checkfront/listGiftCertificates \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"host":"sandbox.checkfront.com"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/listItemsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.checkfront.listItems({ host: "sandbox.checkfront.com" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.checkfront.listItems({"host": "sandbox.checkfront.com"}))curl -X POST https://api.bowmark.ai/v1/sites/checkfront/listItems \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"host":"sandbox.checkfront.com"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.checkfront.listItems({ host: "sandbox.checkfront.com" });
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
Name Type Required hoststringYes slipsstring[]Yes sessionIdstringNo Returns
CheckfrontCartinterface 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/addToCartCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.checkfront.addToCart({ host: "<host>", slips: [] });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.checkfront.addToCart({"host": "<host>", "slips": []}))curl -X POST https://api.bowmark.ai/v1/sites/checkfront/addToCart \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"host":"<host>","slips":[]}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required hoststringYes sessionIdstringYes formRecord<string, string | number | boolean>Yes Returns
CheckfrontBookinginterface 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/bookItemsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.checkfront.bookItems({ host: "<host>", sessionId: "<sessionId>", form: "<form>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.checkfront.bookItems({ "host": "<host>", "sessionId": "<sessionId>", "form": "<form>" }))curl -X POST https://api.bowmark.ai/v1/sites/checkfront/bookItems \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"host":"<host>","sessionId":"<sessionId>","form":"<form>"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required hoststringYes sessionIdstringYes alterRecord<string, number | "remove" | "optin" | "optout">No clearbooleanNo Returns
CheckfrontCartinterface 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/updateCartCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.checkfront.updateCart({ host: "<host>", sessionId: "<sessionId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.checkfront.updateCart({"host": "<host>", "sessionId": "<sessionId>"}))curl -X POST https://api.bowmark.ai/v1/sites/checkfront/updateCart \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"host":"<host>","sessionId":"<sessionId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.checkfront.updateCart({ host: "<host>", sessionId: "<sessionId>" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/checkfront/<function> - OpenAPI
/v1/sites/checkfront/openapi.json