search_yachtsSearch yachts
Use it when the person describes the yachts they want: where, when, how many people, a size, a type or a budget. Pass each wish as its typed filter (a list is any of its values; every filter must hold), and from / to whenever they gave exact days. With dates every row is free for that stay and carries its price, list price, discount and when the source was checked (checkedAt); without dates each row has its from-price. priceMin / priceMax count the mandatory extras. Every row links to its page on this site, with a photo: send the person there. notApplied lists the wishes that could not narrow the search. When nothing matches exactly, the rows are the nearest match and nearest says what was widened: tell the person. Paged: total and cursor. For deals or last-minute offers call best_deals; for what a stay costs before any dates, price_range; once they name or pick one, get_yacht.
| 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, 2892); gulets (Gulets, 148); houseboats (Houseboats, 1362); motorboats (Motorboats, 697); sailboats (Sailboats, 4143). |
charter_types | string[] | optional | Charter Types: any of these value ids (one or more): all-inclusive (All-inclusive, 47); bareboat (Bareboat, 7879); cabin-charter (Cabin charter, 98); crewed (Crewed, 1331); day-charter (Day charter, 217); flotilla (Flotilla, 225); regatta (Regatta, 33); skippered (Skippered, 281). |
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, British Virgin Islands, Spain, Netherlands, Germany, Seychelles, Ireland, Martinique, United Kingdom, Belgium, Ecuador, Sweden, Poland, Portugal, Bahamas, St. Martin, Malta, French Polynesia, Canada, St. Lucia, Montenegro, Thailand, Slovenia, Guadeloupe, Norway, Brazil, Hungary, Belize, St. Vincent, Grenada, Cuba, Panama, Maldives, Mexico, India, United Arab Emirates, Antigua and Barbuda, Tanzania, Cape Verde, Egypt, Mauritius, USA, New Zealand, Switzerland. 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 3000). |
berthsMax | number | optional | Berths at most (on this site 0 to 3000). |
headsMin | number | optional | Heads at least (on this site 0 to 23). |
headsMax | number | optional | Heads at most (on this site 0 to 23). |
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 | optional | none (default): recommended, sized to the party in the places with the most to book; price (cheapest first), discount (biggest first), or length (length, biggest first), cabins (cabins, biggest first), berths (berths, biggest first), heads (heads, 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 once the person is signed in. |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_yachts",
"arguments": {
"from": "2026-12-07",
"to": "2026-12-14",
"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\"},\"aiDiscount\":{\"percent\":0,\"price\":{\"amount\":0,\"currency\":\"string\",\"text\":\"string\"}},\"stay\":{\"checkIn\":\"2026-12-07\",\"checkOut\":\"2026-12-14\",\"nights\":0,\"status\":\"free\",\"price\":{\"amount\":0,\"currency\":\"string\",\"text\":\"string\"},\"listPrice\":{\"amount\":0,\"currency\":\"string\",\"text\":\"string\"},\"discountPct\":0,\"priceBasis\":\"quoted\",\"priceNote\":\"string\",\"aiDiscount\":{\"percent\":0,\"price\":{\"amount\":0,\"currency\":\"string\",\"text\":\"string\"}},\"mandatoryExtras\":{\"amount\":0,\"currency\":\"string\",\"text\":\"string\"},\"deposit\":{\"amount\":0,\"currency\":\"string\",\"text\":\"string\"},\"checkedAt\":\"2026-11-07T06:00:00Z\"},\"model\":\"string\",\"year\":0,\"base\":\"string\",\"country\":\"string\",\"gallery\":[{\"src\":\"string\",\"alt\":\"string\"}],\"facts\":[{}],\"terms\":{},\"soldAs\":{\"name\":\"string\",\"staffed\":true},\"extras\":{\"included\":[{\"name\":\"string\",\"amount\":{\"amount\":null,\"currency\":null,\"text\":null},\"percentOfPrice\":0,\"per\":\"string\",\"perPerson\":true,\"paid\":\"string\"}],\"required\":[{\"name\":\"string\",\"amount\":{\"amount\":null,\"currency\":null,\"text\":null},\"percentOfPrice\":0,\"per\":\"string\",\"perPerson\":true,\"paid\":\"string\"}],\"optional\":[{\"name\":\"string\",\"amount\":{\"amount\":null,\"currency\":null,\"text\":null},\"percentOfPrice\":0,\"per\":\"string\",\"perPerson\":true,\"paid\":\"string\"}]},\"mainEquipment\":[\"string\"],\"onRequest\":[\"deposit\"]}],\"total\":0,\"cursor\":\"string\",\"withoutPhoto\":0,\"checked\":true,\"checkedAt\":\"2026-11-07T06:00:00Z\",\"notApplied\":[\"string\"],\"unchecked\":[\"string\"],\"leftOutUnpriced\":0,\"nearest\":{\"widened\":\"dates\",\"note\":\"string\"},\"browsing\":true}"
}
],
"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"
},
"aiDiscount": {
"percent": 0,
"price": {
"amount": 0,
"currency": "string",
"text": "string"
}
},
"stay": {
"checkIn": "2026-12-07",
"checkOut": "2026-12-14",
"nights": 0,
"status": "free",
"price": {
"amount": 0,
"currency": "string",
"text": "string"
},
"listPrice": {
"amount": 0,
"currency": "string",
"text": "string"
},
"discountPct": 0,
"priceBasis": "quoted",
"priceNote": "string",
"aiDiscount": {
"percent": 0,
"price": {
"amount": 0,
"currency": "string",
"text": "string"
}
},
"mandatoryExtras": {
"amount": 0,
"currency": "string",
"text": "string"
},
"deposit": {
"amount": 0,
"currency": "string",
"text": "string"
},
"checkedAt": "2026-11-07T06:00:00Z"
},
"model": "string",
"year": 0,
"base": "string",
"country": "string",
"gallery": [
{
"src": "string",
"alt": "string"
}
],
"facts": [
{}
],
"terms": {},
"soldAs": {
"name": "string",
"staffed": true
},
"extras": {
"included": [
{
"name": "string",
"amount": {
"amount": null,
"currency": null,
"text": null
},
"percentOfPrice": 0,
"per": "string",
"perPerson": true,
"paid": "string"
}
],
"required": [
{
"name": "string",
"amount": {
"amount": null,
"currency": null,
"text": null
},
"percentOfPrice": 0,
"per": "string",
"perPerson": true,
"paid": "string"
}
],
"optional": [
{
"name": "string",
"amount": {
"amount": null,
"currency": null,
"text": null
},
"percentOfPrice": 0,
"per": "string",
"perPerson": true,
"paid": "string"
}
]
},
"mainEquipment": [
"string"
],
"onRequest": [
"deposit"
]
}
],
"total": 0,
"cursor": "string",
"withoutPhoto": 0,
"checked": true,
"checkedAt": "2026-11-07T06:00:00Z",
"notApplied": [
"string"
],
"unchecked": [
"string"
],
"leftOutUnpriced": 0,
"nearest": {
"widened": "dates",
"note": "string"
},
"browsing": true
},
"isError": false
}
}Errors
invalid_argumentsAn argument does not fit the tool's schema.Read the message: it names the argument and what it takes. Fix that argument and call again; tools/list has each tool's schema.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 sign-in for now.Wait retryAfterSeconds, then call again. For a written quote, call request_quote with the person's own email or phone. Signed in, the reads answer more rows and pages.browse_page_limitBrowsing without sign-in shows the first pages only.For a written quote, call request_quote with the person's own email or phone. Signed in, the reads answer more rows and pages.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).