Roomza Hotel Intelligence

Official12 toolsLive

by roomza-inc

The room-level truth layer of hospitality. Verified scores for exact hotel rooms, not just hotels.

Hotel and room intelligence from Roomza: scores, reviews, and room details.

🛠️ Key Features

Name: io.github.roomza-inc/roomza
Description: Hotel and room intelligence from Roomza: scores, reviews, and room details.
Topics: not provided in source
toolCount: not provided in source
readmeExcerpt: not provided in source

🚀 Use Cases

Retrieve hotel scoring and review aggregates.
Access detailed room information for comparison.
Integrate Roomza insights into property listings or travel apps.

⚡ Developer Benefits

Clear, concise data surface for hotel and room intelligence.
Structured metadata suitable for catalog pages and SEO.
Lightweight description aligned with repository name.

⚠️ Limitations

Source data is minimal: only slug, name, and description are provided.
No explicit readmeExcerpt or toolCount available.

Captured live from the server via tools/list.

search_hotels

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.

Parameters3

query	string	required	Hotel name, city, or keyword
city	string	optional	Narrow results to a specific city
limit	integer	optional	Max results (default 10)

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Hotel name, city, or keyword"
    },
    "city": {
      "description": "Narrow results to a specific city",
      "type": "string"
    },
    "limit": {
      "description": "Max results (default 10)",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_hotel

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.

Parameters1

identifier

string

required

Hotel name, slug, or UUID

Raw schema

{
  "type": "object",
  "properties": {
    "identifier": {
      "type": "string",
      "description": "Hotel name, slug, or UUID"
    }
  },
  "required": [
    "identifier"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_hotel_rooms

List rooms for a hotel with individual Roomza scores, bed type, view, and floor. Pass room_number to look up a specific room.

Parameters2

hotel_id	string	required	Hotel UUID (get this from search_hotels or get_hotel)
room_number	string	optional	Look up a specific room by number, e.g. "434"

Raw schema

{
  "type": "object",
  "properties": {
    "hotel_id": {
      "type": "string",
      "description": "Hotel UUID (get this from search_hotels or get_hotel)"
    },
    "room_number": {
      "description": "Look up a specific room by number, e.g. \"434\"",
      "type": "string"
    }
  },
  "required": [
    "hotel_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_recent_reviews

Get verified guest reviews for a hotel, including comments and insider tips. Pass room_number to get reviews for a specific room.

Parameters3

hotel_id	string	required	Hotel UUID
room_number	string	optional	Filter reviews to a specific room number, e.g. "434"
limit	integer	optional	Number of reviews (default 5)

Raw schema

{
  "type": "object",
  "properties": {
    "hotel_id": {
      "type": "string",
      "description": "Hotel UUID"
    },
    "room_number": {
      "description": "Filter reviews to a specific room number, e.g. \"434\"",
      "type": "string"
    },
    "limit": {
      "description": "Number of reviews (default 5)",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "hotel_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_hotel_pricing

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.

Parameters3

hotel_id	string	required	Hotel UUID
check_in	string	optional	Check-in date in YYYY-MM-DD format (defaults to today)
check_out	string	optional	Check-out date in YYYY-MM-DD format (defaults to tomorrow)

Raw schema

{
  "type": "object",
  "properties": {
    "hotel_id": {
      "type": "string",
      "description": "Hotel UUID"
    },
    "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"
    }
  },
  "required": [
    "hotel_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_nearby

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.

Parameters3

hotel_id	string	required	Hotel UUID (get this from search_hotels or get_hotel)
start_date	string	optional	Travel start date YYYY-MM-DD -- filters events to this window
end_date	string	optional	Travel end date YYYY-MM-DD -- filters events to this window

Raw schema

{
  "type": "object",
  "properties": {
    "hotel_id": {
      "type": "string",
      "description": "Hotel UUID (get this from search_hotels or get_hotel)"
    },
    "start_date": {
      "description": "Travel start date YYYY-MM-DD -- filters events to this window",
      "type": "string"
    },
    "end_date": {
      "description": "Travel end date YYYY-MM-DD -- filters events to this window",
      "type": "string"
    }
  },
  "required": [
    "hotel_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

ask_about_hotel

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.

Parameters2

hotel_id	string	required	Hotel UUID
question	string	required	The specific question about the hotel

Raw schema

{
  "type": "object",
  "properties": {
    "hotel_id": {
      "type": "string",
      "description": "Hotel UUID"
    },
    "question": {
      "type": "string",
      "description": "The specific question about the hotel"
    }
  },
  "required": [
    "hotel_id",
    "question"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

show_rooms

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.

Parameters3

room_ids	array	required	Room UUIDs to display, in ranked order (best first). 1-8 rooms.
check_in	string	optional	Check-in date YYYY-MM-DD. Pass whenever the user's dates are known so card prices match those dates.
check_out	string	optional	Check-out date YYYY-MM-DD.

Raw schema

{
  "type": "object",
  "properties": {
    "room_ids": {
      "minItems": 1,
      "maxItems": 8,
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Room UUIDs to display, in ranked order (best first). 1-8 rooms."
    },
    "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"
    }
  },
  "required": [
    "room_ids"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_my_trips

Look up your upcoming and past hotel bookings/trips on Roomza. Requires connecting your Roomza account.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

get_my_preferences

Get your saved room preferences, standing requests, and loyalty accounts on Roomza. Requires connecting your Roomza account.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

add_special_request

Add a special request to one of your bookings (e.g. extra pillows, late checkout, anniversary celebration). Requires connecting your Roomza account.

Parameters2

booking_id	string	required	The booking ID to add the request to (get this from get_my_trips)
request	string	required	The special request to add

Raw schema

{
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "string",
      "description": "The booking ID to add the request to (get this from get_my_trips)"
    },
    "request": {
      "type": "string",
      "description": "The special request to add"
    }
  },
  "required": [
    "booking_id",
    "request"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

secure_room

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.

Parameters4

room_id	string	required	Room UUID (from show_rooms or get_hotel_rooms)
check_in	string	required	Check-in date, YYYY-MM-DD
check_out	string	required	Check-out date, YYYY-MM-DD
guests	integer	optional	Guest count (default 2)

Raw schema

{
  "type": "object",
  "properties": {
    "room_id": {
      "type": "string",
      "description": "Room UUID (from show_rooms or get_hotel_rooms)"
    },
    "check_in": {
      "type": "string",
      "description": "Check-in date, YYYY-MM-DD"
    },
    "check_out": {
      "type": "string",
      "description": "Check-out date, YYYY-MM-DD"
    },
    "guests": {
      "description": "Guest count (default 2)",
      "type": "integer",
      "minimum": 1,
      "maximum": 8
    }
  },
  "required": [
    "room_id",
    "check_in",
    "check_out"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Install

Tools (12)

search_hotelsget_hotelget_hotel_roomsget_recent_reviewsget_hotel_pricingget_nearbyask_about_hotelshow_rooms

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://www.roomza.com/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "roomza": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.roomza.com/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

search_hotels

get_hotel

get_hotel_rooms

get_recent_reviews

get_hotel_pricing

get_nearby

ask_about_hotel

show_rooms

get_my_trips

get_my_preferences

add_special_request

secure_room

Install

Remote endpoint

Related servers