Quellenkontor HR-Daten

Steuerfreie Beträge und Werbungskostenpauschalen

hr_steuerfreie_betraege

Read-onlyIdempotent

Nur Deutschland. Freibeträge und Freigrenzen für Leistungen des Arbeitgebers und Werbungskostenpauschalen der Beschäftigten an einem Stichtag ab 2015: Sachbezugsfreigrenze (50-Euro-Grenze), Aufmerksamkeiten, Betriebsveranstaltung, Rabattfreibetrag, … English: Tax-free limit for benefits in kind (€50 limit), company events and other allowances, plus the employee lump sum, home office and …

Input Schema

TableJSON Schema

Name	Required	Description	Default
`datum`	No	Stichtag im Format JJJJ-MM-TT. Ohne Angabe gilt der heutige Tag.
`bestandteil`	No	Nur diesen Bestandteil liefern und zitieren, etwa für eine einzelne Frage (optional). Erlaubt sind die ids der Bestandteile.

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedSep 26, 2026

changedInput schema / properties / bestandteil / enum

Previous value: -[
-  "sachbezug_freigrenze",
-  "aufmerksamkeiten_freigrenze",
-  "betriebsveranstaltung_freibetrag",
-  "rabatt_freibetrag",
-  "gesundheitsfoerderung_freibetrag",
-  "mahlzeit_auswaerts_preisgrenze",
-  "aktivrente_freibetrag",
-  "vermoegensbeteiligung_freibetrag",
-  "kurzfristige_betreuung_freibetrag",
-  "bav_steuerfrei_prozent_bbg",
-  "bav_zusatzbetrag_neuzusage",
-  "inflationsausgleichspraemie",
-  "corona_praemie",
-  "pflegebonus",
-  "uebungsleiter_freibetrag",
-  "ehrenamt_freibetrag",
-  "fahrtkostenzuschuss_pauschalsteuer",
-  "erholungsbeihilfe_arbeitnehmer",
-  "erholungsbeihilfe_ehegatte",
-  "erholungsbeihilfe_kind",
-  "sachzuwendungen_37b_hoechstbetrag",
-  "sachzuwendungen_37b_steuersatz",
-  "arbeitnehmer_pauschbetrag",
-  "homeoffice_tag",
-  "homeoffice_hoechstbetrag",
-  "entfernungspauschale_bis_20_km",
-  "entfernungspauschale_ab_21_km",
-  "entfernungspauschale_hoechstbetrag"
-]New value: +[
+  "sachbezug_freigrenze",
+  "aufmerksamkeiten_freigrenze",
+  "betriebsveranstaltung_freibetrag",
+  "rabatt_freibetrag",
+  "gesundheitsfoerderung_freibetrag",
+  "mahlzeit_auswaerts_preisgrenze",
+  "aktivrente_freibetrag",
+  "vermoegensbeteiligung_freibetrag",
+  "kurzfristige_betreuung_freibetrag",
+  "bav_steuerfrei_prozent_bbg",
+  "bav_zusatzbetrag_neuzusage",
+  "inflationsausgleichspraemie",
+  "corona_praemie",
+  "pflegebonus",
+  "uebungsleiter_freibetrag",
+  "ehrenamt_freibetrag",
+  "fahrtkostenzuschuss_pauschalsteuer",
+  "erholungsbeihilfe_arbeitnehmer",
+  "erholungsbeihilfe_ehegatte",
+  "erholungsbeihilfe_kind",
+  "sachzuwendungen_37b_hoechstbetrag",
+  "sachzuwendungen_37b_steuersatz",
+  "arbeitnehmer_pauschbetrag",
+  "homeoffice_tag",
+  "homeoffice_hoechstbetrag",
+  "entfernungspauschale_bis_20_km",
+  "entfernungspauschale_ab_21_km",
+  "entfernungspauschale_hoechstbetrag",
+  "geschenke_freigrenze"
+]

Changed2 schema fields changedSep 25, 2026

removedInput schema / properties / datum / pattern
```
Removed value: -"^\\d{4}-\\d{2}-\\d{2}$"
```

changedOutput schema / (root)

Previous value: -{
-  "additionalProperties": true,
-  "properties": {
-    "bestandteile": {
-      "description": "Je Betrag Wert, Einheit, Gruppe, Art, Wirkung, Gültigkeit, Rechtsgrundlage und Quelle (Liste)"
-    },
-    "datensatz": {
-      "description": "Kennung des Datensatzes (Text)"
-    },
-    "datenstand": {
-      "description": "Kennung des Datenstands: Datum und laufende Nummer der letzten Änderung im Änderungsprotokoll (/v1/aenderungen), die diesen Datensatz betrifft. Gleicher Datenstand heißt unveränderter Inhalt, praktisch für Prüfer und zum Vergleich zweier Abfragen (Text)"
-    },
-    "datum": {
-      "description": "Abgefragter Stichtag (Datum)"
-    },
-    "hinweise": {
-      "description": "Grenzen der Werte oder der Berechnung, in Sätzen (Liste)"
-    },
-    "lizenz": {
-      "description": "Nutzungsbedingungen der Werte (Text)"
-    },
-    "regeln": {
-      "description": "Regeln aus EStG und LStR (Liste)"
-    },
-    "stand": {
-      "description": "Tag der letzten Prüfung gegen die Quelle (Datum)"
-    },
-    "vorlaeufig": {
-      "description": "true, wenn für den Stichtag noch nicht alle Werte festgelegt sind (Boolesch)"
-    },
-    "werte": {
-      "additionalProperties": true,
-      "description": "Kurzform: Bestandteil und Wert am Stichtag, null solange ein angekündigter Wert fehlt",
-      "properties": {
-        "aktivrente_freibetrag": {
-          "description": "Aktivrente: steuerfreier Arbeitslohn nach Erreichen der Regelaltersgrenze, höchstens im Jahr, Euro im Jahr",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "arbeitnehmer_pauschbetrag": {
-          "description": "Arbeitnehmer-Pauschbetrag (Werbungskostenpauschale), Euro im Jahr",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "aufmerksamkeiten_freigrenze": {
-          "description": "Aufmerksamkeiten, Freigrenze je Anlass, Euro",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "bav_steuerfrei_prozent_bbg": {
-          "description": "Betriebliche Altersversorgung: steuerfreie Arbeitgeberbeiträge, Höchstbetrag in Prozent der Beitragsbemessungsgrenze der Rentenversicherung im Jahr, Prozent",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "bav_zusatzbetrag_neuzusage": {
-          "description": "Betriebliche Altersversorgung: zusätzlicher steuerfreier Betrag für Versorgungszusagen ab 2005, Euro im Jahr",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "betriebsveranstaltung_freibetrag": {
-          "description": "Betriebsveranstaltung, Freibetrag je Veranstaltung und teilnehmendem Arbeitnehmer, Euro",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "corona_praemie": {
-          "description": "Corona-Beihilfe (Corona-Prämie), steuerfreier Höchstbetrag, Euro",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "ehrenamt_freibetrag": {
-          "description": "Ehrenamtspauschale, Euro im Jahr",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "entfernungspauschale_ab_21_km": {
-          "description": "Entfernungspauschale je Entfernungskilometer und Arbeitstag ab dem 21. Kilometer, Euro je Kilometer",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "entfernungspauschale_bis_20_km": {
-          "description": "Entfernungspauschale je Entfernungskilometer und Arbeitstag, 1. bis 20. Kilometer, Euro je Kilometer",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "entfernungspauschale_hoechstbetrag": {
-          "description": "Entfernungspauschale, Höchstbetrag im Jahr, Euro im Jahr",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "erholungsbeihilfe_arbeitnehmer": {
-          "description": "Erholungsbeihilfe, Grenze für die Pauschalierung mit 25 Prozent: Arbeitnehmer, Euro im Jahr",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "erholungsbeihilfe_ehegatte": {
-          "description": "Erholungsbeihilfe, Grenze für die Pauschalierung mit 25 Prozent: Ehegatte oder Lebenspartner, Euro im Jahr",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "erholungsbeihilfe_kind": {
-          "description": "Erholungsbeihilfe, Grenze für die Pauschalierung mit 25 Prozent: je Kind, Euro im Jahr",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "fahrtkostenzuschuss_pauschalsteuer": {
-          "description": "Fahrtkostenzuschuss und Beförderung zwischen Wohnung und erster Tätigkeitsstätte, Pauschsteuersatz, Prozent",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "gesundheitsfoerderung_freibetrag": {
-          "description": "Betriebliche Gesundheitsförderung, Freibetrag im Jahr, Euro im Jahr",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "homeoffice_hoechstbetrag": {
-          "description": "Homeoffice-Pauschale, Höchstbetrag im Jahr, Euro im Jahr",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "homeoffice_tag": {
-          "description": "Homeoffice-Pauschale je Tag (Tagespauschale), Euro je Tag",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "inflationsausgleichspraemie": {
-          "description": "Inflationsausgleichsprämie, steuerfreier Höchstbetrag, Euro",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "kurzfristige_betreuung_freibetrag": {
-          "description": "Kurzfristige Betreuung von Kindern und pflegebedürftigen Angehörigen, Freibetrag im Jahr, Euro im Jahr",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "mahlzeit_auswaerts_preisgrenze": {
-          "description": "Mahlzeit bei Auswärtstätigkeit oder doppelter Haushaltsführung, Preisgrenze je Mahlzeit für den Ansatz mit dem Sachbezugswert, Euro",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "pflegebonus": {
-          "description": "Pflegebonus für Beschäftigte in Krankenhäusern, Pflege- und bestimmten anderen Einrichtungen, steuerfreier Höchstbetrag, Euro",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "rabatt_freibetrag": {
-          "description": "Rabattfreibetrag für Personalrabatte, Euro im Jahr",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "sachbezug_freigrenze": {
-          "description": "Sachbezugsfreigrenze, Euro im Monat",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "sachzuwendungen_37b_hoechstbetrag": {
-          "description": "Sachzuwendungen, Pauschalierung nach § 37b EStG: Höchstbetrag je Empfänger und Wirtschaftsjahr und je Zuwendung, Euro",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "sachzuwendungen_37b_steuersatz": {
-          "description": "Sachzuwendungen, Pauschalierung nach § 37b EStG: Pauschsteuersatz, Prozent",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "uebungsleiter_freibetrag": {
-          "description": "Übungsleiterpauschale, Euro im Jahr",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "vermoegensbeteiligung_freibetrag": {
-          "description": "Vermögensbeteiligung am Unternehmen des Arbeitgebers, Freibetrag im Jahr, Euro im Jahr",
-          "type": [
-            "number",
-            "null"
-          ]
-        }
-      },
-      "type": "object"
-    },
-    "zitat": {
-      "description": "Fertiger Satz mit Wert, Gültigkeit, Rechtsgrundlage und Quelle zum Zitieren (Text)"
-    }
-  },
-  "type": "object"
-}New value: +null

First observedSep 25, 2026

TDQS

B3.2/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare read-only, idempotent, non-destructive behavior; the description adds useful context by limiting the tool to Germany and to data from 2015 onward. However, it does not disclose response shape or default behavior when no 'bestandteil' is supplied, so it adds only moderate value beyond the annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is short and front-loaded with the critical geographic and temporal scope, followed by concrete examples. The English sentence partly repeats the German content but is a helpful bilingual clarification rather than filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a two-parameter read-only tool with a fully documented enum and schema, the description supplies enough domain context (employer benefits, employee lump sums, date applicability) to support selection and invocation. It does not describe return values, but no output schema exists and the values are self-evident from the component ids.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%: the input schema fully documents 'datum' (format and default) and 'bestandteil' (allowed enum ids and their meaning). The tool description merely previews some enum values and does not add parameter-level detail beyond the schema, so the baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a clear resource—tax-free amounts, exemption limits, and employee lump-sum allowances—and adds scope constraints ('Nur Deutschland', 'Stichtag ab 2015') that help distinguish it from sibling HR tax tools. It stops short of 5 because it has no explicit verb such as 'returns' or 'liefert'.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives no guidance on when to choose this tool over alternatives such as hr_sachbezugswerte, hr_bav_hoechstbetraege, or hr_rechengroessen. 'Nur Deutschland' is a scope constraint, not an explicit when-to-use or when-not-to-use rule.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Quellenkontor HR-Daten tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Steuerfreie Beträge und Werbungskostenpauschalen

Input Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources