Tell And Go MCP

Book real travel from any AI agent

No account · No API key · Same prices as our site · Payment on Tell & Go's own checkout at tellandgo.com, which your agent never touches

Tell & Go runs a public Model Context Protocol server. Connect any AI agent — Claude, ChatGPT, Cursor, Gemini CLI, Hermes, OpenClaw, or your own — and it can search live resort inventory, get exact live dated quotes, and start a real booking that completes on our secure checkout page.

[!IMPORTANT]

This repository is documentation only. The server is hosted at

https://mcp.tellandgo.com/mcp — there is nothing to install or run.

---

Connect in 30 seconds

One endpoint works in every MCP client:

Cursor / VS Code / Gemini CLI — add to your MCP config (~/.cursor/mcp.json, VS Code MCP settings, etc.):

{

"mcpServers": { "tellandgo": { "url": "https://mcp.tellandgo.com/mcp" } } }

Prefer a ready-made pack? skills/ has a standard SKILL.md, the legacy tellandgo-travel.md, and per-client SETUP.md. Coding agents can start with AGENTS.md.

Install the standard skill into a supported coding agent with npx skills add https://github.com/tell-and-go/mcp --skill book-travel-with-tellandgo.

---

Why this exists

Booking.com and Expedia built AI agents inside their own apps. We did the opposite: we opened our booking service as a public MCP that works in *every* agent — before the big OTAs did.

---

Tools

Typical flow: search_stays → get_stay_details → get_quote → start_booking. Search results are paged: when pagination.has_more is true, call again with next_offset before saying you have shown every option. budget_min/budget_max are per night, so divide a whole-stay budget by the number of nights.

Example JSON-RPC calls

The MCP transport speaks JSON-RPC 2.0 over streamable-HTTP.

Initialize the session

{

"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": { "protocolVersion": "2025-06-18", "capabilities": {}, "clientInfo": { "name": "my-agent", "version": "1.0.0" } } }

List available tools

{ "jsonrpc": "2.0", "id": 2, "method": "tools/list", "params": {} }

Search for stays

{

"jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": { "name": "search_stays", "arguments": { "query": "overwater villa in the Maldives for a honeymoon in October, all-in with seaplane transfer", "check_in": "2026-10-12", "check_out": "2026-10-19", "adults": 2 } } }

Follow up with get_quote for an exact dated total, then start_booking with the quote_id and residency to receive the tellandgo.com checkout link the traveler completes.

Try it with curl

# MCP handshake

curl -X POST https://mcp.tellandgo.com/mcp \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"initialize"}'

List tools

curl -X POST https://mcp.tellandgo.com/mcp \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

---

What it can book

Curated, verified-bookable hotel & resort stays. The live set of destinations grows all the time — see the current coverage at [tellandgo.com/en/destinations](https://tellandgo.com/en/destinations).

Each new market simply grows the catalog behind the same endpoint — your agent

doesn't need to change anything.

---

Pricing

Free to connect. No account, no API key, no cost. Prices shown by the tools follow the same live rate and checkout flow as tellandgo.com. Check each quoted rate's meal plan, transfer inclusion, taxes, cancellation terms, and total before presenting it to the traveler. We never add a special markup for agent users.

[!NOTE]

Fair use: ~60 requests/minute per IP, a tighter budget on

search/quote/booking, and a global ceiling. Excess traffic gets 429 +

Retry-After. Building a product on this? Reach out for higher throughput.

---

FAQ

Is it free? Yes. No account, no API key, no cost to connect.

Are the prices the same as the website? The live quoted rate is the source of truth. Transfer inclusion and meal plans depend on the selected rate.

How does payment work? start_booking returns a checkout link on tellandgo.com. The traveler enters guest details, sees the final total and pays there. The agent never touches card data. No booking exists until the traveler completes checkout; on a Reserve now, pay later rate that happens with nothing charged today.

Is it safe? Search and quote are read-only. Booking only produces a checkout link you choose to complete — the MCP cannot charge anyone on its own. Tool annotations ( readOnlyHint , openWorldHint ) are set honestly.

Which MCP spec version? 2025-06-18 . The server also answers 2024-11-05 for older clients.

---

Links

• 🌐 Landing page: https://tellandgo.com/mcp
• 📋 Discovery manifest: https://tellandgo.com/.well-known/mcp.json
• 🤖 `llms.txt`: https://tellandgo.com/llms.txt
• 📖 Full inventory reference: https://tellandgo.com/llms-full.txt
• 📦 Registry manifest: server.json · glama.json
• 🗂️ Find it on: Official MCP Registry (io.github.tell-and-go/mcp) · Smithery · Glama
• 📝 Changelog: CHANGELOG.md

---

[Tell & Go](https://tellandgo.com) · Made for agents, built for humans.

Documentation © 2026 Island Inventions, Inc. — released under the MIT License.