Connectors and developers
MCP reference
Public and account endpoints, tool names, authentication, and examples.
Endpoints and transport
Room Saint uses Streamable HTTP: send JSON-RPC requests by POST to the selected HTTPS endpoint. Opening it as a normal web page with GET may return 405; that does not mean the connector is down. GET event streams are not provided.
https://www.roomsaint.com/mcp: anonymous public discovery.https://www.roomsaint.com/mcp/account: existing account functionality, requiring verified Room Saint sign-in through OAuth or a suitably authorized personal token.
Public tools
| Tool | Input |
|---|---|
search_hotels | Optional query, destination, coordinates, score, star, amenity, limit, and offset filters |
get_hotel | hotel_id as a numeric string |
hotels_near_location | Required numeric latitude and longitude; optional radius and filters |
hotels_near_landmark | Required landmark; optional city, country, radius, and filters |
Use query instead of the REST API's q. Numbers must be JSON numbers, not strings. Initialize the connection, then call tools/list for current strict schemas. Limits match the public API; public MCP permits 30 requests per minute per IP and shares its daily allowance with REST.
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_hotels","arguments":{"query":"Rome","country":"IT","limit":5}}}Results include structuredContent and a JSON text representation. Tool errors set isError: true and include structuredContent.error.code and message. Transport errors use the JSON-RPC error object. Arbitrary backend queries and write tools are not accepted on the public endpoint.
Account tools
search-hotelsandget-hotel: account connector discovery tools. Their schemas differ from the public tools; inspecttools/list.manage-trips: list, create, and inspect your trips.save-hotel-to-trip: save candidates and update their planning status, notes, or position.rate-hotel: cast or toggle a community vote.searchandfetch: compatibility aliases for discovery clients.
These are existing account operations, not anonymous tools. There are no reservation, payment, claim-management, or administrative tools on these connections. OAuth sign-in authorizes account tools; personal tokens require the appropriate abilities.
Connect or troubleshoot
Follow the Claude guide or ChatGPT guide. If an old connection only shows public tools, change its endpoint to /mcp/account, reauthorize, and refresh its tool list.