Charter Boats
Charter Boats API

Introduction

Welcome to the Charter Boats developer documentation

Charter Boats is a marketplace for charter boat rentals with unified calendar sync across multiple booking platforms (MMK, Nausys, iCal, Google Calendar). We expose two developer surfaces, split by who's calling:

Discovery API — for guests & agents

Public, no auth. Search boats, locations, POIs, routes, trips, and content. Powers our MCP server, Custom GPT, and in-browser agents.

Operator API — for owners & partners

REST. Read platform data (no key, server-side), and import/delete listings with a cb_live_ API key.

Which one do I want?

You are...UseAuth
An AI assistant, agent, or app looking things up for a userDiscovery API (or the MCP server)None
A boat owner or channel manager managing your own listingsOperator APIcb_live_ key (for writes)
A developer building search/discovery into your own productEither — discovery for conversational/compact results, operator reads for raw dataNone server-side

The two surfaces overlap on read ("search boats" exists in both), but they serve different jobs. The Discovery API returns compact, fuzzy-matched results tuned for LLMs. The Operator API returns raw records and is where the write actions live (import a boat, delete a boat) — those two need your key; the reads are open to server-side callers.

Booking and payment are not a public API. Reserving and paying for a charter runs through the charter.boats checkout, which requires a logged-in guest session and completes payment with Stripe Elements in the browser. There is no API-key path to create a booking.

Base URLs

https://charter.boats/api          # Operator API (key for writes)
https://charter.boats/api/ai        # Discovery API (public)
https://charter.boats/mcp           # MCP server (public)

Getting started

Owners & partners:

  1. Get your API key — Dashboard → Settings → API generates a cb_live_* key.
  2. Import your first boat — see the Quick Start.
  3. Set up calendar sync — export your iCal feed to sync with other platforms.

AI builders:

  1. Connect the MCP server at https://charter.boats/mcp, or
  2. Call the Discovery API directly — no key, just rate limits.

Need help?

Next

Quick Start

On this page