Skip to main content
Glama
Hostkit MCP

Hostkit MCP

Official
by hostkitpt

Hostkit API v2 Local MCP

Local MCP client for the Hostkit API v2, with automatic HMAC signing.

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/mcp

The explicit executable remains available:

npx -y --package=github:hostkitpt/mcp hostkit-mcp-v2

Both 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 tools
hostkit_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

    B3.4/5.0

    Scored across 36 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      This 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 hospitalit
      53
      25 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server for the Rentalot API. Manage rental properties, contacts, showings, conversations, and more from any AI assistant.
      12 npm
      1
      MIT