Checkfront MCP by usefulapi is an MCP server published by io.usefulapi, hosted at checkfront.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 20 tools, including checkfront_get_company, checkfront_list_categories, checkfront_list_items, checkfront_get_item, checkfront_get_availability_calendar.
Check Checkfront availability and rates, and manage booking sessions, bookings, customers and notes.
4,061 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Fetch the connected Checkfront account's company configuration — name, URL, plan, currency, timezone, locale and date/time formats. A cheap way to confirm the host and credentials work. Checkfront: GET /api/3.0/company.
No parameters.
{
"name": "checkfront_get_company",
"title": "Get company settings",
"description": "Fetch the connected Checkfront account's company configuration — name, URL, plan, currency, timezone, locale and date/time formats. A cheap way to confirm the host and credentials work. Checkfront: GET /api/3.0/company.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get company settings",
"readOnlyHint": true
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
List the inventory categories (e.g. Tours, Rentals, Accommodations) with their ids, names, display order and item counts. Checkfront: GET /api/3.0/category.
No parameters.
{
"name": "checkfront_list_categories",
"title": "List item categories",
"description": "List the inventory categories (e.g. Tours, Rentals, Accommodations) with their ids, names, display order and item counts. Checkfront: GET /api/3.0/category.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List item categories",
"readOnlyHint": true
}
}List the enabled inventory items (tours, activities, rentals, rooms). With NO dates this is the plain catalogue. Pass start_date (and end_date / param quantities) to get a RATED response: per-item availability, pricing and a SLIP token — the SLIP is what checkfront_add_to_booking_session needs to book the item. Checkfront: GET /api/3.0/item.
| Parameter | Type | Description |
|---|---|---|
| date | string | (rated) Alias of start_date for same-day bookings — YYYYMMDD, YYYY-MM-DD, or a relative date such as "today". |
| param | object | Booking parameters (quantities) keyed by the parameter ids configured in your account, e.g. {"adults": 2, "children": 1}. Sent as param[adults]=2. |
| rules | string | 'soft' avoids date-based rule errors; 'off' disables rule checking. |
| item_id | string | Comma-separated list of item ids to filter to, e.g. 17,18. |
| keyword | string | Only items whose name contains this keyword. |
| end_date | string | (rated) Booking end date — YYYYMMDD, YYYY-MM-DD, or a relative date such as "today". |
| end_time | string | (rated) End time, for hourly bookings. |
| packages | boolean | Include package options. |
| available | integer | (rated) Only items with at least this many left in stock. |
| start_date | string | (rated) Booking start date — YYYYMMDD, YYYY-MM-DD, or a relative date such as "today". |
| start_time | string | (rated) Start time, for hourly bookings. |
| category_id | integer | Only items in this category. |
| discount_code | string | (rated) Discount code to apply to the price. |
{
"name": "checkfront_list_items",
"title": "List inventory items (optionally with availability and rates)",
"description": "List the enabled inventory items (tours, activities, rentals, rooms). With NO dates this is the plain catalogue. Pass start_date (and end_date / param quantities) to get a RATED response: per-item availability, pricing and a SLIP token — the SLIP is what checkfront_add_to_booking_session needs to book the item. Checkfront: GET /api/3.0/item.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"date": {
"type": "string",
"description": "(rated) Alias of start_date for same-day bookings — YYYYMMDD, YYYY-MM-DD, or a relative date such as \"today\"."
},
"param": {
"type": "object",
"description": "Booking parameters (quantities) keyed by the parameter ids configured in your account, e.g. {\"adults\": 2, \"children\": 1}. Sent as param[adults]=2.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"rules": {
"enum": [
"soft",
"off"
],
"type": "string",
"description": "'soft' avoids date-based rule errors; 'off' disables rule checking."
},
"item_id": {
"type": "string",
"description": "Comma-separated list of item ids to filter to, e.g. 17,18."
},
"keyword": {
"type": "string",
"description": "Only items whose name contains this keyword."
},
"end_date": {
"type": "string",
"description": "(rated) Booking end date — YYYYMMDD, YYYY-MM-DD, or a relative date such as \"today\"."
},
"end_time": {
"type": "string",
"description": "(rated) End time, for hourly bookings."
},
"packages": {
"type": "boolean",
"description": "Include package options."
},
"available": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "(rated) Only items with at least this many left in stock."
},
"start_date": {
"type": "string",
"description": "(rated) Booking start date — YYYYMMDD, YYYY-MM-DD, or a relative date such as \"today\"."
},
"start_time": {
"type": "string",
"description": "(rated) Start time, for hourly bookings."
},
"category_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Only items in this category."
},
"discount_code": {
"type": "string",
"description": "(rated) Discount code to apply to the price."
}
}
},
"annotations": {
"title": "List inventory items",
"readOnlyHint": true
}
}Fetch one inventory item's details. Pass start_date / end_date and param quantities (e.g. {"adults": 2}) for a RATED response with availability (rate.status, rate.available), the price breakdown and the SLIP used to book it. For parent/child grouped items, rate the CHILD item. Checkfront: GET /api/3.0/item/{item_id}.
| Parameter | Type | Description |
|---|---|---|
| date | string | (rated) Alias of start_date for same-day bookings — YYYYMMDD, YYYY-MM-DD, or a relative date such as "today". |
| param | object | Booking parameters (quantities) keyed by the parameter ids configured in your account, e.g. {"adults": 2, "children": 1}. Sent as param[adults]=2. |
| rules | string | 'soft' avoids date-based rule errors; 'off' disables rule checking. |
| item_id * | integer | The item id. |
| end_date | string | (rated) Booking end date — YYYYMMDD, YYYY-MM-DD, or a relative date such as "today". |
| end_time | string | (rated) End time, for hourly bookings. |
| packages | boolean | Include package options. |
| start_date | string | (rated) Booking start date — YYYYMMDD, YYYY-MM-DD, or a relative date such as "today". |
| start_time | string | (rated) Start time, for hourly bookings. |
| discount_code | string | (rated) Discount code to apply to the price. |
{
"name": "checkfront_get_item",
"title": "Get an item (optionally with availability and rates)",
"description": "Fetch one inventory item's details. Pass start_date / end_date and param quantities (e.g. {\"adults\": 2}) for a RATED response with availability (rate.status, rate.available), the price breakdown and the SLIP used to book it. For parent/child grouped items, rate the CHILD item. Checkfront: GET /api/3.0/item/{item_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"item_id"
],
"properties": {
"date": {
"type": "string",
"description": "(rated) Alias of start_date for same-day bookings — YYYYMMDD, YYYY-MM-DD, or a relative date such as \"today\"."
},
"param": {
"type": "object",
"description": "Booking parameters (quantities) keyed by the parameter ids configured in your account, e.g. {\"adults\": 2, \"children\": 1}. Sent as param[adults]=2.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"rules": {
"enum": [
"soft",
"off"
],
"type": "string",
"description": "'soft' avoids date-based rule errors; 'off' disables rule checking."
},
"item_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The item id."
},
"end_date": {
"type": "string",
"description": "(rated) Booking end date — YYYYMMDD, YYYY-MM-DD, or a relative date such as \"today\"."
},
"end_time": {
"type": "string",
"description": "(rated) End time, for hourly bookings."
},
"packages": {
"type": "boolean",
"description": "Include package options."
},
"start_date": {
"type": "string",
"description": "(rated) Booking start date — YYYYMMDD, YYYY-MM-DD, or a relative date such as \"today\"."
},
"start_time": {
"type": "string",
"description": "(rated) Start time, for hourly bookings."
},
"discount_code": {
"type": "string",
"description": "(rated) Discount code to apply to the price."
}
}
},
"annotations": {
"title": "Get an item",
"readOnlyHint": true
}
}Day-by-day available inventory over a date range — for one item (item_ids with a single id), several items, or a whole category. Use it to answer 'which days next month still have space?'. Checkfront: GET /api/3.0/item/{item_id}/cal or GET /api/3.0/item/cal.
| Parameter | Type | Description |
|---|---|---|
| end_date | string | Range end date — YYYYMMDD, YYYY-MM-DD, or a relative date such as "today". |
| item_ids | array | Item ids. One id queries that item's calendar; several query them together. |
| start_date | string | Range start date — YYYYMMDD, YYYY-MM-DD, or a relative date such as "today". |
| category_id | integer | Instead of item ids, a category of items. |
{
"name": "checkfront_get_availability_calendar",
"title": "Get an availability calendar",
"description": "Day-by-day available inventory over a date range — for one item (item_ids with a single id), several items, or a whole category. Use it to answer 'which days next month still have space?'. Checkfront: GET /api/3.0/item/{item_id}/cal or GET /api/3.0/item/cal.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"end_date": {
"type": "string",
"description": "Range end date — YYYYMMDD, YYYY-MM-DD, or a relative date such as \"today\"."
},
"item_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"description": "Item ids. One id queries that item's calendar; several query them together."
},
"start_date": {
"type": "string",
"description": "Range start date — YYYYMMDD, YYYY-MM-DD, or a relative date such as \"today\"."
},
"category_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Instead of item ids, a category of items."
}
}
},
"annotations": {
"title": "Get an availability calendar",
"readOnlyHint": true
}
}List bookings, newest filters first — by status, customer, dates, item or partner. Each row has the booking code, status, totals (total, tax_total, paid_total), customer name/email, summary and date_desc. Paged (default 100/page); the response's request.pages tells you how many pages exist. Checkfront: GET /api/3.0/booking/index.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. |
| limit | integer | Bookings per page, 1-100 (default 100). |
| item_id | integer | Only bookings containing this item. |
| end_date | string | Booking end (check-out) date. A date string or unix timestamp; prefix with '<' or '>' for before/after (e.g. ">2026-01-01"). |
| status_id | string | Booking status code, e.g. PEND, HOLD, PART, PAID, WAIT, STOP, VOID. |
| partner_id | string | Only bookings attributed to this partner account. |
| start_date | string | Booking start (check-in) date. A date string or unix timestamp; prefix with '<' or '>' for before/after (e.g. ">2026-01-01"). |
| customer_id | integer | Only bookings for this customer id. |
| created_date | string | Date the booking was created. A date string or unix timestamp; prefix with '<' or '>' for before/after (e.g. ">2026-01-01"). |
| last_modified | string | Date the booking last changed — useful for 'changed since' syncs. A date string or unix timestamp; prefix with '<' or '>' for before/after (e.g. ">2026-01-01"). |
| customer_email | string | Only bookings for this customer email. |
{
"name": "checkfront_list_bookings",
"title": "List bookings",
"description": "List bookings, newest filters first — by status, customer, dates, item or partner. Each row has the booking code, status, totals (total, tax_total, paid_total), customer name/email, summary and date_desc. Paged (default 100/page); the response's request.pages tells you how many pages exist. Checkfront: GET /api/3.0/booking/index.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Bookings per page, 1-100 (default 100)."
},
"item_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Only bookings containing this item."
},
"end_date": {
"type": "string",
"description": "Booking end (check-out) date. A date string or unix timestamp; prefix with '<' or '>' for before/after (e.g. \">2026-01-01\")."
},
"status_id": {
"type": "string",
"description": "Booking status code, e.g. PEND, HOLD, PART, PAID, WAIT, STOP, VOID."
},
"partner_id": {
"type": "string",
"description": "Only bookings attributed to this partner account."
},
"start_date": {
"type": "string",
"description": "Booking start (check-in) date. A date string or unix timestamp; prefix with '<' or '>' for before/after (e.g. \">2026-01-01\")."
},
"customer_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Only bookings for this customer id."
},
"created_date": {
"type": "string",
"description": "Date the booking was created. A date string or unix timestamp; prefix with '<' or '>' for before/after (e.g. \">2026-01-01\")."
},
"last_modified": {
"type": "string",
"description": "Date the booking last changed — useful for 'changed since' syncs. A date string or unix timestamp; prefix with '<' or '>' for before/after (e.g. \">2026-01-01\")."
},
"customer_email": {
"type": "string",
"description": "Only bookings for this customer email."
}
}
},
"annotations": {
"title": "List bookings",
"readOnlyHint": true
}
}Fetch extended information on one booking — status, dates, customer, form fields, line items and totals. Checkfront: GET /api/3.0/booking/{booking_id}.
| Parameter | Type | Description |
|---|---|---|
| booking_id * | string | The booking code identifying the booking, e.g. CFPP-290317. |
{
"name": "checkfront_get_booking",
"title": "Get a booking",
"description": "Fetch extended information on one booking — status, dates, customer, form fields, line items and totals. Checkfront: GET /api/3.0/booking/{booking_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"booking_id"
],
"properties": {
"booking_id": {
"type": "string",
"minLength": 1,
"description": "The booking code identifying the booking, e.g. CFPP-290317."
}
}
},
"annotations": {
"title": "Get a booking",
"readOnlyHint": true
}
}List the notes left on bookings across the account (default: the past 30 days), each with its booking code, author account id (0 = customer), date, body and whether it is private. Checkfront: GET /api/3.0/booking/notes.
| Parameter | Type | Description |
|---|---|---|
| date | string | Filter by a day (YYYY-MM-DD or ISO-8601) or a whole month (e.g. "2026-09"). |
{
"name": "checkfront_list_booking_notes",
"title": "List booking notes",
"description": "List the notes left on bookings across the account (default: the past 30 days), each with its booking code, author account id (0 = customer), date, body and whether it is private. Checkfront: GET /api/3.0/booking/notes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"date": {
"type": "string",
"description": "Filter by a day (YYYY-MM-DD or ISO-8601) or a whole month (e.g. \"2026-09\")."
}
}
},
"annotations": {
"title": "List booking notes",
"readOnlyHint": true
}
}Fetch the customer-details form for a booking (booking_form_ui): every field id (customer_name, customer_email, …), its label, type and whether it is required. Call this before checkfront_create_booking to know which `form` fields to send. Checkfront: GET /api/3.0/booking/form.
No parameters.
{
"name": "checkfront_get_booking_form",
"title": "Get the booking form fields",
"description": "Fetch the customer-details form for a booking (booking_form_ui): every field id (customer_name, customer_email, …), its label, type and whether it is required. Call this before checkfront_create_booking to know which `form` fields to send. Checkfront: GET /api/3.0/booking/form.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get the booking form fields",
"readOnlyHint": true
}
}Read a booking session — the in-progress 'cart' — with its line items (keyed by line_id), dates, sub_total, tax, total and amount due. Checkfront: GET /api/3.0/booking/session.
| Parameter | Type | Description |
|---|---|---|
| session_id * | string | The session_id returned by checkfront_add_to_booking_session. |
{
"name": "checkfront_get_booking_session",
"title": "Get a booking session (cart)",
"description": "Read a booking session — the in-progress 'cart' — with its line items (keyed by line_id), dates, sub_total, tax, total and amount due. Checkfront: GET /api/3.0/booking/session.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"session_id"
],
"properties": {
"session_id": {
"type": "string",
"minLength": 1,
"description": "The session_id returned by checkfront_add_to_booking_session."
}
}
},
"annotations": {
"title": "Get a booking session",
"readOnlyHint": true
}
}Look up customers by exact email, full name or phone number (exact matches; non-unique fields such as name can return several). Results are in the `customers` object. Checkfront: GET /api/3.0/customer.
| Parameter | Type | Description |
|---|---|---|
| customer_id | string | Customer code/id. |
| customer_name | string | Exact full name. |
| customer_email | string | Exact customer email address. |
| customer_phone | string | Exact phone number. |
{
"name": "checkfront_search_customers",
"title": "Search customers",
"description": "Look up customers by exact email, full name or phone number (exact matches; non-unique fields such as name can return several). Results are in the `customers` object. Checkfront: GET /api/3.0/customer.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"customer_id": {
"type": "string",
"description": "Customer code/id."
},
"customer_name": {
"type": "string",
"description": "Exact full name."
},
"customer_email": {
"type": "string",
"description": "Exact customer email address."
},
"customer_phone": {
"type": "string",
"description": "Exact phone number."
}
}
},
"annotations": {
"title": "Search customers",
"readOnlyHint": true
}
}Fetch one customer's contact details and their bookings (codes with created dates). Checkfront: GET /api/3.0/customer/{customer_id}.
| Parameter | Type | Description |
|---|---|---|
| customer_id * | string | The customer id (e.g. 25) or customer code. |
{
"name": "checkfront_get_customer",
"title": "Get a customer",
"description": "Fetch one customer's contact details and their bookings (codes with created dates). Checkfront: GET /api/3.0/customer/{customer_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"customer_id"
],
"properties": {
"customer_id": {
"type": "string",
"minLength": 1,
"description": "The customer id (e.g. 25) or customer code."
}
}
},
"annotations": {
"title": "Get a customer",
"readOnlyHint": true
}
}List the date-based events that change price or availability — seasonal rates (SE), specials (SP), discounts (DC), closures (status U) — with their dates, recurrence, pricing rule and the items/categories they apply to. Checkfront: GET /api/3.0/event.
No parameters.
{
"name": "checkfront_list_events",
"title": "List events (seasons, specials, closures, discounts)",
"description": "List the date-based events that change price or availability — seasonal rates (SE), specials (SP), discounts (DC), closures (status U) — with their dates, recurrence, pricing rule and the items/categories they apply to. Checkfront: GET /api/3.0/event.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List events",
"readOnlyHint": true
}
}List the staff (and partner) accounts on the Checkfront account — ids, names, emails, login ids and whether enabled. The account_id is what CHECKFRONT_ON_BEHALF takes. Checkfront: GET /api/3.0/account.
No parameters.
{
"name": "checkfront_list_staff_accounts",
"title": "List staff accounts",
"description": "List the staff (and partner) accounts on the Checkfront account — ids, names, emails, login ids and whether enabled. The account_id is what CHECKFRONT_ON_BEHALF takes. Checkfront: GET /api/3.0/account.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List staff accounts",
"readOnlyHint": true
}
}Start or modify a booking session: add one or more SLIPs (from a rated checkfront_get_item / checkfront_list_items call), replace a line with a new SLIP (line_id + slip), or alter lines (quantity, 'remove', 'optin'/'optout' for package add-ons). Holds the inventory while the session is open; NOTHING is booked until checkfront_create_booking. Returns the session_id to reuse. Checkfront: POST /api/3.0/booking/session.
| Parameter | Type | Description |
|---|---|---|
| slip | array | One or more SLIP strings to add, e.g. ["18.20171005X1-adults.1-children.0"]. |
| alter | object | Changes keyed by line_id, e.g. {"3": 5, "2.1": "optin", "1": "remove"} (a number sets the quantity). |
| line_id | string | With a single slip: the session line to REPLACE with it (to change a regular item's options). |
| session_id | string | Existing session to modify. Omit to start a new session. |
{
"name": "checkfront_add_to_booking_session",
"title": "Add items to a booking session (cart)",
"description": "Start or modify a booking session: add one or more SLIPs (from a rated checkfront_get_item / checkfront_list_items call), replace a line with a new SLIP (line_id + slip), or alter lines (quantity, 'remove', 'optin'/'optout' for package add-ons). Holds the inventory while the session is open; NOTHING is booked until checkfront_create_booking. Returns the session_id to reuse. Checkfront: POST /api/3.0/booking/session.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"slip": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "One or more SLIP strings to add, e.g. [\"18.20171005X1-adults.1-children.0\"]."
},
"alter": {
"type": "object",
"description": "Changes keyed by line_id, e.g. {\"3\": 5, \"2.1\": \"optin\", \"1\": \"remove\"} (a number sets the quantity).",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"enum": [
"remove",
"optin",
"optout"
],
"type": "string"
}
]
}
},
"line_id": {
"type": "string",
"description": "With a single slip: the session line to REPLACE with it (to change a regular item's options)."
},
"session_id": {
"type": "string",
"description": "Existing session to modify. Omit to start a new session."
}
}
},
"annotations": {
"title": "Add items to a booking session",
"destructiveHint": true
}
}Abandon a booking session: 'clear' empties its items, 'end' closes it. Releases the inventory it was holding; no booking is affected. Checkfront: POST /api/3.0/booking/session/clear or /booking/session/end.
| Parameter | Type | Description |
|---|---|---|
| action | string | 'end' (default) closes the session; 'clear' empties it. |
| session_id * | string | The session to clear or end. |
{
"name": "checkfront_end_booking_session",
"title": "End or clear a booking session",
"description": "Abandon a booking session: 'clear' empties its items, 'end' closes it. Releases the inventory it was holding; no booking is affected. Checkfront: POST /api/3.0/booking/session/clear or /booking/session/end.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"session_id"
],
"properties": {
"action": {
"enum": [
"clear",
"end"
],
"type": "string",
"description": "'end' (default) closes the session; 'clear' empties it."
},
"session_id": {
"type": "string",
"minLength": 1,
"description": "The session to clear or end."
}
}
},
"annotations": {
"title": "End or clear a booking session",
"destructiveHint": true
}
}Commit a booking: from a session_id (built with checkfront_add_to_booking_session) or directly from SLIPs, plus the customer form fields (see checkfront_get_booking_form for which are required — typically customer_name and customer_email). Creates a real reservation that consumes inventory and may notify the customer; change it later with checkfront_update_booking_status. Returns the new booking's ids and any invoice/payment URL. Checkfront: POST /api/3.0/booking/create.
| Parameter | Type | Description |
|---|---|---|
| form * | object | Customer form fields, e.g. {"customer_name": "John Smith", "customer_email": "john@example.com"}. Sent as form[customer_name]=…. |
| slip | array | Instead of a session: SLIP strings to book directly. |
| session_id | string | The session holding the items to book. |
{
"name": "checkfront_create_booking",
"title": "Create a booking",
"description": "Commit a booking: from a session_id (built with checkfront_add_to_booking_session) or directly from SLIPs, plus the customer form fields (see checkfront_get_booking_form for which are required — typically customer_name and customer_email). Creates a real reservation that consumes inventory and may notify the customer; change it later with checkfront_update_booking_status. Returns the new booking's ids and any invoice/payment URL. Checkfront: POST /api/3.0/booking/create.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"form"
],
"properties": {
"form": {
"type": "object",
"description": "Customer form fields, e.g. {\"customer_name\": \"John Smith\", \"customer_email\": \"john@example.com\"}. Sent as form[customer_name]=….",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": [
"string",
"number",
"boolean"
]
}
},
"slip": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "Instead of a session: SLIP strings to book directly."
},
"session_id": {
"type": "string",
"description": "The session holding the items to book."
}
}
},
"annotations": {
"title": "Create a booking",
"destructiveHint": true
}
}Set a booking's status — e.g. confirm a pending booking (PAID/PART), put it on HOLD or WAIT(list), or cancel it (VOID/STOP). Reversible: set it back to the previous status the same way. Does NOT record a payment. Optionally triggers the account's customer notifications. Checkfront: POST /api/3.0/booking/{booking_id}/update.
| Parameter | Type | Description |
|---|---|---|
| notify | boolean | Send the account's notifications for this change (default false). |
| status_id * | string | The new status code. Defaults: PEND, HOLD, PART, PAID, WAIT, STOP, VOID (plus any custom statuses in Manage > Layout > Statuses). |
| booking_id * | string | The booking code identifying the booking, e.g. CFPP-290317. |
{
"name": "checkfront_update_booking_status",
"title": "Change a booking's status",
"description": "Set a booking's status — e.g. confirm a pending booking (PAID/PART), put it on HOLD or WAIT(list), or cancel it (VOID/STOP). Reversible: set it back to the previous status the same way. Does NOT record a payment. Optionally triggers the account's customer notifications. Checkfront: POST /api/3.0/booking/{booking_id}/update.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"booking_id",
"status_id"
],
"properties": {
"notify": {
"type": "boolean",
"description": "Send the account's notifications for this change (default false)."
},
"status_id": {
"type": "string",
"minLength": 1,
"description": "The new status code. Defaults: PEND, HOLD, PART, PAID, WAIT, STOP, VOID (plus any custom statuses in Manage > Layout > Statuses)."
},
"booking_id": {
"type": "string",
"minLength": 1,
"description": "The booking code identifying the booking, e.g. CFPP-290317."
}
}
},
"annotations": {
"title": "Change a booking's status",
"destructiveHint": true
}
}Add a note to a booking, logged under the staff account the API acts on behalf of. Checkfront: POST /api/3.0/booking/{booking_id}/note.
| Parameter | Type | Description |
|---|---|---|
| body * | string | The note text, up to 3000 characters. |
| booking_id * | string | The booking code identifying the booking, e.g. CFPP-290317. |
{
"name": "checkfront_add_booking_note",
"title": "Add a note to a booking",
"description": "Add a note to a booking, logged under the staff account the API acts on behalf of. Checkfront: POST /api/3.0/booking/{booking_id}/note.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"booking_id",
"body"
],
"properties": {
"body": {
"type": "string",
"maxLength": 3000,
"minLength": 1,
"description": "The note text, up to 3000 characters."
},
"booking_id": {
"type": "string",
"minLength": 1,
"description": "The booking code identifying the booking, e.g. CFPP-290317."
}
}
},
"annotations": {
"title": "Add a note to a booking",
"destructiveHint": true
}
}Mark a guest as arrived (check in) or departed (check out). Checkfront adds a note under the acting account. VOID and cancelled bookings cannot be checked in or out. Checkfront: POST /api/3.0/booking/{booking_id}/checkin or /checkout.
| Parameter | Type | Description |
|---|---|---|
| action | string | 'checkin' (default) or 'checkout'. |
| booking_id * | string | The booking code identifying the booking, e.g. CFPP-290317. |
{
"name": "checkfront_check_in_booking",
"title": "Check a booking in or out",
"description": "Mark a guest as arrived (check in) or departed (check out). Checkfront adds a note under the acting account. VOID and cancelled bookings cannot be checked in or out. Checkfront: POST /api/3.0/booking/{booking_id}/checkin or /checkout.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"booking_id"
],
"properties": {
"action": {
"enum": [
"checkin",
"checkout"
],
"type": "string",
"description": "'checkin' (default) or 'checkout'."
},
"booking_id": {
"type": "string",
"minLength": 1,
"description": "The booking code identifying the booking, e.g. CFPP-290317."
}
}
},
"annotations": {
"title": "Check a booking in or out",
"destructiveHint": true
}
}Tools for Checkfront, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which tours have availability next Saturday?"; "List the bookings for this weekend and who made them."; "Look up the customer with the email jane.smith@example.com and her bookings.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Checkfront data. Free plan: 50 tool calls per month. Run checkfront_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run checkfront_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run checkfront_upgrade without a plan: it returns both plans, each with a payment link for the user to open. checkfront_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.