API- und MCP-Dokumentation

Policy Radar bietet denselben lesenden Analysezugang auf zwei Wegen: als Remote-MCP-Server für Agenten und als HTTP-Endpunkt. Beide nutzen dasselbe Zugriffstoken. Den Überblick und die Konfiguration zum Kopieren finden Sie unter Für Agenten und Automatisierung.

Zugang

Der Zugang wird pro Nutzer freigeschaltet. Ohne Freischaltung antwortet der Server mit 403. Zugang anfragen.

MCP-Server

URL: https://app.policy-radar.tech/mcp
Transport: streamable-http (kein lokaler stdio-Server)
Protokoll: JSON-RPC 2.0; server/discover, tools/list und tools/call

Anmeldung

Der Client meldet sich per OAuth 2.0 Authorization Code mit PKCE (S256) an und fordert genau den Scope mcp:analyze an. Die Endpunkte findet er über die Metadaten unter https://app.policy-radar.tech/.well-known/oauth-authorization-server und https://app.policy-radar.tech/.well-known/oauth-protected-resource; eine Anfrage ohne Token beantwortet der Server mit 401 und einem Verweis darauf. Der Nutzer bestätigt im Browser, welchem Client er Zugriff gibt. Zugriffstoken sind kurzlebig, ein Refresh-Token erneuert sie. Speichern oder protokollieren Sie Token nicht länger als nötig.

Werkzeuge

Werkzeug	Zweck
`analyze_changes`	Änderungen nach Themen-ID oder Stichwort, optional mit Zeitraum
`list_taxonomy`	Themen, Sektoren, Segmente und Organisationstypen
`find_entities`	Interessenvertreter nach Name, Vorhaben nach Titel, Nummer oder Text
`get_lobbyist`	Profil eines Interessenvertreters (Organisation, keine Personen)
`get_project`	Ein Vorhaben mit Zielen, Stichwörtern und Registerlink
`search_lobbyists`	Interessenvertreter nach Sektor, Segment, Thema, Ausgaben u. a.
`search_projects`	Vorhaben nach Stichwort, Thema, Interessenvertreter u. a.
`search_statements`	Stellungnahmen passender Vorhaben, neueste zuerst
`search_contracts`	Von Interessenvertretern angegebene Verträge
`analyze_connections`	Kürzeste Beziehungspfade zwischen zwei Interessenvertretern
`analyze_network`	Netzwerk passender Interessenvertreter und ihrer Nachbarn
`project_timeline`	Änderungen an Vorhaben über Registerversionen hinweg
`list_reports`	Eigene und Team-Reports
`get_report`	Ein Report mit seinen Bausteinen
`get_report_component`	Daten eines Bausteins als Markdown-Tabelle

Suchwerkzeuge verlangen mindestens einen Filter und liefern bis zu 50 Zeilen pro Seite; mit offset blättern Sie weiter. Eine Analyse bricht nach 45 Sekunden mit dem Hinweis ab, die Eingabe einzugrenzen. Ein Fehler in einem Werkzeug kommt als HTTP 200 mit isError: true zurück.

HTTP-API

Dasselbe Token ruft analyze_changes auch ohne MCP auf. Der Body ist das Argumentobjekt des Werkzeugs, kein JSON-RPC-Umschlag.


curl -sS -X POST "https://app.policy-radar.tech/api/external/v1/analyze-changes" \
  -H "Authorization: Bearer <ZUGRIFFSTOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"query":"Energie","query_type":"keyword","limit":5}'

Ersetzen Sie <ZUGRIFFSTOKEN> durch das Token Ihrer Anmeldung. Die Antwort enthält items und meta. Ein fehlendes oder ungültiges Token ergibt 401, ein Nutzer ohne Freischaltung 403.

MCP-Zugang anfragen