Hostkit MCP

MCP server for the Hostkit API.

API documentation: https://hostkit.pt/api/

The server talks to the public Hostkit API through:

https://app.hostkit.pt/api/{endpoint}?APIKEY=...

For enhanced security, API keys are property based, therefore must be generated and maintained in the Hostkit App -> Properties -> API key tab of each property.

A rate limiting is enforced, please check the API documentation for the current limit.

Requirements

• Node.js 20+

• Hostkit API key

Check

npm run check

Run

HOSTKIT_API_KEY="your-api-key" npm start

Or without npm:

HOSTKIT_API_KEY="your-api-key" node src/server.mjs

The MCP exposes both read and write endpoints. Use API keys with the same care as direct Hostkit API access.

MCP Client Config

Example stdio configuration:

{
  "mcpServers": {
    "hostkit": {
      "command": "npx",
      "args": ["-y", "github:hostkitpt/mcp"],
      "env": {
        "HOSTKIT_API_KEY": "your-api-key"
      }
    }
  }
}

For local development before publishing:

{
  "mcpServers": {
    "hostkit": {
      "command": "node",
      "args": ["/path/to/api/mcp/src/server.mjs"],
      "env": {
        "HOSTKIT_API_KEY": "your-api-key"
      }
    }
  }
}

Publish to GitHub

git remote add origin https://github.com/hostkitpt/mcp.git
git push -u origin main

Tools

• hostkit_get_license

• hostkit_get_properties

• hostkit_get_property

• hostkit_get_reservations

• hostkit_get_reservation

• hostkit_get_reservation_by_cm_id

• hostkit_get_payments

• hostkit_get_online_checkin

• hostkit_get_keycode

• hostkit_get_invoices

• hostkit_get_reservation_invoices

• hostkit_get_receipts

• hostkit_get_credit_notes

• hostkit_get_saft

• hostkit_get_expenses

• hostkit_get_last_siba_date

• hostkit_validate_siba

• hostkit_add_property

• hostkit_update_property

• hostkit_add_reservation

• hostkit_update_reservation

• hostkit_cancel_reservation

• hostkit_delete_reservation

• hostkit_add_guest

• hostkit_remove_guest

• hostkit_remove_all_guests

• hostkit_add_reservation_extra

• hostkit_delete_reservation_extras

• hostkit_add_invoice

• hostkit_add_invoice_line

• hostkit_close_invoice

• hostkit_delete_invoice

• hostkit_add_receipt

• hostkit_add_credit_note

• hostkit_generate_saft

• hostkit_send_siba

Resources

• https://hostkit.pt/api/ - official Hostkit API documentation

Notes

• Hostkit errors are returned as structured text content with error, endpoint, status, and payload.

• The API key is never logged by this server.

• The server intentionally does not expose a generic unrestricted endpoint caller.