Wohngeld

Wohngeld (German housing benefit) eligibility check + benefit calculator + Wohngeldstelle lookup per WoGG 2024.

Tests License: MIT MCP Built with civic-ai-mcp-toolkit

---

Why this exists

~800.000 berechtigte Haushalte beziehen kein Wohngeld. Geschätzte €1 Mrd unbeansprucht/Jahr. Hauptgrund: niemand weiß ob er Anspruch hat, und die Antragstellung wirkt einschüchternd. Dieser MCP closes the information gap — Claude / Cursor / jeder MCP-Client kann in 30 Sekunden sagen:

"Ja, du bist berechtigt. Bei deinem 1-Personen-Haushalt in Berlin (Mietstufe VI), Rente €1.100, Miete €600 → ungefähr €340/Monat Wohngeld. Antrag stellen bei: Bezirksamt deines Wohnbezirks → Wohngeldstelle."

---

Tools exposed

Tool	Purpose
check_eligibility(monthly_income, household_size)	Schnelle Anspruchsprüfung gegen § 13 WoGG Einkommens-Höchstgrenze
calculate_wohngeld(income, rent, household_size, mietstufe)	Geschätzte Höhe per § 19 WoGG Formel (mit Höchstbetrag-Cap aus § 12)
get_max_rent(household_size, mietstufe)	Höchstbetrag der Miete per § 12 WoGG
get_mietstufe(city)	Mietstufe (I-VII) für ~90 deutsche Städte aus Wohngeld-Verordnung Anlage 1
find_wohngeldstelle(city_or_plz)	Patternhinweis + offizielle BMI-Suche (Wohngeld ist kommunal — keine zentrale Behörde)
get_required_documents()	Standard-Anlagenliste für den Antrag

---

Quickstart — Claude Desktop in one minute

git clone https://github.com/mikelninh/wohngeld-mcp
cd wohngeld-mcp
pip install -e .

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "wohngeld": {
      "command": "wohngeld-mcp"
    }
  }
}

Restart Claude Desktop. Try:

"Ich bin alleinstehend in Berlin, verdiene €1.500 netto, zahle €700 warmmiete. Habe ich Wohngeld-Anspruch?"

No API key needed. Alle Tools laufen offline.

---

Honest scope — read this first

This MCP is an approximate Anspruchsprüfung + Schätzrechner, kein offizieller Bescheid. Drei wichtige Limits:

1. Berechnungs-Genauigkeit ±10%. Die WoGG-Formel hat 5+ Variablen mit nach Haushaltsgröße variierenden Koeffizienten. Wir nutzen vereinfachte Durchschnittswerte. Für die exakte Berechnung den offiziellen BMI-Wohngeldrechner verwenden.

2. Stand 2024 / 2025. Nach jeder WoGG-Reform müssen Tabellen aktualisiert werden. Aktueller Datenstand: Wohngeld-Plus-Gesetz 2023 (= WoGG ab 1.1.2023, Anpassungen 2025).

3. Keine Antragstellung. Dieser MCP berechnet und informiert, stellt aber keinen Antrag. Antrag musst du beim örtlichen Wohngeldamt einreichen — manche Kommunen haben Online-Antrag, andere noch Papierform.

Wenn dir das nicht ausreicht: Verbraucherzentrale, kostenlose Sozialberatung, oder das Wohngeldamt direkt.

---

Test coverage

34 passed in <1s

• 6 max_rent tests (1-5 person, +6 person extra, Mietstufe boundaries, invalid input)
• 9 Mietstufe lookup tests (parametrized: München=VII, Berlin=VI, Hamburg=VI, …, case-insensitive, unknown fallback)
• 5 eligibility tests (low/high income, household-size matters, negative input)
• 8 calculate_wohngeld tests (typical Berlin Rentnerin, zero for high income, rent-capping, verify_at link, max cap, error envelopes, honest_note presence)
• 2 Wohngeldstelle tests
• 1 documents list test
• 3 JSON-serialisability + parametrized tests

---

Part of an MCP-server portfolio

Built on civic-ai-mcp-toolkit. 10. öffentlicher MCP im Portfolio.

Sibling MCPs:

• gitlaw-mcp · safevoice-mcp · pmm-mcp · elterngeld-mcp · flight-rights-mcp · agb-reader-mcp · judge-mcp · grailsense

Composition pattern: kann mit gitlaw-mcp komponiert werden für vollen WoGG-Paragraph-Text als Quelle hinter jeder Berechnung.

---

Roadmap

• BMI-Wohngeldrechner-Pipeline: scrape den offiziellen Rechner als Verifikation für unsere Approximation
• Mehr Städte in Mietstufen-Lookup (aktuell ~90 → Ziel 500)
• Selbständigen-Sonderfälle: zvE statt monatliches Brutto
• § 16 WoGG Freibeträge-Helper (Steuer + KrV + RV Abzüge automatisch)
• Wohngeld + Bürgergeld + KiZ Vergleichs-Rechner (was lohnt sich)
• Compose mit gitlaw-mcp für WoGG-Paragraph-Lookup

---

License

MIT.