Roomza Hotel Intelligence
Measured conclusion: Deep-tested. L2 outcome: tools_ok.
The room-level truth layer of hospitality. Verified scores for exact hotel rooms, not just hotels.
| Author | io.github.roomza-inc |
|---|---|
| Access | remote |
| Publisher key required | No |
| Measured state | Deep-tested |
| L1 liveness | alive |
| L1 latency | 2528 ms |
| Last measured | 2026-10-24 |
Add to your agent
Copy this into your MCP client config:
{
"mcpServers": {
"Roomza Hotel Intelligence": {
"url": "https://www.roomza.com/api/mcp",
"transport": "streamable-http"
}
}
}
Measured tools (12)
search_hotelsread-onlyDISCOVERY ONLY: search Roomza's hotel database by city, keyword, or natural language query when the user has NOT named a specific hotel. Understands hotel types (boutique, resort, luxury), vibes (romantic, trendy, quiet), traveler types (couples, families, solo), neighborhoods, and nearby landmarks. Example queries: 'boutique hotels in SoHo', 'romantic resort near the Eiffel Tower', 'pet-friendly hotel in Seattle'. Renders for the user as a full map with a multi-hotel list (so do not repeat the list in prose). NEVER use this when the user names one specific hotel (e.g. 'Wynn Las Vegas'): the map of many hotels is wrong for that. Call get_hotel with the hotel name instead, then get_hotel_rooms and show_rooms.
Parameters:
query(required) — string — Hotel name, city, or keywordcity— string — Narrow results to a specific citylimit— integer — Max results (default 10)
Hints: read-only yes · destructive no · idempotent yes · open-world no
get_hotelread-onlyGet full details for a hotel including: Roomza Truth summary, score breakdown, top strengths, hotel character (type, vibes, best-for), nearby landmarks with distances, neighborhood, awards, amenities, and review highlights from the open web. Use hotel name, slug, or UUID as the identifier. This is the FIRST call when the user names a specific hotel ('Wynn Las Vegas') — no search_hotels needed; the name resolves directly.
Parameters:
identifier(required) — string — Hotel name, slug, or UUID
Hints: read-only yes · destructive no · idempotent yes · open-world no
get_hotel_roomsread-onlyList rooms for a hotel with individual Roomza scores, bed type, view, and floor. Pass room_number to look up a specific room.
Parameters:
hotel_id(required) — string — Hotel UUID from search_hotels/get_hotel (the URL slug also works)room_number— string — Look up a specific room by number, e.g. "434"
Hints: read-only yes · destructive no · idempotent yes · open-world no
get_recent_reviewsread-onlyGet verified guest reviews for a hotel, including comments and insider tips. Pass room_number to get reviews for a specific room.
Parameters:
hotel_id(required) — string — Hotel UUID (the URL slug also works)limit— integer — Number of reviews (default 5)room_number— string — Filter reviews to a specific room number, e.g. "434"
Hints: read-only yes · destructive no · idempotent yes · open-world no
get_hotel_pricingread-onlyGet public room rates for a hotel (the hotel's own public rate; booking on Roomza never costs more). Pass check_in and check_out dates (YYYY-MM-DD) to get nightly from-prices per room type. Without dates, returns the hotel's typical nightly from-price. No booking links; to price and book an exact room, use secure_room.
Parameters:
hotel_id(required) — string — Hotel UUID (the URL slug also works)check_in— string — Check-in date in YYYY-MM-DD format (defaults to today)check_out— string — Check-out date in YYYY-MM-DD format (defaults to tomorrow)
Hints: read-only yes · destructive no · idempotent yes · open-world no
get_nearbyread-onlyGet nearby places (restaurants, bars, attractions, parks) and upcoming events near a hotel. Optionally filter events to a travel window with start_date / end_date.
Parameters:
hotel_id(required) — string — Hotel UUID from search_hotels/get_hotel (the URL slug also works)end_date— string — Travel end date YYYY-MM-DD -- filters events to this windowstart_date— string — Travel start date YYYY-MM-DD -- filters events to this window
Hints: read-only yes · destructive no · idempotent yes · open-world no
ask_about_hotelread-onlyAsk a specific question about a hotel that standard data may not answer. Uses AI with web search to find the answer. Examples: 'Does this hotel have Eiffel Tower views?', 'Is there a rooftop bar?', 'How far is it from the airport?'. Try get_hotel first; use this only when that data doesn't answer the question.
Parameters:
hotel_id(required) — string — Hotel UUID (the URL slug also works)question(required) — string — The specific question about the hotel
Hints: read-only yes · destructive no · idempotent yes · open-world yes
show_roomsread-onlyREQUIRED whenever you present rooms. Whenever you are about to mention, recommend, or describe one or more specific rooms to the user, you MUST call this tool with those room UUIDs INSTEAD of writing the rooms in text. This is mandatory even when there is only ONE matching room — show it as a single hero card, never describe a lone room in prose. Call this BEFORE writing any prose about the rooms; the cards must appear first, then a brief summary. Pass room UUIDs (from get_hotel_rooms or search results) in ranked order, best first, 1 to 8 rooms. ALWAYS pass check_in and check_out when you know the user's dates: card prices are then for those exact dates. Without dates, cards show a typical from-price that can differ a lot from any specific dates. Each card shows photo, Roomza score, view, bed, and price. NEVER ask the user whether they want to see cards or images — just call this tool.
Parameters:
room_ids(required) — array — Room UUIDs to display, in ranked order (best first). 1-8 rooms.check_in— string — Check-in date YYYY-MM-DD. Pass whenever the user's dates are known so card prices match those dates.check_out— string — Check-out date YYYY-MM-DD.
Hints: read-only yes · destructive no · idempotent yes · open-world no
get_my_tripsread-onlyLook up your upcoming and past hotel bookings/trips on Roomza. Requires connecting your Roomza account.
Hints: read-only yes · destructive no · idempotent yes · open-world no
get_my_preferencesread-onlyGet your saved room preferences, standing requests, and loyalty accounts on Roomza. Requires connecting your Roomza account.
Hints: read-only yes · destructive no · idempotent yes · open-world no
add_special_requestAdd a special request to one of your bookings (e.g. extra pillows, late checkout, anniversary celebration). Requires connecting your Roomza account.
Parameters:
booking_id(required) — string — The booking ID to add the request to (get this from get_my_trips)request(required) — string — The special request to add
Hints: read-only no · destructive no · idempotent no · open-world no
secure_roomPrice and lock an exact room for specific dates with Room Lock. Returns the live price, cancellation policy, and a secure booking link with the room preselected. Requires connecting your Roomza account.
Parameters:
room_id(required) — string — Room UUID (from show_rooms or get_hotel_rooms)check_in(required) — string — Check-in date, YYYY-MM-DDcheck_out(required) — string — Check-out date, YYYY-MM-DDguests— integer — Guest count (default 2)
Hints: read-only no · destructive no · idempotent no · open-world no
Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.