unofficialMCP4Vaillant
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| VAILLANT_BRAND | No | One of vaillant, sdbg, bulex, glow-worm | vaillant |
| VAILLANT_COUNTRY | No | Country slug | germany |
| VAILLANT_PASSWORD | Yes | MyVaillant account password | |
| VAILLANT_USERNAME | Yes | MyVaillant account email | |
| VAILLANT_LOG_LEVEL | No | DEBUG / INFO / WARNING / ERROR | INFO |
| VAILLANT_CACHE_ENABLED | No | Disable for debugging | true |
| VAILLANT_DEFAULT_SYSTEM_ID | No | Override picked system when more than one exists |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| vaillant_get_statusA | Current snapshot of the Vaillant heat pump system: outdoor temperature, water pressure, energy manager state, plus per-zone, per-circuit, per-DHW, per-ventilation details. Read-only. |
| vaillant_get_devicesA | Static hardware inventory: home name, controller model, firmware, plus all heat-generators, backup heaters, ventilation, gateway. Read-only. |
| vaillant_get_energy_reportB | Energy consumption and generation per device per operation_mode for a given time range, in the home's local timezone. Includes a derived cop_estimate (heat_generated / consumed_electrical) with a quality flag. |
| vaillant_get_diagnosticsB | Diagnostic snapshot split into engineering_config (heating curve, bivalence points, controller type) and volatile_state (DTCs, holiday, system_off). Read-only. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 4 tools
Each tool targets a distinct aspect: devices for hardware inventory, diagnostics for configuration and faults, energy report for consumption data, and status for live system state. No overlap in purpose.
All tools follow a consistent pattern: 'vaillant_get_<resource>', using snake_case and a uniform verb-noun structure.
Four tools is well-scoped for a read-only monitoring server covering essential areas: inventory, diagnostics, energy, and live status.
Covers all key read-only needs for a heat pump system. Minor gap: no historical trending beyond energy report, and no tool for firmware updates or config changes, but those are likely write operations outside scope.