Server definition
- Hash
- sha256:0b92c9926d07f2c4e131b7f6225900ca07c3886a07f528d314d206f1a4449fc1
- What it is
- What a remote MCP server returned when asked what it offers: 12 tools
The blob, as servednamed by its sha256
{
"instructions": "Roomza is the room-level truth layer of hospitality. It provides verified, structured data about individual hotel rooms: condition, noise, view, bed, Wi-Fi, accessibility, scored from real guest stays tied to real reservations and from signal derived on the open web. Hotels cannot edit or purchase scores (see https://www.roomza.com/trust), so the ranking answers to guests, not to who pays. Use Roomza to recommend specific rooms, not just hotels.\n\nCRITICAL RULE for presenting rooms to Roomza users. This is a hard requirement, not a preference:\n\nYou MUST call the show_rooms tool to display rooms as visual cards. Follow these rules exactly:\n\n1. ANY time you are about to tell the user about one or more specific rooms, you MUST call show_rooms with those room UUIDs INSTEAD of writing the rooms in text.\n2. This includes a SINGLE room. One matching room means one show_rooms call with one UUID. NEVER describe a lone room in prose — always show the card.\n3. Call show_rooms FIRST, before writing any summary, analysis, or recommendation. The cards MUST appear before your text, never after a paragraph of prose.\n4. NEVER ask the user \"would you like to see the rooms / cards / images?\" — just call show_rooms.\n5. After the cards render, add at most 1-2 short sentences. Users want the visual cards, not paragraphs.\n\nEXAMPLE:\nUser: \"Find me a hotel with an Eiffel Tower view and a balcony.\"\nCorrect behavior: quietly call search_hotels then get_hotel_rooms to find the matching room(s), then IMMEDIATELY call show_rooms with the matching room UUID(s), then add a brief 1-2 sentence note. Even if only one room matches, you still call show_rooms with that one UUID.\nWrong behavior: describing the matching room(s) in a paragraph, or asking the user if they want to see cards.\n\nDo all searching with minimal commentary. The show_rooms cards are your primary deliverable; prose is always secondary.\n\nsearch_hotels renders its own visual result for the user: a map with a numbered hotel list showing scores, room-record coverage, and from-prices. After calling search_hotels, NEVER repeat the hotel list in prose — add at most 1-2 short sentences and let the widget carry the results. When the user picks a hotel (by tapping \"See rooms\" or by saying so), call get_hotel_rooms for that hotel_id and then show_rooms.\n\nRouting rule: search_hotels is for DISCOVERY (a city, a vibe, \"hotels near X\"). When the user names one specific hotel (\"Wynn Las Vegas\", \"the Monarch San Antonio\"), do NOT call search_hotels — a map of many hotels is the wrong answer. Call get_hotel with the hotel name (it resolves names directly), then get_hotel_rooms, then show_rooms.\n\nWhen get_hotel_rooms returns no tracked rooms but a roomTypes list, do NOT apologize or dead-end. Present the room types with their from-prices (brief list, no show_rooms call since there are no room UUIDs), share the bookUrl, and add ONE short line: booking with Roomza and reviewing the stay starts that hotel's room record for future travelers. Keep it to a sentence.\n\nWhen you know the user's dates, ALWAYS pass check_in and check_out to show_rooms so the card prices are for those dates. Never quote a card's undated from-price as the price for specific dates.\n\nWhen the user picks a specific room (by tapping a card or saying so) and you know their dates, call secure_room next to price it and get the secure booking link. Ask for dates only if you do not have them. Never invent a price or a booking link yourself; secure_room is the only source of both, and payment only ever happens on Roomza through the link it returns.\n\nThe user is not signed in to Roomza. All hotel and room discovery tools work now. Personal tools (secure_room, get_my_trips, get_my_preferences, add_special_request) require the user to connect their Roomza account. Calling one of them now returns a sign-in prompt the client can act on. If the user asks for a personal tool, invoke it so the sign-in flow starts, or point them to https://www.roomza.com/connect.",
"tools": [
{
"description": "Add a special request to one of your bookings (e.g. extra pillows, late checkout, anniversary celebration). Requires connecting your Roomza account.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"booking_id": {
"description": "The booking ID to add the request to (get this from get_my_trips)",
"type": "string"
},
"request": {
"description": "The special request to add",
"type": "string"
}
},
"required": [
"booking_id",
"request"
],
"type": "object"
},
"name": "add_special_request",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"message": {
"type": "string"
},
"ok": {
"type": "boolean"
}
},
"required": [
"ok",
"message"
],
"type": "object"
}
},
{
"description": "Ask 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"hotel_id": {
"description": "Hotel UUID (the URL slug also works)",
"type": "string"
},
"question": {
"description": "The specific question about the hotel",
"type": "string"
}
},
"required": [
"hotel_id",
"question"
],
"type": "object"
},
"name": "ask_about_hotel",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"answer": {
"type": "string"
}
},
"required": [
"answer"
],
"type": "object"
}
},
{
"description": "Get 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"identifier": {
"description": "Hotel name, slug, or UUID",
"type": "string"
}
},
"required": [
"identifier"
],
"type": "object"
},
"name": "get_hotel",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"found": {
"type": "boolean"
},
"hotel": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"amenities": {
"items": {
"type": "string"
},
"type": "array"
},
"awards": {
"items": {
"type": "string"
},
"type": "array"
},
"bestFor": {
"items": {
"type": "string"
},
"type": "array"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"googleRating": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"googleReviewCount": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"hotelType": {
"items": {
"type": "string"
},
"type": "array"
},
"id": {
"type": "string"
},
"knownViews": {
"items": {
"type": "string"
},
"type": "array"
},
"landmarks": {
"items": {
"additionalProperties": false,
"properties": {
"distanceMi": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
}
},
"required": [
"name",
"distanceMi"
],
"type": "object"
},
"type": "array"
},
"name": {
"type": "string"
},
"neighborhood": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"reviewCount": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"roomzaTruth": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"score": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Roomza score 0-100; null when unreviewed"
},
"scoreBreakdown": {
"items": {
"additionalProperties": false,
"properties": {
"label": {
"type": "string"
},
"score": {
"type": "number"
}
},
"required": [
"label",
"score"
],
"type": "object"
},
"type": "array"
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"starRating": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"topStrengths": {
"items": {
"additionalProperties": false,
"properties": {
"label": {
"type": "string"
},
"score": {
"type": "number"
}
},
"required": [
"label",
"score"
],
"type": "object"
},
"type": "array"
},
"uniqueFeatures": {
"items": {
"type": "string"
},
"type": "array"
},
"url": {
"type": "string"
},
"verificationStatus": {
"type": "string"
},
"vibes": {
"items": {
"type": "string"
},
"type": "array"
},
"zip": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"slug",
"name",
"url",
"address",
"city",
"state",
"zip",
"starRating",
"verificationStatus",
"score",
"reviewCount",
"scoreBreakdown",
"topStrengths",
"googleRating",
"googleReviewCount",
"amenities",
"hotelType",
"vibes",
"bestFor",
"neighborhood",
"awards",
"knownViews",
"uniqueFeatures",
"landmarks",
"roomzaTruth"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "null when the hotel was not found"
}
},
"required": [
"found",
"hotel"
],
"type": "object"
}
},
{
"description": "Get 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"check_in": {
"description": "Check-in date in YYYY-MM-DD format (defaults to today)",
"type": "string"
},
"check_out": {
"description": "Check-out date in YYYY-MM-DD format (defaults to tomorrow)",
"type": "string"
},
"hotel_id": {
"description": "Hotel UUID (the URL slug also works)",
"type": "string"
}
},
"required": [
"hotel_id"
],
"type": "object"
},
"name": "get_hotel_pricing",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"checkIn": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"checkOut": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"found": {
"description": "false when the hotel is unknown",
"type": "boolean"
},
"hotelName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"nights": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"roomTypes": {
"description": "Per-room-type from-prices when dates were given and live rates exist",
"items": {
"additionalProperties": false,
"properties": {
"fromNightly": {
"description": "Nightly from-price in whole dollars, hotel's own public rate",
"type": "number"
},
"name": {
"type": "string"
}
},
"required": [
"name",
"fromNightly"
],
"type": "object"
},
"type": "array"
},
"typicalNightlyFrom": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Hotel-level typical nightly from-price in dollars"
}
},
"required": [
"found",
"hotelName",
"currency",
"checkIn",
"checkOut",
"nights",
"roomTypes",
"typicalNightlyFrom",
"note"
],
"type": "object"
}
},
{
"description": "List rooms for a hotel with individual Roomza scores, bed type, view, and floor. Pass room_number to look up a specific room.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"hotel_id": {
"description": "Hotel UUID from search_hotels/get_hotel (the URL slug also works)",
"type": "string"
},
"room_number": {
"description": "Look up a specific room by number, e.g. \"434\"",
"type": "string"
}
},
"required": [
"hotel_id"
],
"type": "object"
},
"name": "get_hotel_rooms",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"bookUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Roomza booking link for this hotel; set only on the no-records fallback"
},
"count": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Copy encouraging a booking + review to start this hotel's room record"
},
"roomTypes": {
"description": "Only populated when the hotel has no room records yet: bookable room types from live rates",
"items": {
"additionalProperties": false,
"properties": {
"fromNightly": {
"description": "Typical nightly from-price in USD from the hotel's public rates",
"type": "number"
},
"name": {
"type": "string"
}
},
"required": [
"name",
"fromNightly"
],
"type": "object"
},
"type": "array"
},
"rooms": {
"items": {
"additionalProperties": false,
"properties": {
"adaAccessible": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"adaFeatures": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"balcony": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"bathtub": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "null = unknown; false = confirmed absent"
},
"bedType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"floor": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"id": {
"description": "Room UUID — pass to show_rooms or secure_room",
"type": "string"
},
"microwave": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"miniFridge": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"reviewCount": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"roomNumber": {
"type": "string"
},
"roomTypeName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"score": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Roomza room score 0-100"
},
"sqFt": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"view": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"roomNumber",
"floor",
"roomTypeName",
"bedType",
"view",
"sqFt",
"bathtub",
"balcony",
"adaAccessible",
"miniFridge",
"microwave",
"adaFeatures",
"score",
"reviewCount",
"url"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"count",
"rooms",
"roomTypes",
"bookUrl",
"note"
],
"type": "object"
}
},
{
"description": "Get your saved room preferences, standing requests, and loyalty accounts on Roomza. Requires connecting your Roomza account.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "get_my_preferences",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"found": {
"type": "boolean"
},
"loyaltyPrograms": {
"items": {
"additionalProperties": false,
"properties": {
"program": {
"type": "string"
},
"tier": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"program",
"tier"
],
"type": "object"
},
"type": "array"
},
"preferences": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"awayFromElevator": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"balcony": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"bathtub": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"bedType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"highFloor": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"maxPricePerNight": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"minStars": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"petFriendly": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"quietSide": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"upgradePreference": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"view": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"bedType",
"view",
"bathtub",
"balcony",
"petFriendly",
"highFloor",
"awayFromElevator",
"quietSide",
"minStars",
"maxPricePerNight",
"upgradePreference"
],
"type": "object"
},
{
"type": "null"
}
]
},
"standingRequests": {
"items": {
"type": "string"
},
"type": "array"
},
"travelCards": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"found",
"preferences",
"standingRequests",
"loyaltyPrograms",
"travelCards"
],
"type": "object"
}
},
{
"description": "Look up your upcoming and past hotel bookings/trips on Roomza. Requires connecting your Roomza account.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "get_my_trips",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"count": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"past": {
"items": {
"additionalProperties": false,
"properties": {
"bookingId": {
"description": "Pass to add_special_request",
"type": "string"
},
"bookingPlatform": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"checkIn": {
"description": "YYYY-MM-DD",
"type": "string"
},
"checkOut": {
"description": "YYYY-MM-DD",
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"confirmationNumber": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Booking reference. For stays booked through Roomza this is the supplier reference until the hotel issues its own number"
},
"hotelConfirmationCode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The hotel's own confirmation number; null until the hotel issues it"
},
"hotelId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"hotelName": {
"type": "string"
},
"hotelUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"nights": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"specialRequests": {
"items": {
"type": "string"
},
"type": "array"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"bookingId",
"hotelId",
"hotelName",
"hotelUrl",
"city",
"state",
"checkIn",
"checkOut",
"nights",
"confirmationNumber",
"hotelConfirmationCode",
"bookingPlatform",
"status",
"specialRequests"
],
"type": "object"
},
"type": "array"
},
"upcoming": {
"items": {
"additionalProperties": false,
"properties": {
"bookingId": {
"description": "Pass to add_special_request",
"type": "string"
},
"bookingPlatform": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"checkIn": {
"description": "YYYY-MM-DD",
"type": "string"
},
"checkOut": {
"description": "YYYY-MM-DD",
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"confirmationNumber": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Booking reference. For stays booked through Roomza this is the supplier reference until the hotel issues its own number"
},
"hotelConfirmationCode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The hotel's own confirmation number; null until the hotel issues it"
},
"hotelId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"hotelName": {
"type": "string"
},
"hotelUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"nights": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"specialRequests": {
"items": {
"type": "string"
},
"type": "array"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"bookingId",
"hotelId",
"hotelName",
"hotelUrl",
"city",
"state",
"checkIn",
"checkOut",
"nights",
"confirmationNumber",
"hotelConfirmationCode",
"bookingPlatform",
"status",
"specialRequests"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"count",
"upcoming",
"past"
],
"type": "object"
}
},
{
"description": "Get nearby places (restaurants, bars, attractions, parks) and upcoming events near a hotel. Optionally filter events to a travel window with start_date / end_date.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"end_date": {
"description": "Travel end date YYYY-MM-DD -- filters events to this window",
"type": "string"
},
"hotel_id": {
"description": "Hotel UUID from search_hotels/get_hotel (the URL slug also works)",
"type": "string"
},
"start_date": {
"description": "Travel start date YYYY-MM-DD -- filters events to this window",
"type": "string"
}
},
"required": [
"hotel_id"
],
"type": "object"
},
"name": "get_nearby",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"events": {
"items": {
"additionalProperties": false,
"properties": {
"date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"ticketLink": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"title": {
"type": "string"
},
"venueName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"when": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"title",
"date",
"when",
"venueName",
"ticketLink"
],
"type": "object"
},
"type": "array"
},
"found": {
"type": "boolean"
},
"places": {
"items": {
"additionalProperties": false,
"properties": {
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"type": "string"
},
"name": {
"type": "string"
},
"priceLevel": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"rating": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"name",
"category",
"rating",
"priceLevel",
"address"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"found",
"places",
"events"
],
"type": "object"
}
},
{
"description": "Get verified guest reviews for a hotel, including comments and insider tips. Pass room_number to get reviews for a specific room.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"hotel_id": {
"description": "Hotel UUID (the URL slug also works)",
"type": "string"
},
"limit": {
"description": "Number of reviews (default 5)",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"room_number": {
"description": "Filter reviews to a specific room number, e.g. \"434\"",
"type": "string"
}
},
"required": [
"hotel_id"
],
"type": "object"
},
"name": "get_recent_reviews",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"count": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Set when no reviews are returned, e.g. unknown room"
},
"reviews": {
"items": {
"additionalProperties": false,
"properties": {
"comment": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"guestDisplayName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"insiderTip": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"roomId": {
"type": "string"
},
"roomNumber": {
"type": "string"
},
"roomUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"score": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Overall score 0-100"
},
"stayMonth": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"guestDisplayName",
"stayMonth",
"roomId",
"roomNumber",
"roomUrl",
"score",
"comment",
"insiderTip"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"count",
"note",
"reviews"
],
"type": "object"
}
},
{
"description": "DISCOVERY 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"city": {
"description": "Narrow results to a specific city",
"type": "string"
},
"limit": {
"description": "Max results (default 10)",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "Hotel name, city, or keyword",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_hotels",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"count": {
"description": "Number of hotels returned",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"hotels": {
"items": {
"additionalProperties": false,
"properties": {
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"fromNightly": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Cached nightly from-price in USD; null when uncovered"
},
"hotelType": {
"items": {
"type": "string"
},
"type": "array"
},
"id": {
"description": "Hotel UUID — pass to get_hotel_rooms, get_hotel_pricing, get_nearby, ask_about_hotel",
"type": "string"
},
"lat": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"lng": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"neighborhood": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"photoUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"reviewCount": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"roomCount": {
"description": "Rooms tracked on Roomza for this hotel",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"roomsWithRecords": {
"description": "Tracked rooms with at least one verified review",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"score": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Roomza score 0-100; null when unreviewed"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"url": {
"description": "Canonical Roomza hotel page",
"type": "string"
},
"vibes": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"id",
"name",
"city",
"state",
"country",
"url",
"score",
"reviewCount",
"hotelType",
"vibes",
"neighborhood",
"lat",
"lng",
"photoUrl",
"roomCount",
"roomsWithRecords",
"fromNightly"
],
"type": "object"
},
"type": "array"
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Search note, e.g. a nearby-city fallback explanation"
}
},
"required": [
"count",
"note",
"hotels"
],
"type": "object"
}
},
{
"description": "Price 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"check_in": {
"description": "Check-in date, YYYY-MM-DD",
"type": "string"
},
"check_out": {
"description": "Check-out date, YYYY-MM-DD",
"type": "string"
},
"guests": {
"description": "Guest count (default 2)",
"maximum": 8,
"minimum": 1,
"type": "integer"
},
"room_id": {
"description": "Room UUID (from show_rooms or get_hotel_rooms)",
"type": "string"
}
},
"required": [
"room_id",
"check_in",
"check_out"
],
"type": "object"
},
"name": "secure_room",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"bookable": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "true when a live bookable rate was found"
},
"bookingUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Secure checkout link with the room preselected; payment happens only there"
},
"cancellation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"checkIn": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"checkOut": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"dueAtHotel": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Additional amount due at the hotel, dollars"
},
"guests": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"hotelId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"hotelName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"indicativeOnly": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "true when the price is from public listings, not bookable"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Set when ok is false"
},
"nights": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"ok": {
"description": "false = the request could not be quoted; see message",
"type": "boolean"
},
"publicRate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Hotel's public rate in dollars, for comparison"
},
"rateName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"roomId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"roomNumber": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"totalToday": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Total charged today in dollars"
},
"trackRecord": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Hotel's room-request honor track record"
}
},
"required": [
"ok",
"message",
"roomId",
"roomNumber",
"hotelId",
"hotelName",
"checkIn",
"checkOut",
"nights",
"guests",
"currency",
"bookable",
"indicativeOnly",
"rateName",
"totalToday",
"dueAtHotel",
"publicRate",
"cancellation",
"trackRecord",
"bookingUrl"
],
"type": "object"
}
},
{
"description": "REQUIRED 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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"check_in": {
"description": "Check-in date YYYY-MM-DD. Pass whenever the user's dates are known so card prices match those dates.",
"type": "string"
},
"check_out": {
"description": "Check-out date YYYY-MM-DD.",
"type": "string"
},
"room_ids": {
"description": "Room UUIDs to display, in ranked order (best first). 1-8 rooms.",
"items": {
"type": "string"
},
"maxItems": 8,
"minItems": 1,
"type": "array"
}
},
"required": [
"room_ids"
],
"type": "object"
},
"name": "show_rooms",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"rooms": {
"items": {
"additionalProperties": false,
"properties": {
"bedType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"blurb": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"floor": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"hotelId": {
"type": "string"
},
"hotelName": {
"type": "string"
},
"id": {
"type": "string"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"photoSource": {
"anyOf": [
{
"enum": [
"room",
"hotel"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "Whether photoUrl shows the actual room or is a hotel-level fallback"
},
"photoUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"priceNote": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Shown in the price slot when pricePerNight is null, e.g. a prompt to provide dates"
},
"pricePerNight": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "Nightly price for the requested dates; null when no dates were given or no live rate exists"
},
"reviewCount": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"roomLabel": {
"type": "string"
},
"roomNumber": {
"type": "string"
},
"score": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"sqFt": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
},
"view": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"hotelId",
"hotelName",
"location",
"roomLabel",
"roomNumber",
"floor",
"score",
"reviewCount",
"pricePerNight",
"priceNote",
"currency",
"photoUrl",
"photoSource",
"view",
"bedType",
"sqFt",
"blurb",
"url"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"rooms"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:0b92c9926d07f2c4e131b7f6225900ca07c3886a07f528d314d206f1a4449fc1 | sha256sum