Esoru MCP · Documentation

Our island knowledge.
Inside your assistant.

Research Maldives resorts through the AI tools you already use. Search, compare and explore the published catalogue, with no login needed.

Connect your assistant Not a developer? Start here Read as Markdown

Read-only tools · No login needed · No booking actions

A practical example

From a question to a shortlist.

Step through the connection, the question and the catalogue response.

Connect once. No login needed.

Add https://resortlife.travel/api/mcp in a compatible assistant.

Every tool only reads the published catalogue.

Example 1 of 4

Connect your client.

Add the endpoint to any MCP client that supports remote servers. Connections directly from third-party browser pages are not supported.

Endpoint: https://resortlife.travel/api/mcp
Transport: Streamable HTTP
Login: None

Developer quick start

Initialize:

curl https://resortlife.travel/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"my-client","version":"1.0"}}}'

Send notifications/initialized, then tools/list. Use the negotiated MCP-Protocol-Version header on subsequent requests.

Registry metadata Postman collection

Tools for resort research.

Details depend on the data recorded for each property.

Discovery

search_resorts

Search resorts

resolve_resort

Resolve a resort name

get_resort

Resort profile

compare_resorts

Compare resorts

similar_resorts

Similar resorts

list_atolls

Atoll catalogue

catalog_stats

Catalogue coverage

Resort details

list_villas

Villas and rooms

list_dining

Dining venues

list_spas

Spas

list_dive_centres

Dive centres

list_experiences

Experiences

Media

get_resort_gallery

Resort photographs

list_vr_tours

Published 360° tours

get_vr_tour

Explore a 360° tour

Map

find_nearby

What is nearby

list_dive_sites

Dive sites

get_dive_site

Dive site details

list_surf_breaks

Surf breaks

when_to_see

When and where to see marine life

get_male_flights

Flights on the Velana airport board

Limits and agency keys.

Public access allows 120 requests per minute per client address, plus a daily limit across all public use. Assistants that share an address share that limit.

Partner agencies issued a key can keep sending Authorization: Bearer <your agency key>, which applies the tools and properties granted to that agency. Keys expire after 30 days. Keep them out of public collections and repositories. An invalid key is refused rather than treated as public access.

Directory evaluation

Directory maintainers can request a separate test profile: up to five selected public resorts, four discovery tools, 10 requests per minute and 200 per UTC day. It does not share a customer’s agency identity.

Agency limits depend on the grant. The standard administrative defaults are 30 requests per minute and 1,000 per UTC day. Handshakes and tool discovery count towards the budget.

When a request needs attention.

401 · Key refused: The key is invalid, expired or revoked. Remove the header for public access, or ask your account manager for renewal.
403 · Access restricted: The tool is outside an agency grant, or the request came from a third-party browser page. Use an MCP client.
429 · Request limit: Follow the Retry-After header before trying again.
503 · Try shortly: The catalogue is temporarily unavailable.

A tool response with isError: true explains an invocation problem. Check the arguments and resolve the property name again before retrying.

GET /api/mcp returns 405 because this endpoint does not provide a server-initiated event stream. Connect using your client’s Streamable HTTP transport.