Send a boat from your AI
Using ChatGPT, Claude or another AI to find boats? Ask it to send a boat it found to your saved boats.
When I'm looking at a boat, or want to compare boats, send them to liveaboardhq.com/ai so it can rank them, and give me the link.
Instructions for AI assistants (your AI reads these)
# Send a boat to Liveaboard HQ
> For AI assistants. Your user is shopping for a boat to live aboard and wants to add a boat you found to their saved boats on Liveaboard HQ. You send a trimmed copy of the listing you already read; Liveaboard HQ reads the facts out of it and never fetches the listing itself.
Still looking for boats? Read the buying guide first: https://liveaboardhq.com/ai/guide
## Quick start
Send one boat as `{ "type", "url", "excerpt" }`: its type, the listing's address, and an excerpt of the listing with the boat's facts. One boat per send: to add another boat, do this again for that boat.
## What to do
1. Work from the listing text you have read, or listing text your user gives you. If you can't read the listing with your normal tools, ask your user to paste the listing text.
2. Write the excerpt. Aim for under 4,000 characters. Follow these rules:
- Open with the year, the builder, the full model and the boat's own name, each as the listing gives it.
- Keep every fact about the boat itself. Drop only sales language, lifestyle description, repeated blocks, contact details and boilerplate.
- Copy numbers, units and model names exactly as written. Do not convert, round, total or average anything.
- List each engine, generator, AC unit, battery bank and anchor separately, with its own hours, size and position (port, starboard).
- Keep the words around a number: approx, new, original, upgraded 2022, rebuilt, needs servicing, not working, as is.
- Keep any date next to engine or generator hours.
- Keep every statement that something is not on the boat, like "no watermaker".
- Keep each tank's count and size, and keep jerry cans as a separate item.
- If the listing gives two figures for one thing, keep both and say where each came from.
- If there is a spec or equipment list, include it as written.
- Leave out names, phone numbers, emails and links of the seller or broker.
- Do not add anything the listing does not say, and do not list what it does not mention.
3. Choose `type`: one of `sailing-monohull`, `sailing-catamaran`, `sailing-trimaran`, `power-catamaran`, `power-trimaran`, `motor-vessel`. A trawler is `motor-vessel`. If the listing doesn't say it, choose it from the boat's make and model.
4. Send it, in the first way you can:
- In a browser that offers WebMCP tools: Liveaboard HQ's pages (not its sign-in, messages or dashboard screens) offer the tool `prepare_boat_import`. Call it with the JSON.
- If you can make HTTP requests: POST the JSON to `https://liveaboardhq.com/api/ai/boat` with `Content-Type: application/json`.
- Otherwise: give your user the link `https://liveaboardhq.com/ai/import#` followed by the JSON, URL-encoded (encodeURIComponent). If you can run code, build the link with code so the encoding is exact.
5. Read the reply (the tool and the POST answer the same way). On success it is `{ "ok": true, "url": "...", "title": "2021 Leopard 45", "factsKept": 41, "stillMissing": ["fresh water", ...] }`. Give your user the `url`. `stillMissing` names systems Liveaboard HQ found no number for: if the listing states one you left out, send the excerpt again with it added.
If the reply is `{ "ok": true, "status": "reading", "url": "..." }`, the boat is still being read: give your user that url now and do not send the boat again. It opens the same boat when the read is done.
6. On `ok: false`, `issues` says what went wrong. If the reply has a `fallbackUrl`, give your user that link instead; it opens the same boat once they press Read.
Tell your user: open the link and save the boat. Liveaboard HQ reads the facts from your excerpt and does not check them against the full listing.
## The JSON
The same contract as JSON Schema: https://liveaboardhq.com/ai/schema.json
```json
{
"type": "sailing-catamaran",
"url": "https://example.com/listing/2021-leopard-45",
"excerpt": "2021 Leopard 45, owner's version, 3 cabins, 3 heads. Asking USD 765,000. Lying Annapolis, MD.\nEngines: port Yanmar 4JH45 45 hp, 898 hrs; starboard Yanmar 4JH45 45 hp, 905 hrs (hours as of 03/2025).\nHouse bank: 900Ah lithium, 12V. Solar: 4 x 375W. Inverter: Victron Quattro 5kVA.\nGenerator: Northern Lights 9 kW, 360 hrs. No watermaker.\nTanks: fuel 185 gal, water 206 gal, holding 45 gal.\nAnchor: Rocna 33 kg, 200 ft chain."
}
```
- `excerpt` (required): plain text, the trimmed listing.
- `type`: the boat type. Send it; without it, the boat may not be readable.
- `url`: the listing you read (optional).