Hostkit MCP
OfficialUse this Hostkit MCP server to read and write property, reservation, guest, invoicing, expense, and SIBA data via the Hostkit API.
Read Hostkit license plan and expiry.
List/get properties, reservations, payments, online check-in status, and smartlock keycodes.
List invoices, reservation invoices, receipts, credit notes, and SAF-T files.
Retrieve expenses and last SIBA submission date; validate or submit SIBA guest data.
Create/update properties and reservations; cancel or delete reservations.
Add/remove guests and all reservation extras.
Create/close/delete invoices; add invoice lines, receipts, and credit notes; generate SAF-T.
Add, delete, or disable expenses.
API access is property-scoped through HOSTKIT_API_KEY; no generic unrestricted endpoint caller.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Hostkit MCP list my upcoming reservations"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Hostkit API v2 Local MCP
Local MCP client for the Hostkit API v2, with automatic HMAC signing.
Full documentation: https://docs.hostkit.pt
LLMs index: https://docs.hostkit.pt/llms.txt
Installation
Create an API key and its HMAC secret in Hostkit -> My Account, then configure your MCP client:
{
"mcpServers": {
"hostkit": {
"command": "npx",
"args": ["-y", "github:hostkitpt/mcp"],
"env": {
"HOSTKIT_API_V2_KEY": "YOUR_API_KEY",
"HOSTKIT_API_V2_SECRET": "YOUR_HMAC_SECRET"
}
}
}
}The command is:
npx -y github:hostkitpt/mcpThe explicit executable remains available:
npx -y --package=github:hostkitpt/mcp hostkit-mcp-v2Both commands start the same API v2 client. This repository supports API v2 only.
Related MCP server: guesty-mcp-server
Security
Store credentials locally. Never share them in prompts, exported collections or source control.
Each request is signed automatically. Account IP whitelist rules also apply to MCP requests.
Review write, destructive and fiscal operations before invoking them. The client does not retry writes automatically; confirm uncertain results before retrying because repeated writes can create duplicates.
Disclaimer
Hostkit is not responsible for API misuse, incorrect implementations or unintended actions caused by third-party code.
Available Tools
36 toolshostkit_add_credit_noteC
Create a credit note for a closed invoice.
Inputs: refseries (required), refid (required), invoicing_nif, invoice_type.
hostkit_add_guestB
Add guest data to a reservation.
Inputs: rcode (required), nationality (required), birthday (required), doc_id (required), +9 more.
hostkit_add_invoiceB
Create an open invoice document.
Inputs: customer_id (required), name (required), country (required), invoicing_nif, +8 more.
hostkit_add_invoice_lineB
Add a line to an open invoice.
Inputs: id (required), product_id (required), custom_descr (required), qty (required), +9 more.
hostkit_add_propertyB
Create a property and return the new property API key.
Inputs: property_name (required), address (required), zip (required), city (required), +15 more.
hostkit_add_receiptC
Create a receipt for an FT invoice.
Inputs: refseries (required), refid (required), invoicing_nif.
hostkit_add_reservationC
Create a reservation in Hostkit.
Inputs: rcode (required), check_in (required), check_out (required), name, +29 more.
hostkit_add_reservation_extraC
Add an extra line to a reservation and create the product if needed.
Inputs: rcode (required), extra_id (required), extra_name (required), extra_vat (required), +2 more.
hostkit_cancel_reservationB
Move a reservation to Hostkit cancellations.
Inputs: rcode (required).
hostkit_close_invoiceB
Close an open invoice and return its public URL/token.
Inputs: id (required), invoicing_nif, series, invoice_type.
hostkit_delete_invoiceC
Delete an open invoice.
Inputs: id (required), invoicing_nif, series, invoice_type.
hostkit_delete_reservationB
Permanently delete a reservation and related records.
Inputs: rcode (required).
hostkit_delete_reservation_extrasB
Delete all extras from one reservation.
Inputs: rcode (required).
hostkit_generate_saftB
Generate a SAF-T file for an invoicing account.
Inputs: invoicing_nif (required), year (required), month (required).
hostkit_get_credit_notesB
List credit notes or filter a specific credit note.
Inputs: invoice_type, invoicing_nif, series, id, +3 more.
hostkit_get_expensesC
List expenses by document date range.
Inputs: date_start (required), date_end (required).
hostkit_get_invoicesC
List invoices or filter a specific invoice.
Inputs: invoicing_nif, series, id, customer_id, +4 more.
hostkit_get_keycodeB
Get the smartlock keycode or invite code for one reservation.
Inputs: rcode (required), provider (required).
hostkit_get_last_siba_dateA
Get the last successfully submitted SIBA bulletin date.
Inputs: no named parameters.
hostkit_get_licenseB
Get Hostkit account license plan and expiration date.
Inputs: no named parameters.
hostkit_get_online_checkinA
Get online check-in link and status for one reservation.
Inputs: rcode (required).
hostkit_get_paymentsB
Get all payments for one reservation.
Inputs: rcode (required).
hostkit_get_propertiesA
List all properties visible to the configured API key.
Inputs: no named parameters.
hostkit_get_propertyB
Get details for one Hostkit property.
Inputs: id.
hostkit_get_receiptsB
List receipts or filter a specific receipt.
Inputs: invoicing_nif, series, id, customer_id, +2 more.
hostkit_get_reservationC
Get one reservation by Hostkit reservation code.
Inputs: rcode (required), get_archived.
hostkit_get_reservation_by_cm_idA
Get one reservation by channel manager name and reservation ID.
Inputs: channelmanager (required), id (required).
hostkit_get_reservation_invoicesA
List invoices for one reservation.
Inputs: rcode (required), invoicing_nif.
hostkit_get_reservationsC
List reservations filtered by check-in, checkout, or reservation date.
Inputs: from_date, to_date, date_filter, reservation_date, +2 more.
hostkit_get_saftB
Get a generated SAF-T file as base64 content.
Inputs: invoicing_nif (required), year (required), month (required).
hostkit_remove_all_guestsA
Remove all guest data from one reservation.
Inputs: rcode (required).
hostkit_remove_guestA
Remove one guest from a reservation by name or first_name/last_name.
Inputs: rcode (required), name, first_name, last_name.
hostkit_send_sibaB
Submit SIBA data for a reservation or explicit guest data.
Inputs: rcode, name, first_name, last_name, +9 more.
hostkit_update_propertyC
Update the property attached to the configured API key.
Inputs: property_name, address, zip, city, +15 more.
hostkit_update_reservationC
Update a reservation in Hostkit.
Inputs: rcode (required), name, first_name, last_name, +29 more.
hostkit_validate_sibaA
Validate SIBA data for one reservation or for explicit guest data without submitting it.
Inputs: rcode, name, first_name, last_name, +9 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 36 tools
Every tool has a clear, distinct purpose. The names combine a domain prefix (hostkit_) with a verb and noun, making it easy to differentiate between tools for reservations, invoices, properties, etc. Even similar-looking tools like get_reservation and get_reservation_by_cm_id have distinct lookup methods.
All tools follow a consistent hostkit_verb_noun pattern, using lowercase and underscores throughout. Verbs are predictable (add, get, delete, update, cancel, close, etc.) and nouns refer to the resource, maintaining high consistency.
With 36 tools, the server covers multiple subdomains (reservations, invoicing, properties, guests, SIBA, SAF-T) comprehensively. While the count is higher than typical, it remains well-scoped and each tool serves a distinct function without unnecessary bloat.
The tool surface covers core CRUD operations for major entities (reservations, invoices, properties, guests) and includes specialized actions like SAF-T generation, SIBA validation, and credit notes. A few minor gaps exist (e.g., no update for invoices or credit notes), but the set is largely complete for domain tasks.
Related MCP Connectors
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.
MCP server for Hostkey .ru (InvAPI): servers, power, order, DNS, S3, billing
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 hospitalit5325 npm1MIT
- AlicenseBqualityAmaintenanceMCP server for Guesty property management. Manage reservations, guests, messaging, financials, listings, and operations via AI clients.43100 npm6MIT

Rentalot MCP Serverofficial
AlicenseNot gradedqualityBmaintenanceMCP server for the Rentalot API. Manage rental properties, contacts, showings, conversations, and more from any AI assistant.12 npm1MIT- AlicenseBqualityDmaintenanceMCP server for the adm.tools / ukraine.com.ua hosting API, providing tools to manage hosting services, accounts, sites, and web apps.51MIT