DESign inStart for free
Use case · For AI agents and HR chatbots

Answer statutory notice periods in an HR chatbot, with legal basis

The agent calls the calculator and gives the notice period, end date and legal basis.

An HR chatbot should not work out notice periods by itself. With the MCP server, it calls hr_kuendigungsfrist and answers, for example: joined on March 1, 2017, notice received on November 10, 2026, so employment ends on February 28, 2027 (§ 622 Abs. 2 Satz 1 Nr. 3 BGB). The field frist names the applicable period: 3 Monate zum Ende eines Kalendermonats.

1

Add the Quellenkontor MCP server to your agent.

2

The agent recognizes the question and calls hr_kuendigungsfrist with the start date and the date the notice was received.

3

The response contains the notice period, end date and section of law. The agent quotes the sentence from the field zitat.

Why the agent should not do the math

The notice period under § 622 of the German Civil Code (BGB) depends on length of service when the notice is received, and it ends on the 15th or at the end of a month. Language models miscount easily here, for example in months with 30 days or when the period starts on the day after receipt (§ 187 BGB).

The calculator applies the rule schematically and returns the legal basis along with the period and end date. The agent only has to understand the question and pass the two dates. The detailed rules are on the notice period calculator page.

What to put in the agent's instructions

  • Never calculate notice periods yourself, always call the tool.
  • If the start date or the date of receipt is missing, ask instead of guessing.
  • In the answer, give the notice period, end date and legal basis, and point out that the contract or a collective agreement (Tarifvertrag) can provide for longer periods.

The calculator returns the statutory notice period. It does not check contractual or collectively agreed periods, special protection against dismissal (Sonderkündigungsschutz) or whether the dismissal is valid.

What the call looks like

Example with the dataset Notice period calculator. The response comes from the same code as the API.

api.quellenkontor.dev/v1/hr/kuendigungsfrist?eintritt=2017-03-01&zugang=2026-11-10
Zur API-Doku →
curl "https://api.quellenkontor.dev/v1/hr/kuendigungsfrist?eintritt=2017-03-01&zugang=2026-11-10" \
  -H "Authorization: Bearer $QK_KEY"
Antwort200 OK · JSON
{
  "datensatz": "kuendigungsfrist",
  "eintritt": "2017-03-01",
  "zugang": "2026-11-10",
  "seite": "arbeitgeber",
  "probezeit": false,
  "betriebszugehoerigkeit_jahre": 9,
  "frist": "3 Monate zum Ende eines Kalendermonats",
  "frist_code": "monate_3_zum_monatsende",
  "fristende": "2027-02-10",
  "ende": "2027-02-28",
  "rechtsgrundlage": "§ 622 Abs. 2 Satz 1 Nr. 3 BGB",
  "hinweise": [
    "Schematische Berechnung der gesetzlichen Frist. Abweichende Fristen aus einem Tarifvertrag, auch kürzere (§ 622 Abs. 4 BGB), und längere Fristen aus dem Arbeitsvertrag sind nicht berücksichtigt.",
    "Besteht ein Betriebsrat, ist er vor jeder Kündigung anzuhören, sonst ist sie unwirksam (§ 102 Abs. 1 BetrVG). Bei einer ordentlichen Kündigung hat er eine Woche Zeit; das bei der Planung des Zugangs einrechnen.",
    "Maßgeblich ist der Tag, an dem die Kündigung zugeht. Die Kündigung braucht die Schriftform (§ 623 BGB)."
  ],
  "quelle": {
    "titel": "§ 622 BGB (Kündigungsfristen bei Arbeitsverhältnissen)",
    "url": "https://www.gesetze-im-internet.de/bgb/__622.html"
  },
  "quellen": [
    {
      "titel": "§ 622 BGB (Kündigungsfristen bei Arbeitsverhältnissen)",
      "url": "https://www.gesetze-im-internet.de/bgb/__622.html"
    },
    {
      "titel": "§ 187 BGB (Fristbeginn)",
      "url": "https://www.gesetze-im-internet.de/bgb/__187.html"
    },
    {
      "titel": "§ 188 BGB (Fristende)",
      "url": "https://www.gesetze-im-internet.de/bgb/__188.html"
    }
  ],
  "stand": "2026-09-23",
  "lizenz": "Berechnung nach den genannten Normen. Nutzung nach den Nutzungsbedingungen von Quellenkontor.",
  "zitat": "Gesetzliche Kündigungsfrist bei Eintritt am 01.03.2017 und Zugang der Kündigung am 10.11.2026, Kündigung durch den Arbeitgeber: 3 Monate zum Ende eines Kalendermonats, das Arbeitsverhältnis endet am 28.02.2027. Schematische Berechnung ohne vertragliche oder tarifliche Fristen. Rechtsgrundlage: § 622 Abs. 2 Satz 1 Nr. 3 BGB. Quelle: § 622 BGB (Kündigungsfristen bei Arbeitsverhältnissen), https://www.gesetze-im-internet.de/bgb/__622.html. Daten: Quellenkontor (quellenkontor.dev).",
  "datenstand": "2026-09-23.1"
}

Frequently asked questions

Which notice periods does the calculator know?

The basic period, the extended periods for dismissal by the employer and the period during probation (Probezeit) under § 622 BGB.

What happens if the agent passes a wrong date?

The server rejects the call with a message about the affected parameter, and the agent can correct it. Such calls do not count against your quota.

How do I set up the MCP server?

In Claude Code with one command, in Cursor and VS Code with a configuration file. The instructions are in the MCP server docs.

Datasets used

Notice period calculator

Statutory notice period and end date under § 622 BGB from start date and date of receipt.

APIMCPwhen the law changes

Related use cases

Enter maternity protection periods in HR software automatically

The expected due date gives you the start and end of the maternity protection period (Mutterschutzfrist) in your system.

Account for public holidays by location in shift planning

Public holidays for each location in the plan automatically, regional holidays included.