Resortlife Travel: Esoru MCP server for the Maldives
Esoru is the read-only Maldives catalogue that Resortlife Travel publishes as a remote Model Context Protocol server. It lets an AI assistant look up resorts, guesthouses, villas, dining, spas, dive sites, surf breaks, wildlife seasons, 360-degree tours, photos and the Velana airport board, then answer from the same catalogue the Resortlife website uses. In supporting apps the answers can show photo cards.
This repository holds the plugin metadata and an agent skill for directories that list MCP servers. It contains no server code: the server is hosted by Resortlife Travel.
- Server name:
resortlife(title "Resortlife Travel") - 21 tools, all read-only
- Setup guide: resortlife.travel/mcp
- Developer docs: resortlife.travel/docs
Endpoint
https://resortlife.travel/api/mcp
- Transport: Streamable HTTP (stateless JSON responses)
- Authentication: none. There is no login, account or API key to set up for public use.
- Opening the address in a browser leads to the setup guide.
- Server card: resortlife.travel/api/mcp/server-card
Quick check from a terminal:
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":"tools/list"}'
Connect
The steps below name each app's own menus, which change from time to time. The full, current guide with one-click buttons is at resortlife.travel/mcp.
Claude
- Open Add Resortlife to Claude. Claude opens with the name and address filled in. Sign in if it asks.
- Press Continue. Under Authentication, choose No sign in, then press Add. If the boxes are empty, press + Add, then Add custom connector, and enter the name
Resortlifeand the addresshttps://resortlife.travel/api/mcp. - Start a new chat. Press +, then Connectors, and switch Resortlife on. If Claude asks to display the cards, choose Allow.
The free plan can add one connector. On Team and Enterprise plans, an owner has to add it for the team before members can use it.
ChatGPT
- Open your plugins in ChatGPT (chatgpt.com/plugins) and sign in if it asks.
- Press +, then Add custom MCP server.
- Enter the name
Resortlife. Pastehttps://resortlife.travel/api/mcpunder Connection. - Choose no authentication, tick I understand and want to continue, then press Create as a plugin.
- Start a new chat and pick Resortlife from the tools menu.
If you do not see the option, your plan or workspace may not allow it. Answers come through as text if ChatGPT does not display the photo cards.
Cursor
Open ~/.cursor/mcp.json, or .cursor/mcp.json for one project, add the server and save the file:
{
"mcpServers": {
"resortlife": {
"url": "https://resortlife.travel/api/mcp"
}
}
}
Cursor's documentation says it can display app views, so the photo cards may show.
VS Code
Open the Command Palette and run MCP: Add Server, choose HTTP and paste the address. Or add the server to .vscode/mcp.json:
{
"servers": {
"resortlife": {
"type": "http",
"url": "https://resortlife.travel/api/mcp"
}
}
}
VS Code lists app views as experimental. To try the photo cards, turn on the chat.mcp.apps.enabled setting.
Claude Code
claude mcp add --transport http resortlife https://resortlife.travel/api/mcp
Answers can come through as text in Claude Code. For the photo cards, use Claude's chat.
Codex
Add the server to ~/.codex/config.toml:
[mcp_servers.resortlife]
url = "https://resortlife.travel/api/mcp"
Gemini CLI
Add the server to ~/.gemini/settings.json. Use httpUrl: a plain url means an older connection type.
{
"mcpServers": {
"resortlife": {
"httpUrl": "https://resortlife.travel/api/mcp"
}
}
}
Hermes Agent
This repository is also an Agent Plugins v1 package (plugin.json, mcp.json and skills/), so Hermes Agent can install it:
hermes plugins install raidwaleed/resortlife-mcp --no-enable
hermes plugins enable resortlife
The package marks the server as untrusted, which asks Hermes to confirm any tool call that is not annotated read-only. Every Esoru tool is annotated read-only.
Other apps
Open the place your app adds remote MCP servers and paste https://resortlife.travel/api/mcp. The transport is Streamable HTTP, and there is no login. Apps that do not display cards show the same answer as text.
Step-by-step pages for every app, with buttons: resortlife.travel/mcp.
Tools
Every tool is read-only. Descriptions are copied from the live tools/list response, with some clauses cut for length.
| Tool | Title | Description |
|---|---|---|
search_resorts | Search resorts | Search the Maldives accommodation catalog by name, atoll, star class, transfer mode, meal plan and experience. Results list resorts before guesthouses and are not a ranking by quality. Can also narrow to a short transfer from the airport or to stays with a 360° tour. Returns compact summaries. |
resolve_resort | Resolve a resort name to its slug | Turn a loosely-written resort name into its canonical slug and a confidence score. Handles the real-world drift between how a resort is written and how it is stored — "Soneva Fushi" vs "SonevaFushi", missing or extra suffix words. A score below 0.6 is not a confident match. |
get_resort | Get a resort dossier | Full record for one property: location, transfers, meal plans, room/dining counts, policies, sustainability, brand detail, a few photographs and its 360° tour when published. Optionally attaches the child catalogues (villas, dining, spa, dive, experiences) in the same call. |
list_villas | List villas | Room and villa categories for a resort: size, occupancy, bed config, view, overwater/pool/beach flags and inclusions. Pricing is excluded. |
list_dining | List dining venues | Restaurants and bars at a resort: cuisine, style, setting, dress code, signature dishes. Pricing and priced menu documents are excluded. |
list_spas | List spa venues | Spa and wellness facilities: operating brand, setting, treatment rooms, couples suites, signature treatments and specialties. |
list_dive_centres | List dive centres | Dive operations: operator, PADI level, courses, instructor languages, house reef quality, named dive sites and the marine life encountered there. |
list_experiences | List resort experiences | Activities and excursions offered at a resort: type, category, duration, what is included and any age restriction. |
compare_resorts | Compare resorts | Side-by-side comparison of 2-6 properties on a fixed attribute set (location, transfers, scale, board, tier, experience tags). |
similar_resorts | Find similar resorts | Nearest alternatives to a given property, matched on atoll, tier, transfer mode and experience profile. |
list_atolls | List atolls | The Maldives atolls carrying accommodation, with resort counts and lagoon centroid coordinates. Optionally includes each atoll's resort roster. |
catalog_stats | Catalog coverage | How much of the Maldives this catalog actually covers — visible property count and atoll count. |
get_resort_gallery | Get a resort's photo gallery | Photography for one property, in the site's own display order. Returns direct image URLs with category and photo credit where recorded. |
list_vr_tours | List published 360° tours | Every resort with a published self-hosted 360° virtual tour, with scene counts and a thumbnail. |
get_vr_tour | Get a 360° tour's scene list | The scene graph for one published 360° tour: every panorama with its title, category and panorama image URLs: what a guest can walk through before booking. |
find_nearby | Find places near a resort, dive site or surf break | What is close to a named place on the Maldives map: resorts, guesthouses, dive sites, surf breaks and restaurants at other properties, with a mix of kinds and straight-line distance. Distance is not travel time. |
list_dive_sites | List Maldives dive sites | Named dive and snorkel sites with depth, skill level, current, season and the species seen there. These are sites, not resort dive centres. |
get_dive_site | Get a dive site | Full record for one dive site, including its description, photo with credit, protected status and marine-welfare guidance. |
list_surf_breaks | List Maldives surf breaks | Named surf breaks with a verified position: wave type, skill level, season, hazards and the nearest property. |
when_to_see | When and where to see marine life | Where and in which months to see an animal in the Maldives: manta rays, whale sharks, turtles, hammerheads and others. Gives the species' season, the sites that list it with each site's stated season, a month-by-month count, and the nearest stays to each site by straight line. With a month, sites stated as out of season are left out and counted. Never promises a sighting. |
get_male_flights | Flights on the Velana (Malé) airport board | Current arrivals and departures on the board at Velana International Airport, Malé: scheduled and estimated times in Maldives time, status, terminal. The feed block reports whether the board is live and when it last updated. |
Guided prompts are also offered through prompts/list: plan_honeymoon, see_marine_life, plan_family_stay, compare_shortlist, tour_before_booking and check_arrival.
Example questions
Once the connector is on, try:
- "Use Resortlife to show me resorts in Baa Atoll with manta rays and overwater villas."
- "Use Resortlife to find honeymoon resorts with overwater villas, reached from Malé by speedboat."
- "Use Resortlife to tell me where I can see manta rays in August."
- "Use Resortlife to find resorts within 30 minutes of Malé."
- "Use Resortlife to show me resorts I can walk through in a 360° tour before I book."
- "Use Resortlife to compare Soneva Fushi and Milaidhoo side by side."
- "Use Resortlife to list dive sites in South Ari Atoll where I might see whale sharks."
- "Use Resortlife to check the arrivals on the Velana airport board."
What it does not do
Esoru is a research catalogue. It does not give prices, rates, availability, offers, ratings or reviews, and it cannot make a booking. The Resortlife team handles those. To talk to the team, use the contact page or write to maldives@resortlife.travel. Travel agents can register for the agent portal.
Other boundaries:
- A missing detail means unknown, not confirmed absent.
- Distances are straight lines, not travel times.
- Wildlife seasons follow the catalogue and never promise a sighting.
- The airport board is not a timetable and cannot confirm a connection.
- Please do not send personal or payment details to these tools.
Limits
- Read-only: no tool changes anything.
- Public use is limited to 120 requests a minute per address without a login, plus a daily limit across all public use. A
429reply carries aRetry-Afterheader. - Partner agencies can be issued a key with its own limits. See the developer docs and the agents page.
Data and network
- This repository holds no code. Every tool call is an HTTPS request to
https://resortlife.travel/api/mcp, which Resortlife Travel operates. What you ask a tool, such as search words or a resort name, is sent there. - No sign-in, API key or other credential is needed, and none is stored.
- The server keeps daily counts of calls by tool name and by assistant family (for example Claude or Cursor). Those counts hold no address, no arguments and no question text.
- The request limit is applied to a hash of the caller's address, not the address itself.
- The site's hosting keeps standard access logs. See the privacy policy.
Skill
skills/esoru-maldives-trip-planner/SKILL.md teaches an assistant how to plan a Maldives trip with these tools: which tool to use for which question, and when to hand over to the Resortlife team. The skill needs the connector above to reach the catalogue.
Install it with the skills CLI:
npx skills add raidwaleed/resortlife-mcp
In Claude you can instead upload the ZIP from resortlife.travel/mcp under Customize, then Skills (code execution has to be on). In Claude Code, unzip it into ~/.claude/skills/.
Links
- Website: resortlife.travel
- Setup guide: resortlife.travel/mcp
- Developer docs: resortlife.travel/docs
- Travel-agent sign-up: resortlife.travel/agents
- Contact: resortlife.travel/contact, maldives@resortlife.travel
- Endpoint:
https://resortlife.travel/api/mcp
Resortlife is independent and is not affiliated with, or endorsed by, Anthropic, OpenAI, Anysphere, Microsoft, Google or Nous Research. Product names belong to their owners.
README from the reviewed commit 9fe108e; it updates when the author re-pins.

Resortlife Travel