smart_toy Model Context Protocol (MCP) Server
check_circleAktiv & EinsatzbereitVerbinde Claude Desktop, Cursor, Windsurf, Antigravity oder autonome Agenten direkt mit der deterministischen Berechnungs-Engine des ÖD-Infoportals.
Warum MCP für Besoldung & Tarife? Große Sprachmodelle (LLMs) scheitern bei deutschen Besoldungstabellen, Familienzuschlägen (Bayern Ortsklassen, NRW Mietenstufen) und Lohnsteuerberechnungen an Rechenfehlern und Halluzinationen. Durch den MCP-Server fragt die KI die Parameter strukturiert über unsere API ab und liefert 100 % verlässliche, centgenaue Antworten direkt im Chat.
buildEnthaltene KI-Werkzeuge (MCP Tools)
Der Server stellt deiner KI 4 standardisierte Werkzeuge nach dem Model Context Protocol bereit:
get_public_sector_options
Liefert eine vollständige Übersicht aller 17 Dienstherren (Bund & 16 Bundesländer) und Tarifverträge (TVöD, TV-L etc.) inklusive Besoldungsgruppen.
get_salary_and_zulagen_options
Discovery-Modus: Ermittelt alle Stufen mit Grundgehalt, alle wählbaren Stellenzulagen (Polizei, Justiz etc.) und Familienzuschlagsregeln für eine Gruppe.
calculate_agent_salary
Vollständige ÖD-Berechnung & BMF-PAP: Berechnet exaktes Brutto, Netto und jährliche Sonderzahlung inklusive ausgewählter Zulagen-IDs und Familienzuschlag. Die steuerliche und sozialversicherungsrechtliche Netto-Berechnung erfolgt strikt nach dem offiziellen BMF-Programmablaufplan (PAP).
calculate_standard_salary
Direktberechnung & Universeller Brutto-Netto-Rechner: Schnelle Gehaltsauskunft aus Kerndaten (Gruppe, Stufe) sowie freie Bruttobeträge (employment_type='sonstige' mit brutto_gehalt). Berechnet Lohnsteuer, Soli, KiSt und alle Sozialabgaben exakt nach dem aktuellen Programmablaufplan (PAP) des Bundesfinanzministeriums (BMF).
settingsEinrichtung & Konfiguration
Wähle deine Umgebung für die 1-Click-Einrichtung:
Unser Server bietet einen vollumfänglichen, hochverfügbaren Remote-MCP-Endpunkt via Server-Sent Events (SSE) nach dem offiziellen MCP-Standard 2024-11-05.
Offizielle Remote MCP Server URL:
https://infos-oeffentlicher-dienst.de/mcp/sse
1. Standard-Konfiguration (Ohne API-Key – Sofort startklar):
{
"mcpServers": {
"brutto-netto-gehaltsrechner": {
"type": "sse",
"url": "https://infos-oeffentlicher-dienst.de/mcp/sse"
}
}
}
💡 Sofort startklar: Kein API-Key für den Einstieg nötig! Du kannst die URL direkt so in deine Konfiguration kopieren.
Hänge einfach ?apiKey=DEIN_API_KEY an die URL an (funktioniert universell in allen Clients):
{
"mcpServers": {
"brutto-netto-gehaltsrechner": {
"type": "sse",
"url": "https://infos-oeffentlicher-dienst.de/mcp/sse?apiKey=DEIN_API_KEY"
}
}
}
Alternativ für Clients mit Header-Support (z. B. Cursor, Windsurf): "headers": { "Authorization": "Bearer DEIN_API_KEY" }
Bei der Registrierung auf Smithery.ai gibst du folgende Daten ein:
npx @smithery/cli install kio-dunker/brutto-netto-gehaltsrechner --client claude
Smithery: smithery.ai/server/kio-dunker/brutto-netto-gehaltsrechner
Glama: glama.ai/mcp/servers/brutto-netto-und-gehaltsrechner
Open-Source GitHub: dunkio/oed-gehaltsrechner-mcp
Empfohlen (Remote SSE): Funktioniert sofort ohne lokale Python-Installation in deiner claude_desktop_config.json:
• Windows: %APPDATA%\Claude\claude_desktop_config.json |
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"brutto-netto-gehaltsrechner": {
"type": "sse",
"url": "https://infos-oeffentlicher-dienst.de/mcp/sse"
}
}
}
💡 Sofort startklar: Kein API-Key erforderlich (30 kostenlose Berechnungen/Monat standardmäßig aktiv).
Alternativ: Lokaler Stdio-Modus (Python server.py)
{
"mcpServers": {
"brutto-netto-gehaltsrechner": {
"command": "python",
"args": ["/Pfad/zu/server.py"]
}
}
}
Erstelle in deinem Projektordner die Datei .cursor/mcp.json (unterstützt direkt Remote SSE):
{
"mcpServers": {
"brutto-netto-gehaltsrechner": {
"type": "sse",
"url": "https://infos-oeffentlicher-dienst.de/mcp/sse"
}
}
}
💡 Sofort startklar: Kein API-Key erforderlich (30 kostenlose Berechnungen/Monat standardmäßig aktiv).
Alternativ: Lokaler Stdio-Modus (Python server.py)
{
"mcpServers": {
"brutto-netto-gehaltsrechner": {
"command": "python",
"args": ["mcp/server.py"]
}
}
}
Konfiguration in deiner Kilo Code MCP-Einstellung (z. B. in kilo.jsonc):
{
"mcpServers": {
"brutto-netto-gehaltsrechner": {
"type": "sse",
"url": "https://infos-oeffentlicher-dienst.de/mcp/sse"
}
}
}
💡 Sofort startklar: Kein API-Key erforderlich (30 kostenlose Berechnungen/Monat standardmäßig aktiv).
{
"mcpServers": {
"brutto-netto-gehaltsrechner": {
"type": "sse",
"url": "https://infos-oeffentlicher-dienst.de/mcp/sse?apiKey=DEIN_API_KEY"
}
}
}
Trage diesen Block in deine globale Antigravity-Konfigurationsdatei ein:
• Windows: C:\Users\<DeinName>\.gemini\config\mcp_config.json |
• macOS/Linux: ~/.gemini/config/mcp_config.json
{
"mcpServers": {
"brutto-netto-gehaltsrechner": {
"command": "python",
"args": ["c:/Pfad/zu/oed-gehaltsrechner-mcp/server.py"],
"env": {
"PYTHONIOENCODING": "utf-8"
}
}
}
}
💡 Sofort startklar: Kein API-Key für den Einstieg nötig! Optional kann für höhere Limits "OED_INFOPORTAL_API_KEY": "sk_live_..." in env ergänzt werden.
Der Stdio-Server benötigt keine externen pip-Pakete (nur Python 3.9+ Standardbibliothek).
# Lokaler Test des JSON-RPC Servers: python server.py
chatBeispiel-Prompts für Claude & Cursor
Sobald der MCP-Server eingebunden ist, kannst du deiner KI ganz natürliche Fragen stellen: