Skip to main content
Glama

Quellenkontor HR-Daten

by dev.quellenkontor
OverviewDiscussionsAdmin

Minijob-Abgaben: Pauschalabgaben des Arbeitgebers

hr_minijob_abgaben
Read-onlyIdempotent

Nur Deutschland. Pauschalabgaben des Arbeitgebers für Minijobs (geringfügig entlohnte Beschäftigung) an einem Stichtag ab 2015: Pauschalbeiträge Kranken- und Rentenversicherung, Pauschsteuer, Umlagen U1 und U2 der Minijob-Zentrale, … English: Flat-rate contributions, flat-rate tax and levies that employers pay for mini-jobs, in businesses and in private households.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
datumNoStichtag im Format JJJJ-MM-TT. Ohne Angabe gilt der heutige Tag.
bestandteilNoNur 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.

  1. Changed2 schema fields changed
    • removedInput schema / properties / datum / pattern
      Removed value: -"^\\d{4}-\\d{2}-\\d{2}$"
    • changedOutput schema / (root)
      Previous value: -{
-  "additionalProperties": true,
-  "properties": {
-    "bestandteile": {
-      "description": "Je Abgabe Satz, Gruppe, 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 dem Gesetz in Sätzen, je mit Norm (Liste)"
-    },
-    "stand": {
-      "description": "Tag der letzten Prüfung gegen die Quelle (Datum)"
-    },
-    "summen": {
-      "description": "Höchstbelastung des Arbeitgebers in Prozent, gewerblich und im Privathaushalt (Objekt)"
-    },
-    "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": {
-        "gewerblich_insolvenzgeldumlage": {
-          "description": "Insolvenzgeldumlage, gewerblicher Minijob, Prozent",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "gewerblich_kv": {
-          "description": "Pauschalbeitrag Krankenversicherung, gewerblicher Minijob, Prozent",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "gewerblich_pauschsteuer": {
-          "description": "Einheitliche Pauschsteuer, gewerblicher Minijob, Prozent",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "gewerblich_rv": {
-          "description": "Pauschalbeitrag Rentenversicherung, gewerblicher Minijob, Prozent",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "gewerblich_rv_eigenanteil": {
-          "description": "Eigenanteil des Minijobbers zur Rentenversicherung, gewerblicher Minijob, Prozent",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "gewerblich_u1": {
-          "description": "Umlage U1 (Krankheit), gewerblicher Minijob, Prozent",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "gewerblich_u2": {
-          "description": "Umlage U2 (Mutterschaft), gewerblicher Minijob, Prozent",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "privat_kv": {
-          "description": "Pauschalbeitrag Krankenversicherung, Minijob im Privathaushalt, Prozent",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "privat_pauschsteuer": {
-          "description": "Einheitliche Pauschsteuer, Minijob im Privathaushalt, Prozent",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "privat_rv": {
-          "description": "Pauschalbeitrag Rentenversicherung, Minijob im Privathaushalt, Prozent",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "privat_rv_eigenanteil": {
-          "description": "Eigenanteil des Minijobbers zur Rentenversicherung, Minijob im Privathaushalt, Prozent",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "privat_u1": {
-          "description": "Umlage U1 (Krankheit), Minijob im Privathaushalt, Prozent",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "privat_u2": {
-          "description": "Umlage U2 (Mutterschaft), Minijob im Privathaushalt, Prozent",
-          "type": [
-            "number",
-            "null"
-          ]
-        },
-        "privat_unfallversicherung": {
-          "description": "Beitrag zur gesetzlichen Unfallversicherung, Minijob im Privathaushalt, Prozent",
-          "type": [
-            "number",
-            "null"
-          ]
-        }
-      },
-      "type": "object"
-    },
-    "zitat": {
-      "description": "Fertiger Satz mit Wert, Gültigkeit, Rechtsgrundlage und Quelle zum Zitieren (Text)"
-    }
-  },
-  "type": "object"
-}New value: +null
  2. First observed

TDQS

A4/5.0
Behavior4/5

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

Annotations declare readOnlyHint=true, idempotentHint=true, and destructiveHint=false, so the operation is safe and deterministic. The description adds valuable context beyond annotations: it specifies the geographic restriction (Germany) and the date constraint (from 2015), which are not in annotations. It also lists the components returned, giving the agent an idea of the data scope. No contradictions with annotations exist.

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 two sentences, front-loading the critical restriction 'Nur Deutschland' and the date scope. The German and English versions together are efficient, though the English translation repeats the German content, which is slightly redundant but not wasteful. The colon-separated list of components is well-structured and scannable.

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

Completeness3/5

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

The tool has no output schema, and the description does not explain the return format or whether it returns a single value or a list. However, with zero required parameters and a well-defined schema for optional parameters, an agent can reasonably infer the tool returns contribution values for the requested date/component. The description covers the core purpose and constraints but lacks details on response structure, which is a minor gap given the tool's simplicity.

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?

The input schema has 100% coverage with clear descriptions for both parameters: 'datum' (date in YYYY-MM-DD format, defaults to today) and 'bestandteil' (enum of component IDs). The description mentions 'an einem Stichtag' (at a date) and lists the components, but these are already captured in the schema. The description adds minimal extra semantics beyond the schema, so the baseline score of 3 is appropriate.

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

Purpose5/5

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

The description clearly states the tool provides employer flat-rate contributions, taxes, and levies for mini-jobs in Germany, listing specific components (health and pension insurance, flat-rate tax, U1/U2 levies). This is a specific resource and action, distinguishing it from sibling tools like hr_beitragssaetze which cover general contribution rates. The bilingual format ensures clarity for both German and English agents.

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

Usage Guidelines4/5

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

It explicitly states 'Nur Deutschland' (only Germany) and 'an einem Stichtag ab 2015' (at a cutoff date from 2015), giving clear context for when the tool is applicable. It does not explicitly name alternative tools or state when not to use it, but the scope is narrow enough that an agent can infer its use for mini-job contribution queries. A clear exclusion of non-German contexts and pre-2015 dates is provided.

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 toolsInspect
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.

Resources