hut-reservation-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NOMINATIM_EMAIL | No | Contact email for geocoder requests, if required by the provider. | |
| NOMINATIM_BASE_URL | No | Base URL for a Nominatim-compatible reverse geocoder. Required before refresh_area_cache can use geocoding. | |
| NOMINATIM_USER_AGENT | No | Identifying User-Agent for geocoder requests. | |
| HUT_RESERVATION_PASSWORD | No | Standard hut-reservation.org password. | |
| HUT_RESERVATION_USERNAME | No | Standard hut-reservation.org username. | |
| HUT_RESERVATION_AUTH_MODE | No | Authentication mode. Use standard for username/password or sac for SAC browser-session cookies. | |
| HUT_RESERVATION_CACHE_DIR | No | Cache directory. Defaults to the server's local cache behavior. | |
| NOMINATIM_MIN_INTERVAL_MS | No | Minimum interval between geocoder requests. | |
| HUT_RESERVATION_XSRF_TOKEN | No | SAC XSRF-TOKEN cookie value. | |
| HUT_RESERVATION_DOTENV_PATH | No | Path to a specific .env file. | |
| HUT_RESERVATION_COOKIE_HEADER | No | Combined cookie header, for example SESSION=...; XSRF-TOKEN=... | |
| HUT_RESERVATION_SESSION_COOKIE | No | SAC SESSION cookie value. | |
| HUT_RESERVATION_DOTENV_DISABLED | No | Set to true to disable dotenv loading. | |
| HUT_RESERVATION_REQUEST_TIMEOUT_MS | No | Upstream request timeout in milliseconds. | |
| HUT_RESERVATION_EXPERIMENTAL_WRITES | No | Set to true to allow raw-payload experimental write confirmation. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| auth_statusA | Report whether hut-reservation.org credentials and an upstream session are available. |
| refresh_hut_catalogA | Fetch hut-reservation.org hut list and hut details into the local cache. This performs read-only upstream calls and mutates only the local cache. |
| refresh_area_cacheB | Reverse-geocode cached hut coordinates through the configured Nominatim-compatible provider. Requires explicit geocoder configuration. |
| search_hutsA | Search cached huts by country, canton cache, text, and/or distance around coordinates. Does not call a geocoder during search. |
| search_hut_availabilityA | Search huts with enough free places for every night in an exact arrival/departure period. Tool dates are ISO YYYY-MM-DD. By default all matched cached huts are checked; maxCandidates intentionally returns a partial result. |
| prepare_bookingA | Check availability and create a short-lived booking draft. By default this returns a browser handoff URL rather than writing upstream. |
| confirm_bookingA | Confirm a prepared booking draft. Headless submit only runs when experimental writes are enabled and the draft contains a raw upstream payload. |
| list_bookingsC | List authenticated user's reservations through hut-reservation.org myReservations. |
| prepare_cancellationA | Fetch reservation summary/fee context and create a short-lived cancellation draft. Confirmed cancellation remains browser-handoff only. |
| confirm_cancellationA | Confirm a cancellation draft. This currently returns a browser handoff because confirmed-reservation cancellation semantics are not verified. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/domwoe/hut-reservation-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server