stayport
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
stayport
stayport talks to a Hostex property-management account from the
terminal and from MCP clients: properties and room types,
reservations (including direct-booking creation, cancellation,
lock codes, and per-stay custom fields), availability, guest
conversations, reviews, webhooks, listing calendars and prices,
custom channels, and income methods. One binary serves a
command-line interface and a stdio MCP server, exposing the same
23 operations as hostex_* tools.
Two credentials are involved. Every v3 API call sends a
Hostex-Access-Token header whose value comes from the
HOSTEX_ACCESS_TOKEN environment variable; calls go to
https://api.hostex.io/v3 unless HOSTEX_API_URL overrides the
base URL. When the token is not set, commands fail with an error
that names the env var — stayport never invents a result. The
guest-review operation is the one exception to the token flow: it
posts through the Hostex web app, so it logs in with
HOSTEX_EMAIL and HOSTEX_PASSWORD (optionally overriding the
web base URL, default https://hostex.io/api, with
HOSTEX_WEB_API_URL) and fails the same honest way when they are
unset.
A v3 call counts as successful only when the response envelope
reports error_code 200; the envelope's data is what you get
back. Any other envelope is an error carrying the upstream
error_msg and request_id.
Install
npx @reneturcios/stayport propertiesOr run the container image:
docker run -i ghcr.io/cloudcorprecords/stayportThe container defaults to the MCP server (see below). Pass CLI
arguments to use it as a CLI instead, and pass the env vars above
with -e so the server can reach your account.
Related MCP server: Hostex MCP Server
CLI
export HOSTEX_ACCESS_TOKEN=... # from your Hostex account settings
stayport properties --limit 10
stayport room-types
stayport reservations --status accepted --start-check-in-date 2026-11-01
stayport create-reservation --property-id 123 --custom-channel-id 9 \
--check-in-date 2026-11-10 --check-out-date 2026-11-12 \
--guest-name "Ada Lovelace" --currency USD --rate-amount 20000 \
--commission-amount 1000 --received-amount 20000 --income-method-id 3
stayport cancel-reservation RES-123
stayport update-lock-code STAY-9 4321
stayport get-custom-fields STAY-9
stayport update-custom-fields STAY-9 '{"gate_code":"88"}'
stayport availabilities --property-ids 1,2 --start-date 2026-11-01 --end-date 2026-11-07
stayport update-availabilities --property-ids 1,2 --available false --dates 2026-11-03
stayport conversations --limit 5
stayport conversation conv-9
stayport send-message conv-9 --message "Welcome! Check-in is at 3pm."
stayport reviews --property-id 123
stayport create-review RES-123 --score 5 --content "Great guest"
stayport webhooks
stayport create-webhook https://example.com/hook
stayport delete-webhook 17
stayport listing-calendar --start-date 2026-11-01 --end-date 2026-11-30 \
--listings '[{"channel_type":"airbnb","listing_id":"L1"}]'
stayport update-listing-prices --channel-type airbnb --listing-id L1 \
--prices '[{"date":"2026-11-05","price":15000}]'
stayport custom-channels
stayport income-methods
stayport --versionThe guest-review command additionally needs the web-app login:
export HOSTEX_EMAIL=you@example.com
export HOSTEX_PASSWORD=...
stayport post-guest-review --reservation-order-code 0-ABC123-xyz \
--content "Lovely stay" --recommend 1 --overall-rating 5 \
--cleanliness 4 --respect-of-house-rules 5 --communication 5Successful commands print the response data as JSON. Exit
codes: 0 on success, 1 when a call fails (missing credential,
upstream envelope error, network failure), 2 for usage errors.
Amounts on reservation creation are in cents, exactly as the
Hostex API takes them; listing prices are passed through in the
shape the API expects.
MCP server
One bin serves both faces. The mcp subcommand starts a stdio
MCP server:
npx -y @reneturcios/stayport mcpMCP client configuration:
{
"mcpServers": {
"stayport": {
"command": "npx",
"args": ["-y", "@reneturcios/stayport", "mcp"],
"env": {
"HOSTEX_ACCESS_TOKEN": "..."
}
}
}
}Add HOSTEX_EMAIL and HOSTEX_PASSWORD to that env block if
you want the guest-review tool to work; the other 22 tools only
need the access token.
Tools
Tool | Input | What it does |
|
| Lists properties with ID, title, address, channels, and coordinates. |
|
| Lists room types. |
|
| Lists and searches reservations. |
|
| Creates a direct booking. Amounts are in cents. |
|
| Cancels a direct booking (channel bookings are not supported). |
|
| Sets a stay's lock code. |
|
| Reads a stay's custom fields. |
|
| Writes a stay's custom fields, usable in automated messages as |
|
| Queries availability for a date range. |
|
| Sets availability for dates or a range. |
|
| Lists guest conversations and inquiries. |
|
| Gets a conversation with all its messages. |
|
| Sends a text or JPEG image message to the guest. |
|
| Queries reviews with filters. |
|
| Creates a review or a reply for a reservation. |
|
| Posts a full guest review through the web app; needs the email/password login. |
| (none) | Lists configured webhooks. |
|
| Creates a webhook. |
|
| Deletes a manageable webhook. |
|
| Gets calendar information for multiple listings. |
|
| Updates listing prices. |
| (none) | Lists custom channels from the Custom Options Page. |
| (none) | Lists income methods from the Custom Options Page. |
Development
npm install
npm run build # tsc -> dist/
npm test # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev # run the CLI from source via tsxLicense
MIT — see LICENSE.
This server cannot be deployed
Maintenance
Related MCP Connectors
Manage your Hostex vacation rentals—properties, reservations, availability, listings, and guest me…
Manage Hostaway listings, reservations, calendar, guest messages, reviews and tasks.
Hotel booking MCP server. Search, book, and manage reservations across 250K+ properties worldwide.
Official MCP server for MAQAMI, a hotel and flight booking platform with 3M+ hotels. Search live hotel rates and flights, look up places, airports and hotel details, then prebook and book. Remote Streamable HTTP endpoint, no API key required.
Related MCP Servers
- AlicenseBqualityDmaintenanceThis MCP server provides comprehensive access to the Mews hospitality platform API, covering customer and company management, reservation operations, financial transactions, account management, configuration settings, and services inventory. It implements the core functionality needed for hospitalit5311 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables management of vacation rental properties through the Hostex API, including reservations, guest communications, availability calendars, reviews, and channel listings.1MIT
- FlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to interact with Hostaway's property management platform through standardized MCP tools. Provides access to listings, bookings, guest communication, and availability checking for vacation rental management.-

Hostkit MCPofficial
AlicenseBqualityBmaintenanceMCP server for the Hostkit API, enabling management of properties, reservations, guests, invoices, and other property operations.36MIT