RegTracer

Für Entwickler und ihre KI-Agenten

RegTracer prüft Sachverhalte der Energiewirtschaft gegen ein geprüftes, maschinenlesbares Regelwerk des deutschen Energierechts. Sie schicken die Merkmale einer Anlage oder eines Vorgangs und erhalten die anwendbaren Pflichten mit berechneten Fristen. Jede Pflicht ist mit Fundstelle und Zitat aus der Quelle belegt. Erreichbar ist RegTracer über eine REST-Schnittstelle und als MCP-Server für KI-Agenten.

Kurz für KI-Agenten: Eine kompakte Fassung dieser Seite steht unter /llms.txt, das vollständige Schema unter /openapi.json.

Auf einen Blick

REST
https://api.regtracer.energy/v1/…
MCP
https://api.regtracer.energy/mcp/ (Streamable HTTP, zustandslos)
Schema
openapi.json · interaktiv unter /docs
Anmeldung
Kopfzeile Authorization: Bearer rt_live_… (alternativ X-API-Key)
Format
JSON, Fehler als application/problem+json (RFC 9457)

API-Schlüssel beantragen

Schlüssel werden derzeit einzeln vergeben. Schreiben Sie eine E-Mail an kontakt@marts.group mit dem Betreff „Antrag API-Schlüssel RegTracer“ und diesen Angaben:

  1. Organisation und Ansprechperson
  2. Vorhaben: welche Software oder welcher Agent die Schnittstelle nutzt und wofür, z. B. Pflichten für PV-Anlagen ermitteln
  3. Zugang: REST, MCP oder beides
  4. Umfang: erwartete Aufrufe pro Tag
  5. Rechte: pruefen, regeln:lesen oder beide (siehe unten)

Wir prüfen den Antrag und melden uns. Den Schlüssel übermitteln wir auf einem gesonderten Weg. Er wird nur einmal angezeigt und nur als Hash gespeichert. Ein verlorener Schlüssel lässt sich nicht wiederherstellen, nur sperren und neu ausstellen. Bitte schicken Sie keine Testdaten mit Personenbezug mit.

Die Kontaktdaten aus Ihrem Antrag verarbeiten wir nach Abschnitt 8 der Datenschutzerklärung.

Rechte und Grenzen eines Schlüssels

pruefen
POST /v1/pruefungen, /v1/pflichten, /v1/fristen, GET /v1/merkmale
regeln:lesen
GET /v1/regeln (Übersicht), /v1/abschnitte/{id}, /v1/merkmale, /v1/abdeckung, /v1/regelwerk/releases
Minute
höchstens 120 Aufrufe je Schlüssel
Tag
je Schlüssel eine vereinbarte Obergrenze (UTC-Tag)

Jede Antwort trägt X-RateLimit-Limit und X-RateLimit-Remaining. Ist eine Grenze erreicht, folgt 429 mit Retry-After in Sekunden. Warten Sie dann mindestens so lange und versuchen Sie es nicht sofort erneut. Jede Antwort enthält außerdem eine X-Request-ID; geben Sie sie bei Rückfragen an.

Erste Prüfung (REST)

curl -s https://api.regtracer.energy/v1/pruefungen \
  -H "Authorization: Bearer $REGTRACER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "stichtag": "2026-10-09",
    "rolle": "anlagenbetreiber",
    "anlage": {"typ": "pv", "leistung_kw": 720,
               "netzanschluss": true, "foerderregime": "eeg"},
    "ereignisse": [{"typ": "inbetriebnahme", "datum": "2026-06-15"}]
  }'

Die Antwort enthält diese Felder (gekürzt):

{
  "pruefung_id": "prf_…",
  "regelwerk": "2026.10.8",
  "stichtag": "2026-10-09",
  "verdikt": "pflichten_gefunden",
  "pflichten": [{
    "regel": "DE.…", "titel": "…", "art": "…", "adressat": "…",
    "frist": {"beschreibung": "…", "status": "…", "faellig_am": "…"},
    "belege": [{"quelle": "…", "bezeichner": "…",
                "fundstelle": "…", "zitat": "…"}],
    "begruendung": ["…"]
  }],
  "unbestimmt_anzahl": 4,
  "offene_punkte": [{"merkmal": "…", "grund": "von 3 Regel(n) benötigt"}],
  "hinweis": "…"
}
verdikt
pflichten_gefunden, unvollstaendig (es fehlen Merkmale) oder keine_pflichten
unbestimmt_anzahl
Zahl der Regeln, die mit den gelieferten Merkmalen noch nicht entschieden werden können.
offene_punkte
Merkmale, die für weitere Regeln fehlen. Fragen Sie sie beim Nutzer nach und prüfen Sie erneut, statt zu raten.
regelwerk
Die Version des Regelwerks, gegen die geprüft wurde. Mit ?regelwerk=2026.10.8 prüfen Sie reproduzierbar gegen eine feste Version; die Liste liefert GET /v1/regelwerk/releases.

Endpunkte

POST /v1/pruefungen
Sachverhalt prüfen; die Prüfung wird protokolliert (Nachweis).
POST /v1/pflichten
Dasselbe ohne Protokoll, z. B. für Vorschauen.
POST /v1/fristen
Frist einer einzelnen Regel zu einem Ereignisdatum berechnen.
GET /v1/merkmale
Katalog der Merkmale und erlaubten Werte. Fragen Sie ihn zuerst ab, bevor Sie eine Nachricht bauen.
GET /v1/regeln
Übersicht über das Regelwerk: Version und Zahl der bestätigten Regeln je Domäne.
GET /v1/abschnitte/{id}
Beleg im Wortlaut der Quelle.
GET /v1/abdeckung
Was RegTracer abdeckt, je Thema der regulatorischen Landkarte. Was dort fehlt, prüft RegTracer nicht.
GET /v1/regelwerk/releases
Veröffentlichte Versionen des Regelwerks.

Das Regelwerk selbst ist nicht abrufbar, weder einzeln noch als Ganzes. RegTracer liefert Pflichten immer für einen konkreten Sachverhalt, jeweils mit ihren Belegen.

Als MCP-Server für KI-Agenten

Der MCP-Server bietet dieselben Prüfungen als Werkzeuge an: nachricht_pruefen, frist_berechnen, regelwerk_uebersicht, beleg_zitieren, merkmale_auflisten und abdeckung. Es gelten dieselben Rechte und Grenzen wie bei REST.

Claude Code:

claude mcp add --transport http regtracer https://api.regtracer.energy/mcp/ \
  --header "Authorization: Bearer $REGTRACER_API_KEY"

Andere Clients, die entfernte MCP-Server per Konfigurationsdatei einbinden:

{
  "mcpServers": {
    "regtracer": {
      "type": "http",
      "url": "https://api.regtracer.energy/mcp/",
      "headers": { "Authorization": "Bearer ${REGTRACER_API_KEY}" }
    }
  }
}

Hinweise für Agenten und ihre Entwickler

Fehler

401
Schlüssel fehlt, ist ungültig, widerrufen oder abgelaufen.
403
Dem Schlüssel fehlt das nötige Recht (pruefen bzw. regeln:lesen).
404
Regel, Abschnitt oder Regelwerk-Version unbekannt.
413
Anfrage zu groß.
422
Nachricht ungültig; Details stehen in fehler (je Merkmal mit Grund).
429
Grenze erreicht; Retry-After beachten.

Rechtlicher Hinweis

RegTracer ist ein technisches Hilfsmittel und keine Rechtsberatung. Maßgeblich ist der Wortlaut der jeweils geltenden Rechtsquelle. Die Belege in jeder Antwort sollen genau das nachprüfbar machen.

Impressum · Datenschutz · Stand: 13. Oktober 2026