Quellenkontor

MCP serverSecurity

Gives your agent verified answers about German employment law like minimum wage, holidays and notice periods.

Available today. Use it from your connected AI after setup.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the hr mindestlohn tool from Quellenkontor

About this server

Verified German HR data with legal source: minimum wage, social security, holidays, notice periods

Install Quellenkontor

The server’s own address, for the clients that take one directly. Or connect ahel onceand every client you use reads it from one address, with the account kept on ahel rather than in each client’s config.

  • Claude Code

    claude mcp add --transport http --scope user quellenkontor 'https://mcp.quellenkontor.dev/v1'

    Run it once in your project, then open /mcp to approve any sign-in the server asks for.

  • Claude Desktop

    https://mcp.quellenkontor.dev/v1

    Add a custom connector in Settings, paste this address, and approve the sign-in.

  • Cursor

    cursor://anysphere.cursor-deeplink/mcp/install?name=quellenkontor&config=eyJ1cmwiOiJodHRwczovL21jcC5xdWVsbGVua29udG9yLmRldi92MSJ9

    Open the link and Cursor adds the server at that address.

  • ChatGPT

    https://mcp.quellenkontor.dev/v1

    In Settings, enable Developer mode, create an MCP app, and paste this address. Your plan and workspace must allow custom apps.

  • Codex

    codex mcp add quellenkontor --url 'https://mcp.quellenkontor.dev/v1'

    Run it once, then sign in with codex mcp login quellenkontor if the server asks for an account.

From the project's README

As published by nicksadvisory/quellenkontor-sdk in README.md.

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

Du baustDas nimmt dir Quellenkontor ab
Lohn- und GehaltssoftwareRechengrößen, Beitragssätze, Sachbezugswerte und Übergangsbereich zu jedem Stichtag, auch rückwirkend. Mehr
HR-SoftwareFeiertage je Bundesland, Arbeitstage, Kündigungsfristen, Urlaubsanspruch und Mutterschutz als fertige Rechner. Mehr
HR-Chatbots und KI-AgentenEin MCP-Server, über den der Agent Werte nachschlägt, statt sie aus dem Gedächtnis zu nennen. Mehr
Payroll und Employer of RecordDeutsche Lohnwerte aus einer Quelle, statt ein Dutzend Behördenseiten zu verfolgen. Mehr

Guides

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

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

Die Datensätze

BereichDatensätze
LohnMindestlohn und Minijob-Grenze, Mindestausbildungsvergütung, Pflegemindestlohn
SozialversicherungRechengrößen, Beitragssätze, Übergangsbereich (Midijob), Minijob-Abgaben, Künstlersozialabgabe, Ausgleichsabgabe
SteuerSachbezugswerte, steuerfreie Beträge, Reisekosten im Inland, SFN-Zuschläge, Dienstwagen, Einkommensteuer-Eckwerte
Arbeitsrecht und FristenKündigungsfrist, Urlaubsanspruch, Mutterschutz, Pausenregelung, Regelaltersgrenze, Pfändungsfreigrenzen
KalenderFeiertage je Bundesland, Arbeitstage

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 haben keine Abhängigkeiten und sprechen dieselbe API.

PaketInstallationDoku
JavaScript/TypeScript SDKnpm install @quellenkontor/sdkSDK für JavaScript
Python SDKpip install quellenkontorSDK für Python
CLInpm install -g @quellenkontor/cliKommandozeile
MCP-Serverhttps://mcp.quellenkontor.dev/v1 (Einrichtung im Guide)MCP
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.

Tools it offers (24)

What this server listed when ahel dialed its public endpoint in Sep 2026, with no key and no account of yours. The names are the server’s own.

  • hr_mindestlohn
  • hr_mindestausbildungsverguetung
  • hr_pflegemindestlohn
  • hr_rechengroessen
  • hr_beitragssaetze
  • hr_sachbezugswerte
  • hr_pfaendungsfreigrenzen
  • hr_uebergangsbereich
  • hr_minijob_abgaben
  • hr_kuenstlersozialabgabe
  • hr_ausgleichsabgabe
  • hr_steuerfreie_betraege
  • hr_reisekosten_inland
  • hr_sfn_zuschlaege
  • hr_dienstwagen
  • hr_einkommensteuer_eckwerte
  • hr_kuendigungsfrist
  • hr_urlaubsanspruch
  • hr_mutterschutz
  • hr_feiertage
  • hr_arbeitstage
  • hr_regelaltersgrenze
  • hr_pausen
  • hr_verlauf

Signals

Last commit
Sep 2026
Advanced
Delivery
hr-daten MCP server → your ahel connector (mcp.ahel.ai) → your AI.
Item type
mcp-server
Key
dev-quellenkontor-hr-daten
Source
github.com/nicksadvisory/quellenkontor-sdk
Hosted endpoint
https://mcp.quellenkontor.dev/v1