Quickstart

One search, end to end, with what comes back. The call below was made against the live server; prices are from the day it was made.

1. Connect

In Claude: Settings, Connectors, Add custom connector, and enter https://mcp.dyme.earth/api/mcp. Choose Connect and sign in with a Dyme account. Other assistants: Connect an assistant.

For a client you configure by file:

{ "mcpServers": { "dyme": { "url": "https://mcp.dyme.earth/api/mcp" } } }

Claude Code: claude mcp add --transport http dyme https://mcp.dyme.earth/api/mcp.

Sign-in finishes only for clients whose callback address Dyme has approved. Claude, ChatGPT and Meta Muse are approved. Claude Code, Cursor and most desktop clients sign in through a localhost callback, which the production server refuses; see For developers for how to get an address added.

2. Ask

Find me a hotel near Praça do Comércio in Lisbon, 22 to 25 December, two adults, in euros.

The assistant calls search_hotels:

{
  "destination": "Lisbon",
  "near": "Praça do Comércio",
  "checkin": "2026-12-22",
  "checkout": "2026-12-25",
  "adults": 2,
  "currency": "EUR"
}

3. What comes back

The result has two parts. The text is what the assistant's model reads; the structured content is the same facts as JSON, and the card is drawn from it.

Text (shortened):

Hotels in Praça do Comércio · 2026-12-22 → 2026-12-25

CHLOE'S TAKE (worked out from all 28 hotels found): Best value is TURIM Terreiro
do Paço Hotel at €98 a night. Vincci Baixa Suites Apartments at €122 is the best
rated and can be cancelled. Pousada de Lisboa at €249 is the closest to Praça do
Comércio, about a 1-minute walk.

1. TURIM Terreiro do Paço Hotel (★4, 8.5/10)  [hotel_id: lp8bbde]
   EUR 98/night · EUR 293.32 total · 0.13 mi from Praça do Comércio
   Cheapest rate: non-refundable · 7,069 reviews
2. Vincci Baixa Suites Apartments (★4, 9/10)  [hotel_id: lp42d92]
   EUR 122/night · EUR 365.96 total · 0.12 mi from Praça do Comércio
   Cheapest rate: free cancellation until 2026-12-06 · 104 reviews
…
trip_id: tr_…

Structured content (one hotel shown, ids shortened):

{
  "trip_id": "tr_…",
  "chloes_take": "Best value is TURIM Terreiro do Paço Hotel at €98 a night. …",
  "destination_resolved": "Praça do Comércio",
  "checkin": "2026-12-22",
  "checkout": "2026-12-25",
  "adults": 2,
  "total_available": 28,
  "shown": 3,
  "results": [
    {
      "hotel_id": "lp8bbde",
      "name": "TURIM Terreiro do Paço Hotel",
      "stars": 4,
      "rating": 8.5,
      "address": "Rua do Comércio, 9, Lisbon",
      "price_per_night": 97.77,
      "total_price": 293.32,
      "currency": "EUR",
      "photo_url": "https://static.cupid.travel/hotels/64561249.jpg",
      "distance_mi": 0.13,
      "free_cancellation": false,
      "opinion_label": "Best value",
      "booking_url": "https://travel.dyme.earth/hotels/lisbon-turim-terreiro-do-paco-hotel?checkin=2026-12-22&checkout=2026-12-25&adults=2",
      "offer_id": "…"
    }
  ]
}

In Claude and ChatGPT this draws a carousel of hotel cards. The assistant says Chloe's take in its own words and leaves the list to the card.

4. Follow up

Every follow-up takes the trip_id, so nothing is searched twice:

Ask	Tool	Arguments
"Only ones I can cancel"	`refine_hotels`	`{ "trip_id": "tr_…", "free_cancellation": true }`
"Tell me more about the Vincci"	`get_hotel_details`	`{ "hotel_id": "lp42d92" }`
"Show me its rooms"	`get_hotel_rates`	`{ "hotel_id": "lp42d92", "trip_id": "tr_…" }`
"Is that the best price?"	`compare_prices`	`{ "trip_id": "tr_…", "hotel_id": "lp42d92" }`
"Book it"	`review_booking`	`{ "trip_id": "tr_…", "hotel_id": "lp42d92" }`

review_booking checks the price again and answers with one Continue to checkout button. Checkout, sign-in and payment happen on travel.dyme.earth. See Booking and payment.

5. Flights

The same shape:

{ "from": "JFK", "to": "LHR", "depart_date": "2026-12-08", "return_date": "2026-12-15", "adults": 1, "cabin_class": "economy", "currency": "USD" }

search_flights answers with Chloe's take (best value, safest, most flexible), the fares, and a trip_id for refine_flights, compare_fare_options, compare_fares and review_booking.

Every tool and argument: the tool reference.