Skip to content
MCP server

HotelRunner MCP by usefulapi

Read HotelRunner reservations, rooms, channels; update availability and prices; confirm…

Install
Runs
Remotely
Version
1.19.0
Listing updated
4 days ago

About HotelRunner MCP by usefulapi

HotelRunner MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Read HotelRunner reservations, rooms, channels; update availability and prices; confirm or cancel.

Install

Run in a terminal

claude mcp add --transport http hotelrunner https://hotelrunner.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://hotelrunner.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "hotelrunner": {
      "url": "https://hotelrunner.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "hotelrunner": {
      "type": "http",
      "url": "https://hotelrunner.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "hotelrunner": {
      "serverUrl": "https://hotelrunner.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "hotelrunner": {
      "type": "http",
      "url": "https://hotelrunner.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (8)

Read directly from the server.

hotelrunner_list_rooms
List the property's room types and rates with their inv_code and rate_code, capacity, pricing type, sales currency, connected channel codes and whether availability, restrictions and prices can be updated through the API. Use the inv_code with hotelrunner_update_room_calendar. Counts as one of the property's 250 requests per day (5 per minute). GET /api/v2/apps/rooms.
hotelrunner_list_reservations
List reservations of the property (new, modified, canceled), newest data first as HotelRunner returns them, 1-50 per page. By default ALL reservations created in the window are returned (this tool sets undelivered=false, so reading does not depend on a PMS having fetched them). from_date is the creation date (HotelRunner keeps at most 30 days back; default 10 days); from_last_update_date finds res
hotelrunner_get_reservation
One reservation by its HotelRunner code (hr_number, e.g. R377873409) or the sales channel's own reservation code, with the full vendor record (rooms, daily prices, extras, payments, guest and billing details, next_states). If the reservation is older than HotelRunner's lookup window, pass from_date. Counts as one of the property's 250 requests per day (5 per minute). GET /api/v2/apps/reservations?
hotelrunner_list_channels
All sales channels HotelRunner supports (name and code, e.g. bookingcom, expedia, hrs, online). The code is what hotelrunner_update_room_calendar takes in channel_codes. Counts as one of the property's 250 requests per day (5 per minute). GET /api/v2/apps/infos/channels.
hotelrunner_list_connected_channels
The channels this property is connected to, each with counts of calendar update processes in progress, succeeded and failed. Counts as one of the property's 250 requests per day (5 per minute). GET /api/v2/apps/infos/connected_channels.
hotelrunner_get_transaction_details
Per-channel status of a calendar update: pass the transaction_id returned by hotelrunner_update_room_calendar. Shows succeeded / failed / in-progress counts and each channel's state and error message. Counts as one of the property's 250 requests per day (5 per minute). GET /api/v2/apps/infos/transaction_details.
hotelrunner_update_room_calendar
WRITE: change availability, price, minimum/maximum stay, stop-sale, closed-to-arrival (cta) or closed-to-departure (ctd) for ONE room type (inv_code) over a date range of at most 90 days, optionally only on some weekdays and only on some channels. Only the fields you pass are changed. This is LIVE inventory: HotelRunner pushes it to every connected channel (Booking.com, Expedia, your own booking e
hotelrunner_update_reservation_state
WRITE: move ONE reservation to the next state: event 'confirm' (hotelier accepts it) or 'cancel' (cancels it; cancel_reason is required: customer, no_room, no_show or invalid_price). Cancel is not reversible through this API and releases the room; HotelRunner may notify the guest or the sales channel (Booking.com, Expedia, ...), so only cancel when the user clearly asked for it, and pass confirm=t

HotelRunner MCP by usefulapi FAQ

How do I add HotelRunner MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http hotelrunner https://hotelrunner.usefulapi.io/mcp