io.github.tell-and-go/mcp

Book real travel from any AI agent

No account · No API key · Same prices as our site · Payment on a hosted Stripe checkout 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 travel agency as a public MCP that works in every agent — before the big OTAs did.

Tools

Typical flow: search_stays → get_stay_details → get_quote → prebook_stay → start_booking

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 prebook_stay to lock the rate, then start_booking to receive the hosted 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.

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 hosted Stripe checkout link on tellandgo.com. The agent never touches card data; the traveler completes payment securely.

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 · Made for agents, built for humans.

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