MCP-Server für die Tibber-API: Preise, Verbrauch, Pulse-Live-Daten
Server has 7 well-named tools with clear descriptions in German. All tools have input schemas with type definitions and parameter descriptions. However, output schemas are not formally documented in the code, responses are inferred from implementation. Parameter descriptions are present but some lack detail on constraints (e.g., 'resolution' enum values not listed in description, only in docstring). Error handling is present but generic. No tool annotations (readOnlyHint, destructiveHint) despite all tools being read-only. Naming follows verb_noun pattern well (get_*, find_*). Descriptions average ~120 chars, within baseline range. Parameters average 2-4 per tool, reasonable. Missing: explicit output schema documentation, parameter constraint details in descriptions, tool annotations.
Findet die günstigsten Stunden für einen Verbraucher (Waschmaschine, Spülmaschine, E-Auto-Ladung).
Historischer Verbrauch pro Periode: kWh, Kosten (EUR), Durchschnittspreis.
Aggregierter Verbrauchs-/Kostenreport mit Vergleich zur Vorperiode.
Aktueller Strompreis mit Einordnung: Tibber-Level, Rang im Tagesverlauf und prozentuale Abweichung vom Tagesdurchschnitt.
Alle Homes im Tibber-Account: Adresse, Tarifstatus, Zählpunkt und ob ein Tibber Pulse (Live-Daten) vorhanden ist.
Live-Messung vom Tibber Pulse: aktuelle Leistung (W), Min/Max im Messfenster, Tagesverbrauch (kWh) und Tageskosten (EUR). Wartet bis zu 15 Sekunden, endet sobald Messwerte vorliegen. Benötigt einen Tibber Pulse am Zähler.
Output schemas not formally documented. Responses are inferred from implementation code (_day_summary, _format_home helpers) but no explicit schema definitions visible. LLMs cannot reliably predict response structure for planning downstream calls.
Parameter constraints not fully described in parameter descriptions. 'resolution' accepts HOURLY|DAILY|WEEKLY|MONTHLY but description only says 'HOURLY, DAILY, WEEKLY oder MONTHLY', should be enum in schema. 'window' in find_cheapest_hours has enum values in description but not in schema type.
No tool annotations despite all tools being read-only. Missing readOnlyHint in tool definitions. This prevents agents from understanding which tools are safe to call without side effects.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | B | 70 | 2026-07-28+ | v2 |
Stundenpreise für heute und (falls schon publiziert) morgen, jeweils mit Min/Max/Durchschnitt und günstigster/teuerster Stunde.
Error messages are generic (TibberApiError with text). No error classification (retryable vs user-fixable vs fatal) or recovery guidance. E.g., 'Kein Home im Tibber-Account gefunden' does not suggest next steps.
Parameter 'home_id' is optional with smart default (first home), but description says 'optional, nutzt erstes Home als Default', does not explain what happens if no homes exist or if the provided ID is invalid. Undocumented error path.