search_yachtsSearch yachts
Find this site's yachts, read from the live inventory. Pass what the person wants as the typed filters, and from / to whenever they gave exact days. With dates it returns ONLY the yachts free for that stay, each with its stay: status, price, list price, discount and when the source was checked (checkedAt). Without dates each has its from-price. Every row carries its page link and one photo, absolute URLs on this site; send the person there. Narrow with the typed filters (each list is any of its values; every filter must hold); priceMin / priceMax count the mandatory extras a quote states. notApplied lists what could not narrow the search. When nothing matches exactly the answer is the nearest match, and nearest says what was widened (another week, the place around, a bound let go): tell the person. Paged: total and cursor. Works without a contact (browsing: fewer rows).
| Parameter | Type | ||
|---|---|---|---|
from | string | optional | Check-in day, YYYY-MM-DD. |
to | string | optional | Check-out day, YYYY-MM-DD. |
party | number | optional | How many people. |
yacht_types | string[] | optional | Yacht Types: any of these value ids (one or more): catamarans (Catamarans, 3192); gulets (Gulets, 201); houseboats (Houseboats, 1428); motorboats (Motorboats, 1080); sailboats (Sailboats, 4577). |
charter_types | string[] | optional | Charter Types: any of these value ids (one or more): all-inclusive (All-inclusive, 68); bareboat (Bareboat, 8796); cabin-charter (Cabin charter, 152); crewed (Crewed, 1702); day-charter (Day charter, 374); flotilla (Flotilla, 257); regatta (Regatta, 34); skippered (Skippered, 245). |
place | string | optional | Where, in words or as a place id: a region, country or area, and everything in it, e.g. Mediterranean, Worldwide, Caribbean, North America, Greece, Croatia, Italy, France, Turkey, Spain, British Virgin Islands, Netherlands, Germany, Seychelles, Poland, Ireland, Martinique, United Kingdom, Belgium, Portugal, Ecuador, French Polynesia, Sweden, St. Martin, Bahamas, Malta, Montenegro, Thailand, Canada, St. Lucia, Slovenia, Norway, Guadeloupe, Brazil, Hungary, Grenada, St. Vincent, Belize, Cuba, Maldives, Mexico, Panama, Cape Verde, United Arab Emirates, Antigua and Barbuda, India, Tanzania, Egypt, Monaco, Estonia, Mauritius, New Zealand, USA, Switzerland, Fiji. An unknown place is refused; nothing there answers the nearest place around it. |
base | string | optional | The exact base it leaves from, in words. |
text | string | optional | Words in its name or model, e.g. a builder or a model name. |
lengthMin | number | optional | Length at least ft (on this site 13.35 to 180.45). |
lengthMax | number | optional | Length at most ft (on this site 13.35 to 180.45). |
cabinsMin | number | optional | Cabins at least (on this site 0 to 20). |
cabinsMax | number | optional | Cabins at most (on this site 0 to 20). |
berthsMin | number | optional | Berths at least (on this site 0 to 80). |
berthsMax | number | optional | Berths at most (on this site 0 to 80). |
headsMin | number | optional | Heads at least (on this site 0 to 23). |
headsMax | number | optional | Heads at most (on this site 0 to 23). |
beamMin | number | optional | Beam at least m (on this site 0.9 to 44). |
beamMax | number | optional | Beam at most m (on this site 0.9 to 44). |
draftMin | number | optional | Draft at least m (on this site 0.3 to 7985). |
draftMax | number | optional | Draft at most m (on this site 0.3 to 7985). |
yearMin | number | optional | Year at least (on this site 0 to 2028). |
yearMax | number | optional | Year at most (on this site 0 to 2028). |
fuelMin | number | optional | Fuel tank at least l (on this site 1 to 65000). |
fuelMax | number | optional | Fuel tank at most l (on this site 1 to 65000). |
waterMin | number | optional | Water tank at least l (on this site 1 to 60000). |
waterMax | number | optional | Water tank at most l (on this site 1 to 60000). |
priceMin | number | optional | The least to pay, in the site currency: the price plus the mandatory extras. |
priceMax | number | optional | The most to pay, in the site currency: the price plus the mandatory extras. |
discountOnly | boolean | optional | true: only those with a discount the source states. |
sort | stringprice | discount | length | cabins | berths | heads | beam | draft | year | fuel | water | optional | price (default, cheapest first), discount (biggest first), or length (length, biggest first), cabins (cabins, biggest first), berths (berths, biggest first), heads (heads, biggest first), beam (beam, biggest first), draft (draft, biggest first), year (year, biggest first), fuel (fuel tank, biggest first), water (water tank, biggest first). |
cursor | string | optional | The cursor a previous answer returned, for its next page. |
limit | number | optional | Rows per page: at most 10 when browsing, 20 with the person's email or phone. |
The person's contact (email, phone, session, name)
| Parameter | Type | ||
|---|---|---|---|
email | string | optional | Optional: the person's own email, as they gave it, for more rows a call. Leave out to browse; the site keeps it to answer their enquiry. |
phone | string | optional | Optional: the person's own phone, international form (+ and country code), as they gave it, for more rows a call. Leave out to browse. |
session | string | optional | The session an earlier answer returned. Pass it instead of email or phone from then on. |
name | string | optional | Optional: the person's name, as they gave it. |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_yachts",
"arguments": {
"from": "2026-12-01",
"to": "2026-12-08",
"party": 4,
"limit": 2
}
}
}{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "{\"items\":[{\"name\":\"string\",\"href\":\"https://thecharterdesk.com/yachts/2-drunk-6358727140000106731\",\"image\":{\"src\":\"string\",\"alt\":\"string\"},\"kind\":\"string\",\"priceFrom\":0,\"currency\":\"string\",\"mandatoryExtras\":{\"amount\":0,\"currency\":\"string\",\"text\":\"string\"},\"stay\":{\"checkIn\":\"2026-12-01\",\"checkOut\":\"2026-12-08\",\"nights\":0,\"status\":\"free\",\"price\":{\"amount\":0,\"currency\":\"string\",\"text\":\"string\"},\"listPrice\":{\"amount\":0,\"currency\":\"string\",\"text\":\"string\"},\"discountPct\":0,\"mandatoryExtras\":{\"amount\":0,\"currency\":\"string\",\"text\":\"string\"},\"deposit\":{\"amount\":0,\"currency\":\"string\",\"text\":\"string\"},\"checkedAt\":\"2026-11-01T06:00:00Z\"}}],\"total\":0,\"cursor\":\"string\",\"checked\":true,\"checkedAt\":\"2026-11-01T06:00:00Z\",\"notApplied\":[\"string\"],\"unchecked\":[\"string\"],\"leftOutUnpriced\":0,\"nearest\":{\"widened\":\"dates\",\"note\":\"string\"},\"browsing\":true,\"next\":\"string\",\"session\":\"string\",\"sessionExpiresAt\":\"2026-12-01T06:00:00Z\"}"
}
],
"structuredContent": {
"items": [
{
"name": "string",
"href": "https://thecharterdesk.com/yachts/2-drunk-6358727140000106731",
"image": {
"src": "string",
"alt": "string"
},
"kind": "string",
"priceFrom": 0,
"currency": "string",
"mandatoryExtras": {
"amount": 0,
"currency": "string",
"text": "string"
},
"stay": {
"checkIn": "2026-12-01",
"checkOut": "2026-12-08",
"nights": 0,
"status": "free",
"price": {
"amount": 0,
"currency": "string",
"text": "string"
},
"listPrice": {
"amount": 0,
"currency": "string",
"text": "string"
},
"discountPct": 0,
"mandatoryExtras": {
"amount": 0,
"currency": "string",
"text": "string"
},
"deposit": {
"amount": 0,
"currency": "string",
"text": "string"
},
"checkedAt": "2026-11-01T06:00:00Z"
}
}
],
"total": 0,
"cursor": "string",
"checked": true,
"checkedAt": "2026-11-01T06:00:00Z",
"notApplied": [
"string"
],
"unchecked": [
"string"
],
"leftOutUnpriced": 0,
"nearest": {
"widened": "dates",
"note": "string"
},
"browsing": true,
"next": "string",
"session": "string",
"sessionExpiresAt": "2026-12-01T06:00:00Z"
},
"isError": false
}
}Errors
invalid_emailThat email address does not look right; ask the person for it again.Ask the person to give their email again.invalid_phoneGive the phone number in international form, a plus and the country code first, e.g. +31612345678.Ask the person for the number with its country code.contact_revokedThe owner of this contact said they did not ask for this. Use a different contact.Ask the person for a different email or phone.rate_limitedToo many calls for this person or address this hour.Wait retryAfterSeconds, then call again.browse_limitedThis address has browsed as much as this site answers without a contact for now.Ask the person for their email or phone and pass it as email or phone, or call request_quote.browse_busyThis site has answered as many browse calls today as it answers without a contact.Ask the person for their email or phone and pass it as email or phone, or call request_quote.browse_page_limitBrowsing without a contact shows the first pages only.Ask the person for their email or phone and pass it as email or phone, or call request_quote.read_refusedThe read could not answer these arguments.Read the message: it says what to change (a date format, a place name, which of several items).