MCP server

HotelRunner MCP by usefulapi

io.usefulapi/hotelrunner

Checked 25 Oct 2026, 20:29 UTC · Connected to it and listed its tools

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

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

8

Token cost

About 2,549 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

25 Oct 2026, 20:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.hotelrunner]
url = "https://hotelrunner.usefulapi.io/mcp"

Gemini CLI

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

Cursor

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

VS Code

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

Antigravity

agy mcp add hotelrunner https://hotelrunner.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"hotelrunner","server_url":"https://hotelrunner.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"hotelrunner","server_url":"https://hotelrunner.usefulapi.io/mcp"}

Tools

• hotelrunner_get_reservation ~279 tokens
  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.
• hotelrunner_get_transaction_details ~181 tokens
  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/transac
• hotelrunner_list_channels ~123 tokens
  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 ~116 tokens
  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_list_reservations ~524 tokens
  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 crea
• hotelrunner_list_rooms ~151 tokens
  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 p
• hotelrunner_update_reservation_state ~418 tokens
  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 channe
• hotelrunner_update_room_calendar ~757 tokens
  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 i

Browse

• Calendars
• Booking and scheduling
• Payments

Related MCP servers

• Smoobu MCP by usefulapi
  Check vacation-rental reservations, rates, availability and guest messages, and update bookings.
• Hostaway MCP by usefulapi
  Manage Hostaway listings, reservations, calendar, guest messages, reviews and tasks.
• Beds24 MCP by usefulapi
  Check bookings, quote stays, read guest messages and reviews, and update calendars in Beds24.
• oriiion
  Your marketing, a message away
• Hostfully MCP by usefulapi
  Check properties, calendars, leads, quotes, guests and messages in Hostfully, and send replies.
• Waitwhile MCP by usefulapi
  Read Waitwhile visits, bookings, customers, services and analytics; add, update and cancel visits.
• Hotelumo Hotel Operations
  See your hotel's room availability, rates, housekeeping and upcoming arrivals and departures.
• Florealholidays Workspace
  Floreal Holidays Belgium: live prices and availability; staff run M&E dossiers, day sheets, tasks.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/hotelrunner.svg)](https://aptlynx.net/servers/io.usefulapi/hotelrunner)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents