Quellenkontor Sdk MCP Server

Quellenkontor

Amtliche HR-Werte für Deutschland per API, SDK, CLI und MCP. Jeder Wert mit Quelle, Rechtsgrundlage und Gültigkeit.

Mindestlohn, Beitragsbemessungsgrenzen, Beitragssätze, Sachbezugswerte, Feiertage je Bundesland, Kündigungsfristen und 17 weitere Datensätze. Du fragst mit einem Stichtag ab und bekommst den Wert, der an diesem Tag gilt, samt Fundstelle im Bundesgesetzblatt oder Bundesanzeiger.

Website · Dokumentation · Kostenloser Schlüssel · Guides · English

---

Warum es das gibt

Jede HR- und Lohnsoftware in Deutschland pflegt dieselben Werte: zum 1. Januar, zum 1. Juli und immer dann, wenn eine Verordnung erscheint. Meist hängt das an einer Person, einer Tabelle und einem Kalendereintrag. Wird ein Wert zu spät oder falsch eingetragen, rechnet die Abrechnung falsch, und niemand merkt es sofort.

Quellenkontor übernimmt diese Pflege. Jeder Wert wird aus der amtlichen Quelle übernommen, geprüft und mit Gültigkeitszeitraum gespeichert. Künftige Werte kommen erst hinein, wenn sie verkündet sind, nicht schon beim Referentenentwurf. Wie das im Einzelnen läuft, steht im Prüfverfahren.

So sieht eine Antwort aus

curl "https://api.quellenkontor.dev/v1/hr/mindestlohn?datum=2027-01-15"

{
  "datensatz": "mindestlohn",
  "datum": "2027-01-15",
  "mindestlohn_brutto_stunde": 14.6,
  "minijob_grenze_monat": 633,
  "gueltig_ab": "2027-01-01",
  "gueltig_bis": null,
  "rechtsgrundlage": "Fünfte Mindestlohnanpassungsverordnung vom 5. November 2025 (BGBl. 2025 I Nr. 268), Stufe 2",
  "quelle": {
    "titel": "Fünfte Mindestlohnanpassungsverordnung vom 5. November 2025 (BGBl. 2025 I Nr. 268)",
    "url": "https://www.recht.bund.de/bgbl/1/2025/268/VO.html"
  },
  "vorheriger_wert": {
    "gueltig_ab": "2026-01-01",
    "mindestlohn_brutto_stunde": 13.9,
    "minijob_grenze_monat": 603
  }
}

Diese Abfrage funktioniert ohne Schlüssel. Mindestlohn, Feiertage und Rechengrößen antworten in einer Sandbox mit 50 Abfragen am Tag. Die Antwort ist hier gekürzt, die volle Fassung enthält noch Hinweise, Lizenz und einen fertigen Zitiersatz.

Für wen

Guides

Kurze Anleitungen für typische Aufgaben, jeweils mit Code zum Kopieren.

• Mindestlohn und Minijob-Grenze immer aktuell halten
• Jahreswechsel in der Lohnabrechnung vorbereiten
• Feiertage und Arbeitstage je Bundesland
• Kündigungsfristen richtig berechnen
• HR-Werte im KI-Agenten über MCP

Weitere Anwendungsfälle mit Hintergrund stehen auf quellenkontor.dev/anwendungsfaelle.

Die Datensätze

Parameter und Felder jedes Datensatzes stehen in der Referenz. Die Liste als JSON liefert https://api.quellenkontor.dev/v1/datensaetze.

Loslegen

Dieses Repository enthält die offiziellen Clients. Sie kommen ohne Pflicht-Abhängigkeiten aus (nur der asynchrone Python-Client braucht httpx, pip install "quellenkontor[async]") und sprechen dieselbe API.

import { Quellenkontor } from "@quellenkontor/sdk";

const qk = new Quellenkontor(process.env.QK_KEY);

const frist = await qk.hr.kuendigungsfrist({ eintritt: "2017-03-01", zugang: "2026-11-10" });
console.log(frist.ende); // "2027-02-28"

import os
from quellenkontor import Quellenkontor

qk = Quellenkontor(api_key=os.environ["QK_KEY"])

ml = qk.hr.mindestlohn(datum="2027-01-15")
print(ml["mindestlohn_brutto_stunde"])  # 14.6

npx @quellenkontor/cli feiertage --jahr 2027 --land HE --format csv > feiertage.csv

Ein kostenloser Schlüssel mit 500 Abfragen im Monat liegt unter quellenkontor.dev/anmelden bereit. Kein Passwort, keine Kreditkarte. Die Schritte bis zur ersten Abfrage stehen im Schnellstart.

Kontakt

Fehler und Wünsche gern als Issue oder an hello@quellenkontor.dev.

Die Clients in diesem Repository stehen unter MIT-Lizenz. Die Daten liefert die API, die Bedingungen dafür stehen in den Nutzungsbedingungen.

---

English

Official German HR reference data via API, SDK, CLI and MCP. Every value comes with its official source, legal basis and effective date.

Minimum wage, social security ceilings and rates, benefits in kind, public holidays by state, notice periods and 17 more datasets. Query with a reference date and get the value that applies on that day, including the citation in the Federal Law Gazette or Federal Gazette. Field and parameter names are German, as in the API.

• Docs: quellenkontor.dev/en/docs
• Free key (500 requests a month): quellenkontor.dev/en/sign-in
• Packages: npm install @quellenkontor/sdk, pip install quellenkontor, npm install -g @quellenkontor/cli