Content
<img src="assets/icon-64.png" width="72" align="right" alt="GetMyHotels logo" />
# GetMyHotels · MCP Connector
> Search real hotels, get live prices, and check out — right inside your AI assistant.
**GetMyHotels** is a hosted [Model Context Protocol](https://modelcontextprotocol.io) server
that connects Claude, ChatGPT, Cursor, and any MCP-compatible client to live hotel
inventory. Search real availability and prices, compare options with interactive
widgets, and complete a payment-first checkout — all from chat.
| | |
| --- | --- |
| **Connector URL** | `https://mcp.getmyhotels.com` |
| **Transport** | Streamable HTTP |
| **Auth** | OAuth 2.1 + Dynamic Client Registration (guest search needs no sign-in) |
| **Registry** | [`com.getmyhotels/getmyhotels`](https://registry.modelcontextprotocol.io/v0/servers?search=getmyhotels) |
| **Docs & site** | <https://www.getmyhotels.com/mcp> |
> This repository is the **public home** for the connector — setup guides, the tool
> reference, and the registry manifest ([`server.json`](./server.json)). The server
> implementation itself is proprietary and is not included here.
## Add the connector
### Claude (claude.ai or Claude Desktop)
Settings → **Connectors** → **Add custom connector** → paste `https://mcp.getmyhotels.com` → **Connect**.
Guest search works immediately; signed-in tools trigger an OAuth sign-in the first time you use them.
### ChatGPT (Developer mode)
Settings → **Connectors** → **Create** → paste `https://mcp.getmyhotels.com`.
### Cursor / other MCP clients
Add a **remote** MCP server pointing at `https://mcp.getmyhotels.com`.
## Authentication
- **No sign-in needed** for search, pricing, hotel details, and creating a checkout link.
- **OAuth 2.1** unlocks saved trips, booking management, saved cards, and one-click
checkout. Clients register automatically via **Dynamic Client Registration** —
there is nothing to configure.
## Tools
### Search & research — no sign-in
| Tool | Description |
| --- | --- |
| `search_hotels` | Search live availability and prices for a destination and dates; returns a price-sorted list, each hotel with a `ref`. |
| `get_rooms` | List the bookable rooms for one hotel and date range. |
| `get_hotel_details` | Full property details: description, amenities, photos, policies, location. |
| `get_checkout_quote` | Re-price a specific room live against the supplier (no booking, no charge). |
| `search` / `fetch` | Research-style search and fetch-by-id (hotels and booking references). |
| `get_booking` | Look up a booking by the management token from its confirmation email. |
### Checkout
| Tool | Description |
| --- | --- |
| `create_checkout` | Create a secure getmyhotels.com checkout URL for a chosen room. **Does not charge the card** — the guest completes payment on our site. |
### Your account — sign-in required
| Tool | Description |
| --- | --- |
| `list_trips` · `save_trip` · `add_trip_item` | Create and manage saved trips / itineraries. |
| `list_my_bookings` · `get_my_booking` | View your hotel bookings. |
| `request_booking_action_code` | Email a 6-digit code — required before cancel/modify. |
| `cancel_booking` · `modify_booking` | Cancel or change a booking (needs the 6-digit code). |
| `list_payment_methods` | List your saved cards. |
| `create_one_click_checkout` | Create a checkout with a saved card pre-selected. |
## Interactive widgets
Three tools return rich, interactive UI (MCP Apps / OpenAI widgets) in supported clients:
- **`search_hotels`** — results grid with photos, ratings, prices, and a map.
- **`get_rooms`** — hotel detail with a photo carousel, review scores, amenities, and rooms.
- **`create_checkout`** — a checkout card with the price breakdown and a pay button.
## Example prompts
- "Find a 4-star hotel in Barcelona for Sep 10–12 for 2 adults, refundable only."
- "Show me the rooms at that hotel and give me the live price."
- "Start a checkout for the cheapest room."
- "List my upcoming bookings." *(signs you in)*
- "Cancel my booking at that hotel." *(emails a code, then confirms)*
## Safety & privacy
- Card numbers never pass through the model — payment happens on getmyhotels.com.
- Cancelling or modifying a booking requires a one-time code emailed to the booking owner.
- Guest tool outputs are scrubbed of internal identifiers and personal data.
## Links
- **Website:** <https://www.getmyhotels.com>
- **Connector docs:** <https://www.getmyhotels.com/mcp>
- **MCP Registry:** `com.getmyhotels/getmyhotels` — <https://registry.modelcontextprotocol.io/v0/servers?search=getmyhotels>
## License
[MIT](./LICENSE) © getmyhotels.com