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 Booking Manager, Nausys, and any iCal calendar including Google and Apple Calendar). We expose two developer surfaces, split by who's calling:

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 APIAPI key on every call
An agent, broker or developer showing other operators' boats in your own productDiscovery API — every boat, with the price the guest pays, and links that send the buyer to charter.boatsNone — send your key for your own budget and your affiliate ref

The two surfaces split by whose boats you are reading. The Discovery API covers every boat, with the figures the public site shows. The Operator API reads only the boats of companies you are a member of — the records as you entered them — and is where the write actions live (import, update and delete a boat). Every Operator API call — reads included — carries your key in the X-API-Key header; only the iCal feeds are open, because calendar apps can't send headers.

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 on every call)
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 an API key once you accept the API terms.
  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?

On this page