YachtLuma
Developers

API documentation

Query published yacht models, builders, places and market records through REST or MCP. Explore the response for your language before integrating.

Resources

Yacht models
GET /api/v1/models
Onboard equipment
GET /api/v1/equipment
Charter departures
GET /api/v1/departures
Service providers
GET /api/v1/providers
Licensed media
GET /api/v1/media
curl -sS 'https://yachtluma.ai/api/v1/models/lagoon-42?locale=en'
curl -sS 'https://yachtluma.ai/api/v1/compare?models=lagoon-42,lagoon-46&locale=en'

Pagination and filters

List requests accept limit from 1 to 100 and offset from 0. Send nextOffset as the next offset until it is null. Filter models by builder or type and listings by category.

curl -sS 'https://yachtluma.ai/api/v1/models?q=Lagoon&locale=en&limit=2&offset=0'
curl -sS 'https://yachtluma.ai/api/v1/listings?category=charter&locale=en&limit=5'
curl -sS 'https://yachtluma.ai/api/v1/departures?mode=seat&guests=2&location=Palma&limit=5'
curl -sS 'https://yachtluma.ai/api/v1/providers?service=maintenance&limit=5'
curl -sS 'https://yachtluma.ai/api/v1/media?entityType=model&entityId=lagoon-46&locale=en'

Field availability

Web, API and AI distribution follow the source permissions for each specification. A model may have an empty specifications array. Keep the status, unit, date and configuration when presenting a value.

specifications_status · available / not_available_for_this_channel

Applications and quotas

Anonymous traffic shares 10,000 requests per UTC day. Approved applications have an individual daily quota and access only their approved channels and resources. Send the application key in the Authorization header.

Authorization: Bearer <APPLICATION_KEY>
My applications

MCP

Connect an MCP client to the endpoint using Streamable HTTP. Run initialize, then tools/list for the current tool schemas. Calls read published records.

POST https://yachtluma.ai/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_models",
    "arguments": {
      "q": "Lagoon",
      "locale": "en",
      "limit": 3
    }
  }
}
  • search_models
  • search_builders
  • search_listings
  • find_marinas
  • search_equipment
  • search_knowledge
  • get_model
  • get_listing
  • get_equipment
  • get_care_guide
  • compare_models
  • search_yacht_pages
  • get_market_counts
  • search_departures
  • get_departure
  • search_providers
  • get_provider
  • search_media
  • get_media
  • estimate_charter_budget