german-tax-skills

• 🧮 122 endpoints: payroll, income and capital taxes, property, social benefits, reference data
• 🚫 No guessing: the agent never estimates a tax figure, it calls the API or says it can’t
• 🔑 Key stays local: read from .env or the environment, masked in every output, never asked for in the chat
• 📉 Quota-aware: warns before your RapidAPI plan runs out and stops cleanly when it has
• 🪶 Zero dependencies: Python standard library only
• 🐍 Python 3.10 – 3.14: tested on Linux, pure Python with no platform-specific code

🇩🇪 Deutsch: weiter unten gibt es eine Kurzfassung auf Deutsch.

---

Quickstart

After installing and setting your key, just ask:

My employer can spend 6,000 € a month on me in total. What gross salary is that, and how much do I keep? Tax class 1, North Rhine-Westphalia.

The skill reads the endpoint reference, then runs:

python3 scripts/call.py POST v1/lohnkosten-netto   '{"lohnkosten_ziel": 6000, "steuerklasse": 1, "bundesland": "Nordrhein-Westfalen"}'

and gets back (real response, shortened):

{
  "success": true,
  "data": {
    "brutto_monat": "4888.38",
    "netto_monat": "3072.91",
    "lohnsteuer_monat": "752.25",
    "soli_monat": "0.0",
    "sv_gesamt_monat": "1063.22",
    "ag_gesamt": "1111.62"
  },
  "input_echo": {
    "kirchensteuer": false,
    "kinder": 0,
    "geburtsjahr": 1985,
    "kv_zusatzbeitrag": "2.9"
  },
  "meta": { "tax_year": 2026 }
}