Charter Boats

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Search 14,000+ charter boats with live prices, plus marinas, anchorages, routes and itineraries.

Measured statistics

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Charter Boats": {
      "url": "https://charter.boats/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (46)

• search_boats read-only

  Search charter boats by location, name, type, dates, capacity, budget. The response `total_matching` is the FULL count of matching boats — results are the top `limit` of those, so phrase counts from it ("8 of 48 available") and re-call with a higher limit when the guest wants more. Pass the guest's dates as they gave them. Each boat sets its own changeover day (`checkinout_days`) and its own minimum stay (`min_charter_days`), so the week a boat can actually be sold may not start on the day asked for — `price_summary` always names the real week, and it is the one sentence to quote, as it stands: the boat page's own Total for the stay it names, for the `guests` given (else the boat's max guests), all in (charter, every required fee charged now or at pickup, the 45 EUR platform fee; refundable deposits never), and the discount applied (the percent the site's card shows); a stay other than a week names its dates and length ("for Jun 19–22 (3 nights), 4 guests"); with no dates it is the boat's lowest week ("From", at max guests, precomputed). `list_price` holds the same figures — `total` (the stay's), `per_day` (that total per day for the boat; `from` when no dates were given), `party` (the guests it is priced for), `original_per_day` and `discount_pct` when a discount applies. For Due now, Paid at pickup and each deposit by name call get_boat_details with the dates. No total here includes an optional extra — `price_summary`, `list_price` and the `total_max` screen all leave out a skipper where `skippered` is 'optional', a hostess, a cook — so for a total with one, call get_boat_details with the dates before you answer and add the fee it lists under `fees.optional`, or say the boat lists none — never a typical or estimated rate, and call no budget met or exceeded on one. When `boats` is short, `alternatives` holds the closest boats, and each one's `relaxed` names what it loosened: `dates` (the week either side), `place` (a nearby base), `model` (another model of the same make), `name` (a boat carrying one word of the name). Say which — they are not what was asked for, and they count toward no total. List them AFTER the matches, in their own list, under a one-line heading naming what was loosened ("Close alternatives — the week either side"): never mixed into the same list. That heading is what splits the two on every card surface, so without it an alternative is rendered exactly like a match. `alternative_inventory` tells you which kind of "no" you are giving: `total_boats` 0 means this coast does not have that boat, while `total_boats` high with `available_nearby_or_within_7_days` 0 means it is the week, not the place. If a plain marina search has neither matches nor alternatives, `listed_unavailable` may carry published boats visibly listed at that exact marina. They are not bookable results: quote no price, explain the supplied reason, and offer an availability alert. A search with NO dates and NO price cap lists every published boat that matches, so `boats` can end with entries we hold no prices for: from `unpriced_start_index` onward every one carries `bookable_as_searched: false` and a `not_offered_because` saying so — they count as matches, but cannot be booked or quoted, so name them, link them and offer an alert without ever stating a price. When you searched a boat by NAME, `named_matches` lists published boats carrying that name that this search could not offer — wrong dates, wrong place, or no prices loaded. Everything bookable AS SEARCHED is in `boats`; nothing in `named_matches` is — though one whose only reason is the place or the dates may still be sellable, which is what its `not_offered_because` tells you. Never say a named boat does not exist while it is in that list: name it, give its reason, and use `get_boat_details` for the dates it IS free. `name_not_found` means the opposite and is certain — that name is in no published boat anywhere. `alert_query` + `alert_horizon` feed availability_alert. Both are absent when this search cannot be expressed on the website (`search_url_unavailable` says so) — then there is no link to give and no alert to set: say so rather than linking charter.boats/search, which would show boats this answer excluded.

  Parameters:

  • sort — string — Sort order. Default: best_value (best value, available boats first). Use deals for biggest discounts first.
  • limit — integer
  • cabins — integer — Minimum number of guest cabins (crew cabins are not counted)
  • guests — integer — Number of guests
  • search — string — Boat NAME only ("Papillon", "Ziphius") — the name an operator gave one hull, matched as a WHOLE WORD, so send the name the guest said and not a shortening of it. NEVER a make or a model: both go in `makemodel`, a model on its own included ("Oceanis 46").
  • date_to — string — End date YYYY-MM-DD
  • currency — string — Optional: the currency every amount in the answer is written in, and any price you send is read in. EUR when omitted.
  • features — array — Equipment/amenity filters — boats must have ALL listed. Namespaced slugs ("dinghy:hypalon") are subtypes that already imply the parent — do not also list the parent. Map user phrasing to slugs: "ac"/"a/c"/"air con"/"aircon"/"klima" → air_conditioning, "heater"/"cabin heating"/"webasto" → heating, "warm water"/"boiler"/"water heater" → hot_water, "genset"/"power generator" → generator, "power inverter"/"12v to 220v" → inverter, "solar power"/"solar" → solar_panels, "water maker"/"desalinator" → watermaker, "wi-fi"/"internet"/"wireless internet"/"4g" → wifi, "cockpit shower"/"outdoor shower"/"transom shower" → deck_shower, "refrigerator"/"icebox" → fridge, "ice chest"/"cool box" → cooler, "deep freeze" → freezer, "icemaker" → ice_maker, "stove"/"cooker"/"hob"/"kitchen" → oven, "micro wave" → microwave, "dish washer" → dishwasher, "washer"/"dryer"/"laundry" → washing_machine, "coffee maker"/"espresso machine"/"nespresso" → coffee_machine, "electric wc"/"electric heads" → electric_toilet, "wc"/"restroom"/"bathroom" → toilet, "television"/"screen" → tv, "speakers"/"stereo"/"music" → sound_system, "auto pilot" → autopilot, "gps"/"chart plotter"/"plotter"/"navigation" → chartplotter, "ais transponder" → ais, "bowthruster" → bow_thruster, "electric anchor winch" → electric_windlass, "tender"/"zodiac" → dinghy, "dinghy davits" → davits, "outboard motor" → outboard, "shade"/"canopy"/"sun awning" → bimini, "spray hood" → sprayhood, "teak cockpit" → teak_deck, "passerelle" → gangway, "fly bridge" → flybridge, "swim platform"/"diving platform" → bathing_platform, "hot tub"/"whirlpool"/"swimming pool" → jacuzzi, "gyro stabilizer"/"seakeeper" → stabilizers, "child safety net"/"lifeline net" → railing_net, "lazyjack"/"lazybag"/"stack pack" → lazy_bag, "code zero" → gennaker, "e-winch" → electric_winch, "snorkel"/"masks and fins" → snorkeling_gear, "scuba gear"/"dive gear" → diving_equipment, "paddleboard"/"paddle board" → sup, "canoe" → kayak, "fishing equipment"/"rods" → fishing_gear, "towables"/"wakeboard"/"water skis"/"tubes" → water_toys, "underwater scooter" → seabob, "efoil"/"electric foil"/"fliteboard"/"wing foil" → e_foil, "windsurfing"/"windsurf board" → windsurf, "bicycle"/"e-bike"/"electric bike" → bikes, "waverunner"/"pwc" → jet_ski, "barbecue"/"grill" → bbq, "hard bottom dinghy"/"rigid dinghy"/"rib tender"/"hard bottom" → dinghy:hard_bottom, "hypalon dinghy"/"hypalon tender" → dinghy:hypalon, "console dinghy"/"console tender" → dinghy:console, "large dinghy"/"big tender" → dinghy:large, "electric outboard"/"torqeedo" → outboard:electric, "15hp outboard"/"powerful outboard"/"planing outboard" → outboard:hp_15_plus, "smart tv" → tv:smart, "satellite tv"/"sat tv" → tv:satellite, "bluetooth"/"bluetooth speakers"/"bluetooth sound system" → sound_system:bluetooth, "fridge on flybridge"/"flybridge fridge" → fridge:flybridge.
  • location — string — Destination name (fuzzy matched)
  • year_min — integer — Minimum build year
  • boat_type — string
  • date_from — string — Start date YYYY-MM-DD
  • makemodel — string — Make and/or model, plain text, exactly as the guest said it: "Bali 4.2", "Fountaine Pajot", "FP 41", "Lagoon", "Oceanis 46". Make alone is fine and so is a MODEL alone. Do not split it, do not add punctuation, do not expand acronyms.
  • price_max — number — Max price per day for the boat in `currency` (EUR when omitted), all fees in — a boat's WEEKLY list figure: a week's grand total (charter, every required fee now or at pickup, the 45 EUR platform fee, our discounts; deposits never) at max guests ÷ its days; a dated row's `list_price.per_day` is its own stay's and may differ. Use ONLY for an explicit per-day cap; for a whole-trip/weekly budget use total_max instead.
  • price_min — number — Min price per day for the boat in `currency` (EUR when omitted), all fees in — a boat's WEEKLY list figure: a week's grand total (charter, every required fee now or at pickup, the 45 EUR platform fee, our discounts; deposits never) at max guests ÷ its days. A dated row's `list_price.per_day` is its own stay's and may differ
  • total_max — number — Max grand total for the stay in `currency`, EUR when omitted (the charter, every required fee now or at pickup and the flat 45 EUR platform fee; deposits never included): screened on the total `price_summary` states (`list_price.total`: the boat page's Total for the stay it names, for the `guests` given, else max guests); a month-wide range on `per_day` × days at max guests. Use this whenever the guest gives a total or per-week budget, e.g. "under €5000 for the week". Needs dates to apply.
  • length_min — integer — Minimum boat length in feet

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• search_locations read-only

  Find marinas, harbours and anchorages three ways: by NAME (q), by POPULARITY within an area (region/country/city — ranked on observed AIS vessel traffic for a month), or by REACH from a place you already have (`from` + `within_nm`) — where boats are actually recorded sailing to from there, with measured passage times. Use `from` for "where can I sail from X", "what is a day sail from X", "somewhere quieter nearby". Provide q, or an area, or from.

  Parameters:

  • q — string — Name search (min 2 chars). Optional when an area filter is given.
  • city — string
  • from — string — Origin location id (or slug) to sail FROM — take it from an earlier search_locations or get_location_details result. Returns places boats were tracked sailing to from there.
  • sort — string — Default popularity = real vessel traffic for the month; boats = charter fleet size; rating = Google rating
  • type — string — Kind of place — e.g. anchorage for "quiet bays"; spot = an unclassified stop (beach, spit, headland)
  • limit — integer
  • month — integer — Month to rank popularity for (default: current month)
  • region — string — Sailing region as the guest says it: Dalmatia, Istria, Kvarner, the Ionian, the Saronic, the Cyclades, the Dodecanese, the Sporades
  • country — string — Country name or 2-letter code
  • currency — string — Optional: the currency every amount in the answer is written in, and any price you send is read in. EUR when omitted.
  • within_nm — integer — How far, in nautical miles, for a "from" search. Default 35. Pick the ring by time — a charter boat makes about 6 knots, plus 30 minutes to leave and arrive, so: 10nm ≈ 2.2h, 20nm ≈ 3.8h, 35nm ≈ 6.3h, 55nm ≈ 9.7h, 100nm ≈ 17.2h. A full charter day of sailing is roughly 6-8h, which makes 35nm a comfortable day sail and 55nm a long one.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• search_pois read-only

  Find restaurants, fuel, groceries, attractions near a location, or search by POI name. POIs carry no ratings — rank and describe them by what they are and how close they are.

  Parameters:

  • q — string — Search POI by name
  • limit — integer
  • category — string
  • location — string — Location name (fuzzy). Required unless q is provided.
  • location_id — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• search_routes read-only

  Find sailing passages between destinations with distance and difficulty.

  Parameters:

  • q — string — Search route by title
  • from — string — Place the passage starts or ends at, as the guest says it ("Sivota", "Nydri, Greece", "Dalmatia"). Resolved to a real place; if it resolves to nothing you get `from_unresolved` and no passages, never passages somewhere else.
  • limit — integer
  • difficulty — string
  • location_id — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• search_trips read-only

  Find existing curated sailing itineraries by location, name, duration, activities.

  Parameters:

  • q — string — Search itinerary by title
  • limit — integer
  • location — string — Place the itinerary passes through, as the guest says it ("Split", "Nydri, Greece", "Dalmatia", "Croatia"). Resolved to a real place; if it resolves to nothing you get `location_unresolved` and no itineraries, never itineraries somewhere else.
  • max_days — integer
  • min_days — integer
  • boat_type — string
  • activities — string — Comma-separated activities
  • location_id — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• search_content read-only

  Search articles and Q&A on charter.boats. Use for questions about booking process, costs, licenses, cancellation, deposits, check-in, packing, etc. For developer questions about our API (endpoints, keys, params), use type=api to search the API docs at docs.charter.boats.

  Parameters:

  • q (required) — string — Short keyword query (2-4 words)
  • type — string
  • limit — integer

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_boat_details read-only

  Get full details of a specific boat: security deposit, cancellation policy, amenities, fees, seasonal prices, check-in/out times, location details — and the dates it is actually free (priced date ranges plus bookable slots for the year ahead). Use when the user asks about a specific boat, and whenever a boat came back in `named_matches` and they want to know when it IS available. With dates, `stay_price` states Due now, Paid at pickup and Total first, then the charter, its discounts and the deposits.

  Parameters:

  • id (required) — string — Boat id from search_boats results (including named_matches) — copy it verbatim.
  • guests — number — Optional: the party the stay is priced for; without it, the boat's capacity.
  • date_to — string — Optional check-out date YYYY-MM-DD — see date_from.
  • currency — string — Optional: the currency every amount in the answer is written in, and any price you send is read in. EUR when omitted.
  • date_from — string — Optional check-in date YYYY-MM-DD of the stay you are quoting. With date_to, `fees` are the ones that apply to that stay, and `url` opens the boat on those dates when the stay is one we sell — `stay_price` prices it and, on a boat with no check-in periods, it starts and ends on the boat changeover day. Pass both whenever you quote a price for specific dates.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_boat_standouts read-only

  What stands out about ONE boat for one week, measured against similar boats: its pros and its cons, each with how it compares ("47.9 ft (better than 99%)", "€2000 security deposit (typical €1700)", "Rare kit: [0.8%] Cool Box" — n% of those boats have it). Use when the guest asks what is special about a boat, what the catch is, why it is cheap or dear, or how it compares with others. It measures build year, length, cabins, bathrooms, guests, the security deposit and kit — and, with date_from, check-in and check-out times, the changeover day and the open weeks left; any of those it does not list is ordinary among the boats in `compared_with`, so do not sell it as an edge or a catch. Other fees are not compared. Kit is measured two ways and both hold: get_boat_details gives each item its [n%] across the whole fleet, this tool what is rare among boats like it. `rare_kit` lists that rare kit as data, most useful first, each with `useful_score` (1-5: how much it changes a charter week for the people aboard). `note` says whether an absence means "ordinary" or that nothing could be compared.

  Parameters:

  • id (required) — string — Boat id from search_boats or get_boat_details — copy it verbatim.
  • currency — string — Optional: the currency every amount in the answer is written in, and any price you send is read in. EUR when omitted.
  • fallback — boolean — Optional, default true: with nothing past the cut-off on a side, name the one thing that beats (or trails) most of them. false returns only what clears the cut-off.
  • date_from — string — Optional check-in date YYYY-MM-DD of the week the guest is looking at: the boats are then compared on that week's prices, and its schedule and open weeks are judged. Pass it whenever the guest has dates.
  • compare_by — string — Which boats count as similar. price (default): the same type priced within ±5% — what else the same money buys. guests: the same type taking the same number of guests — use when the question is value for a party size ("is it cheap for 10 people?"). length: the same type within ±2.5% of its length — use when comparing boats of one size. On guests and length the all-in day rate (the figure the search card prints) is compared too.
  • cutoff_pct — number — Optional, default 10, at most 50: a pro beats all but this share of the similar boats, a con trails all but it, rare kit is on fewer than it. Raise it for more, weaker lines.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• compare_boat read-only

  One boat against up to 10 closest published boats of the same type in the same country: specs and the all-in weekly price (in `currency`, EUR when omitted, at max guests, the figure search compares) for each of the next 52 weeks. Pass `id` (a boat), or `boat_type` and `country` (optionally `region`, `city`) to describe one. The specs take search_boats' names: without `id` they describe the boat to compare; with `id` they filter its peers as search_boats would. Only boats open at least one week are compared. `similar_pct` is how alike a peer is: the share of the specs it shares. With `id`, `overlap_pct` is the share of the boat's open weeks the peer is open too. With `id`, `anchor.price` is the boat's weekly figures, a peer's `price` is its figure minus the boat's (its own in the weeks listed in `absolute_weeks`), and a peer carries its `region`, `city`, `same` (the fields it shares with the boat) and only the specs that differ, as signed deltas; without `id` every peer carries its own specs and figures. null = not sellable that week; `weeks` gives each check-in date. Use when someone asks how a boat compares with others nearby on price, size or age — an operator benchmarking their own boat included. For what is better or worse about one boat, use get_boat_standouts.

  Parameters:

  • id — string — Boat id from search_boats or get_boat_details — copy it verbatim. Omit to describe a boat by its specs.
  • city — string — Without id, optional: city or town, e.g. Split.
  • lock — array — With id: keep only peers the same as the boat in these fields — the fields a peer's `same` lists.
  • berths — number — Berths: without id the number to match, with id the minimum.
  • cabins — number — Cabins: without id the number to match; with id the minimum guest cabins, crew cabins not counted (as search_boats).
  • guests — number — Guests: without id the number to match, with id the minimum.
  • region — string — Without id, optional: sailing region, e.g. Dalmatia.
  • country — string — Without id: ISO country code, e.g. HR (required with boat_type).
  • toilets — number — Toilets: without id the number to match, with id the minimum.
  • currency — string — Optional: the currency every amount in the answer is written in, and any price you send is read in. EUR when omitted.
  • year_max — integer — Maximum build year.
  • year_min — integer — Minimum build year.
  • boat_type — string — Without id: the boat type (required with country).
  • makemodel — string — Make and/or model as the guest said it, e.g. "Lagoon 42", "Bali".
  • length_max — integer — Maximum length in feet.
  • length_min — integer — Minimum length in feet.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_poi_details read-only

  Get full details of a point of interest by ID: description, opening hours, address, contact, nearby marinas, special offers. Use when user is viewing or asks about a specific POI. POIs carry NO rating or review count — do not claim one or ask the guest to check it.

  Parameters:

  • id (required) — string — POI id from search_pois results — copy it verbatim.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_location_details read-only

  Get full details of a marina, anchorage or bay by ID: description, amenities, contact, boat count and cheapest day rate, PLUS what only we know from tracked AIS traffic — how busy it is in each month of the year, how boats use it (share of overnight visits, typical day-stop length, what time it fills up), whether it is a hidden gem, the places boats actually sail to from there, most-travelled first with the share of the tracked trips each one takes and an estimated passage time, and the nearest bookable base for a spot with no fleet of its own. Use when the user is viewing or asks about a specific place, asks when it is quiet, or asks where to go next from one. Busyness compares a place to its own peak month, never to another place.

  Parameters:

  • id (required) — string — Location id from search_locations results — copy it verbatim.
  • currency — string — Optional: the currency every amount in the answer is written in, and any price you send is read in. EUR when omitted.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_trip_details read-only

  Get full details of a sailing itinerary/trip by ID: day-by-day stops, distances, activities, highlights, notes. Use when user is viewing or asks about a specific trip.

  Parameters:

  • id (required) — string — Trip id from search_trips results — copy it verbatim.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• list_boats read-only

  The operator's own fleet: every boat of each company the key holder belongs to, published or not, with its company's name, specs, pricing source, changeover settings and photos. Start here: it gives the boat ids and company ids every other operator tool takes. An empty list means the account belongs to no company.

  Parameters:

  • company_id — string — Optional: one company only. Without it, every company the account belongs to.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_boat read-only

  One of the operator's boats in full, as its edit page shows it: every editable field, photos with their ids, videos, equipment (hidden items included) and `locked_fields`, the fields MMK or Nausys rewrite on every sync.

  Parameters:

  • id (required) — string — Boat id, from list_boats.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• update_boat

  Change details of one of the operator's boats; only the fields sent change, and a field listed in `locked_fields` is ignored because the partner sync owns it. The answer carries `is_published` and `missing`, what the boat still lacks to be listed. Read the current value with its read tool first; this call returns the value as it now stands.

  Parameters:

  • id (required) — string — Boat id, from list_boats.
  • year — integer
  • model — string
  • title — string
  • berths — integer
  • cabins — integer
  • skipper — integer — 1 when a skipper is required.
  • toilets — integer
  • capacity — integer — Maximum guests.
  • features — array — The owner-entered equipment slugs, the whole list: it replaces the previous one.
  • boat_type — string
  • length_ft — number — On a partner-synced boat this pins the length against the sync.
  • charter_day — integer — Changeover weekday, 0 Sunday to 6 Saturday.
  • description — string
  • location_id — integer — Home marina id.
  • rental_type — string
  • checkin_time — string — HH:MM
  • instant_book — boolean
  • length_unpin — boolean — true restores the governed length of a pinned boat.
  • checkout_time — string — HH:MM
  • manufacturer_id — string
  • check_in_periods — array — Check-in rules by date range, in the shape get_boat returns them.
  • min_charter_days — integer
  • security_deposit — number — EUR.
  • deposit_with_waiver — number — EUR: the deposit when the guest takes the damage waiver.

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• set_equipment_visibility

  Hide an equipment item from the boat's public listing and search, or show it again; the same item under another wording follows it. Use the item's name as get_boat lists it in `equipment_items`. Returns the new state.

  Parameters:

  • id (required) — string — Boat id, from list_boats.
  • name (required) — string — The item as get_boat lists it.
  • hidden (required) — boolean

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• update_boat_images

  Hide one photo, show a hidden one again, or set the photo order (the first is the cover); send one of the three. Photo ids come from get_boat. Returns the boat with its photos as they now stand. New photos are uploaded on the boat's edit page.

  Parameters:

  • id (required) — string — Boat id, from list_boats.
  • enable_id — string — Photo id to show again.
  • image_ids — array — Every photo id in the new order.
  • disable_id — string — Photo id to hide.

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• delete_boat_image destructive

  Delete one photo of the boat for good. To take a photo off the listing and keep it, use update_boat_images with disable_id.

  Parameters:

  • id (required) — string — Boat id, from list_boats.
  • image_id (required) — string

  Hints: read-only no · destructive yes · idempotent not declared · open-world no

• get_company read-only

  The company profile as its settings page holds it: public profile, contact, bank, tax and invoicing details, the cancellation policy (`cancel_refund_percent` refunded when the guest cancels at least `cancel_refund_days` before the charter), the X-Lock switch (in `settings`) and the member and boat counts.

  Parameters:

  • company_id (required) — string — Company id, from list_boats (`company_id`) or get_company.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• update_company

  Change company details; only the fields sent change. Any member may change the public profile; contact email, bank, tax and invoicing details are the owner's, and a request naming one from anyone else is refused whole. Read the current value with its read tool first; this call returns the value as it now stands.

  Parameters:

  • company_id (required) — string — Company id, from list_boats (`company_id`) or get_company.
  • city — string
  • iban — string — Owner only: the EUR payout account.
  • name — string
  • slug — string — The address of the company page.
  • about — string
  • email — string — Owner only: where bookings and guest messages are sent.
  • phone — string
  • state — string
  • tax_id — string — Owner only.
  • logo_url — string
  • bank_name — string — Owner only.
  • bic_swift — string — Owner only.
  • legal_name — string — Owner only.
  • vat_number — string — Owner only.
  • description — string
  • postal_code — string
  • website_url — string
  • country_code — string
  • address_line1 — string
  • address_line2 — string
  • invoice_email — string — Owner only.
  • usd_bank_name — string — Owner only.
  • usd_bic_swift — string — Owner only.
  • vat_registered — boolean — Owner only.
  • cover_image_url — string
  • usd_account_number — string — Owner only: the USD payout account.
  • registration_number — string — Owner only.

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• get_cancellation_limits read-only

  What the company's payment schedule means for its cancellation policy: per boat source, the share paid in advance and how many days before the charter the rest is due, with the largest refund each notice period covers from money already collected. Read beside get_company's `cancel_refund_percent` and `cancel_refund_days`. `policy_applies` false: the company has no MMK or Nausys boat, so its policy governs nothing and cannot be changed.

  Parameters:

  • id (required) — string — Company id.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• set_cancellation_policy

  Set the company's cancellation policy, company owners only: a guest who cancels at least `cancel_refund_days` before the charter gets `cancel_refund_percent` of the charter price back. The policy applies to the company's MMK and Nausys bookings only; its direct boats follow charter.boats terms, so a company whose boats are all direct is refused. Read get_cancellation_limits first. Returns the company as it now stands.

  Parameters:

  • company_id (required) — string — Company id, from list_boats (`company_id`) or get_company.
  • cancel_refund_percent (required) — integer — Share of the charter price refunded, 0 to 100.
  • cancel_refund_days (required) — integer — Days before the charter the guest must cancel by, 1 to 90.

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• set_cross_lock

  Switch X-Lock for a company, company admins and owners only. With X-Lock on, every block, option or booking placed on one partner calendar (MMK or Nausys) also places a hold on the boat's other partner calendar. `sync_existing` true also places or releases those holds for the bookings and blocks already there. Returns the company as it now stands. Read the current value with its read tool first; this call returns the value as it now stands.

  Parameters:

  • company_id (required) — string — Company id, from list_boats (`company_id`) or get_company.
  • enabled (required) — boolean
  • sync_existing — boolean

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• list_discounts read-only

  The company's active discounts: codes guests type at checkout, automatic ones, and the pay-in-full discount, each with its value, booking window (`start_date`..`end_date`), stay window (`stay_from`..`stay_to`) and the boats it covers (`all_boats`, else `boat_ids`). An empty list means the company runs no discount.

  Parameters:

  • company_id (required) — string — Company id, from list_boats (`company_id`) or get_company.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• create_discount

  Create a discount; it comes out of the operator's payout, never out of the platform commission. Returns the stored discount.

  Parameters:

  • company_id (required) — string — Company id, from list_boats (`company_id`) or get_company.
  • discount_type (required) — string — `percentage` or `fixed`.
  • discount_value (required) — number — The percent, or for fixed the amount in `currency` (EUR when omitted).
  • code — string — The code guests type; required unless trigger is pay_in_full.
  • stay_to — string — Latest check-in it covers, YYYY-MM-DD.
  • trigger — string — `code` (default) or `pay_in_full`, a percentage taken when the guest pays everything at once.
  • boat_ids — array
  • currency — string — EUR or USD: the currency a fixed amount is in.
  • end_date — string — Last day it can be booked, YYYY-MM-DD.
  • max_uses — integer
  • all_boats — boolean — false limits it to `boat_ids`.
  • stay_from — string — Earliest check-in it covers, YYYY-MM-DD.
  • auto_apply — boolean — true applies it without a code.
  • start_date — string — First day it can be booked, YYYY-MM-DD.
  • description — string — Shown to the guest.

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• update_discount

  Change a discount; only the fields sent change. Read the current value with its read tool first; this call returns the value as it now stands.

  Parameters:

  • id (required) — string — Discount id, from list_discounts.
  • code — string
  • stay_to — string — Latest check-in it covers, YYYY-MM-DD.
  • boat_ids — array
  • currency — string — EUR or USD: the currency a fixed amount is in.
  • end_date — string — Last day it can be booked, YYYY-MM-DD.
  • max_uses — integer
  • all_boats — boolean — false limits it to `boat_ids`.
  • is_active — boolean
  • stay_from — string — Earliest check-in it covers, YYYY-MM-DD.
  • auto_apply — boolean — true applies it without a code.
  • start_date — string — First day it can be booked, YYYY-MM-DD.
  • description — string — Shown to the guest.
  • discount_type — string — `percentage` or `fixed`.
  • discount_value — number — The percent, or for fixed the amount in `currency` (EUR when omitted).

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• delete_discount destructive

  End a discount: guests can no longer use it; bookings already made keep it.

  Parameters:

  • id (required) — string — Discount id, from list_discounts.

  Hints: read-only no · destructive yes · idempotent not declared · open-world no

• get_pricing read-only

  The season prices of the fleet: per boat, every week-price row with its id, date span (month/day, repeating every year), `price_per_day` and `source`. Rows with `source` mmk or nausys come from the partner and change there; rows with `source` direct are the operator's to edit with add_price, update_price and delete_price.

  Parameters:

  • company_id — string — Optional: one company only.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• add_price

  Add a season price to a boat the operator prices directly (pricing source direct). Returns the stored row.

  Parameters:

  • id (required) — string — Boat id, from list_boats.
  • name (required) — string — Season name.
  • start_month (required) — integer
  • start_day (required) — integer
  • end_month (required) — integer
  • end_day (required) — integer
  • price_per_day (required) — number — EUR per day for the boat.
  • priority — integer — The higher one wins where two seasons overlap.

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• update_price

  Change a direct season price; only the fields sent change. Read the current value with its read tool first; this call returns the value as it now stands.

  Parameters:

  • id (required) — string — Boat id, from list_boats.
  • price_id (required) — string — Row id, from get_pricing.
  • name — string — Season name.
  • end_day — integer
  • priority — integer — The higher one wins where two seasons overlap.
  • end_month — integer
  • start_day — integer
  • start_month — integer
  • price_per_day — number — EUR per day for the boat.

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• delete_price destructive

  Delete a direct season price; the dates it covered have no price until another row covers them.

  Parameters:

  • id (required) — string — Boat id, from list_boats.
  • price_id (required) — string — Row id, from get_pricing.

  Hints: read-only no · destructive yes · idempotent not declared · open-world no

• list_boat_fees read-only

  Every extra and fee row of a boat, as its edit page lists them: amount, period, whether it is required, how it is collected, and its `source`. Rows with `source` direct are the operator's to edit.

  Parameters:

  • id (required) — string — Boat id, from list_boats.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• add_fee

  Add an extra or fee to a boat the operator prices directly. Returns the stored row and `warnings`, other rows it overlaps.

  Parameters:

  • id (required) — string — Boat id, from list_boats.
  • description (required) — string — The fee as guests read it.
  • amount (required) — number — EUR, or a percent when amount_is_percentage.
  • period (required) — string — How it is counted, per booking, day, night, person or week; the answer to a wrong value lists the allowed ones.
  • category — string
  • required — boolean — true when every guest pays it.
  • valid_to — string — YYYY-MM-DD
  • on_request — boolean
  • valid_from — string — YYYY-MM-DD
  • percentage_base — string — What the percentage is taken on; empty is the charter price.
  • calculation_type — string — How it is collected: `separate_payment` paid at the base (default), `advance_payment` charged at booking, `included_in_price`.
  • amount_is_percentage — boolean

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• update_fee

  Change a direct fee row; only the fields sent change. Read the current value with its read tool first; this call returns the value as it now stands.

  Parameters:

  • id (required) — string — Boat id, from list_boats.
  • fee_id (required) — string — Row id, from list_boat_fees.
  • amount — number — EUR, or a percent when amount_is_percentage.
  • period — string — How it is counted, per booking, day, night, person or week; the answer to a wrong value lists the allowed ones.
  • category — string
  • required — boolean — true when every guest pays it.
  • valid_to — string — YYYY-MM-DD
  • on_request — boolean
  • valid_from — string — YYYY-MM-DD
  • description — string — The fee as guests read it.
  • percentage_base — string — What the percentage is taken on; empty is the charter price.
  • calculation_type — string — How it is collected: `separate_payment` paid at the base (default), `advance_payment` charged at booking, `included_in_price`.
  • amount_is_percentage — boolean

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• delete_fee destructive

  Delete a direct fee row.

  Parameters:

  • id (required) — string — Boat id, from list_boats.
  • fee_id (required) — string — Row id, from list_boat_fees.

  Hints: read-only no · destructive yes · idempotent not declared · open-world no

• list_calendars read-only

  The external calendars (iCal feeds, a Google Calendar by its secret iCal address) connected to one boat, with their sync state. MMK and Nausys are linked automatically and are not listed here. An empty list means none is connected to that boat.

  Parameters:

  • boat_id (required) — string — Boat id, from list_boats.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• add_calendar

  Connect an external calendar to a boat: its events block those dates on charter.boats. Returns the stored source; sync_calendar pulls it at once.

  Parameters:

  • boat_id (required) — string — Boat id, from list_boats.
  • source_name (required) — string — A name for it.
  • source_url (required) — string — The https iCal address.
  • source_type — string — Default `ical`.

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• remove_calendar destructive

  Disconnect an external calendar: its blocked dates are freed, and the holds X-Lock placed for them on the partner calendars are released.

  Parameters:

  • id (required) — string — Source id, from list_calendars.

  Hints: read-only no · destructive yes · idempotent not declared · open-world no

• sync_calendar

  Pull one external calendar now. Returns how many events it brought in, or the error the feed gave.

  Parameters:

  • id (required) — string — Source id, from list_calendars.

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• get_availability read-only

  The company's fleet calendar: every boat with its partner links, and every event that takes dates — bookings, options, blocks and synced partner or iCal events — each with its source. Read it before add_block to see what a range already holds.

  Parameters:

  • company_id (required) — string — Company id, from list_boats (`company_id`) or get_company.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• add_block

  Block dates on one of the operator's boats so they cannot be booked. On a partner-synced boat the hold is placed on that partner too, and with X-Lock on also on the other partner. Returns the stored block and how each hold went.

  Parameters:

  • boat_id (required) — string — Boat id, from list_boats.
  • start_at (required) — string — First day, YYYY-MM-DD.
  • end_at (required) — string — Last day, YYYY-MM-DD.
  • notes — string
  • reason — string

  Hints: read-only no · destructive no · idempotent not declared · open-world no

• remove_block destructive

  Remove a block the operator placed, freeing its dates and releasing the partner holds it placed.

  Parameters:

  • id (required) — string — Block id: `block_id` on the event in get_availability, or `id` from add_block.

  Hints: read-only no · destructive yes · idempotent not declared · open-world no

• list_bookings read-only

  Every booking on the operator's boats, newest charter first. `status` and `payment_status` give the stage: `waitlist` is On waitlist (queued behind another hold), unpaid `pending` or `accepted` is an Option that lapses at `hold_expires_at`, and a booking with money in is booked. Each row states the price the guest pays, the discounts and the operator's own payout, in the currency of `payout_money`. Read-only: bookings are handled on the dashboard. An empty list means no bookings yet.

  Parameters:

  • boat_id — string — Optional: one boat only.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_booking read-only

  One booking in full: stage (as in list_bookings), dates, guest, price lines, the operator's payout and `payout_schedule`, the payments coming to the operator with their due dates (empty until the booking is paid). Read-only.

  Parameters:

  • id (required) — string — Booking id, from list_bookings.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_earnings read-only

  The company's earnings: total and monthly payouts, payouts still pending on accepted bookings, and the latest bookings, in the currency the operator is paid in.

  Parameters:

  • company_id (required) — string — Company id, from list_boats (`company_id`) or get_company.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• get_opportunities read-only

  The company's Opportunities, as the dashboard's Analysis page shows them, read-only. `boats`: every published boat in the dashboard's order (the charted ones first, then by open weeks), with `open_weeks`, `vs_similar_pct` and `compare_url`, its public compare page. `vs_similar_pct` is how far the boat's weekly price sits over (positive) or under (negative) similar boats, as a median over the weeks it can be sold, each week against the median of the other operators' boats among up to 10 boats most like it of the same type in the same country, where at least 3 of them are priced (null: no week to compare). `price_suggestions`, up to five: `no_prices` (boats with no priced week in the next 12 months), `under` (a boat 15% or more under similar boats, with its widest week: `week`, `own`, `similar`), `over` (a run of two or more weeks 15% or more over them: `from`, `to` and the `own` and `similar` weekly ranges). `source_checks`, up to five: `feature` (kit sold as an extra but missing from the boats' equipment, so guests filtering for it do not see them), `photos` (boats with under half the photos similar boats have; `similar` is their median), `standout` (what Mermaid and the compare page tell guests a boat trails similar boats on). Figures are weekly totals in EUR, all in at max guests. Empty lists mean nothing to suggest.

  Parameters:

  • company_id (required) — string — Company id, from list_boats (`company_id`) or get_company.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.