Für Entwickler

MCP-Server: die Förderdatenbank für deinen Agenten

Antragio hat eine offene Schnittstelle nach dem Model Context Protocol. Damit kann jeder KI-Agent die Förderdatenbank direkt abfragen, ohne Schlüssel, ohne Anmeldung, ohne Umweg über die Website.

Diese Seite beschreibt den MCP-Server im Detail. Alle Zugänge nebeneinander, also MCP, REST-API und die Markdown-Fassung jeder Seite, stehen auf Antragio für KI-Agenten.

JSON-RPC 2.0HTTP POSTProtokoll 2025-06-18Nur lesend

Endpunkt

Ein einziger Endpunkt, der JSON-RPC 2.0 über POST spricht. Unterstützt werden die Methodeninitialize,tools/list,tools/call,ping und die Notificationnotifications/initialized.

Endpunkt-URL

https://antragio.com/api/mcp

Servername: antragio
Version: 1.0.0
Beschreibungsdatei: /.well-known/mcp.json

Spielregeln

Ohne Schlüssel

Kein Konto, kein Token, keine Registrierung. Endpunkt eintragen und loslegen.

Nur lesend

Es gibt kein Werkzeug, das etwas anlegt oder ändert. Nichts an deinem Konto lässt sich von außen anfassen.

Keine Personendaten

Der Server sieht nur die Programmdatenbank und das Lexikon. Checks, Profile und Bestellungen sind nicht erreichbar.

Fair begrenzt

120 Aufrufe je 5 Minuten pro IP. Darüber antwortet der Server mit einem JSON-RPC-Fehler.

Die Daten stammen aus öffentlichen Förderrichtlinien und werden redaktionell gepflegt. Beträge, Fördersätze und Fristen ändern sich. Gib deinen Nutzern deshalb immer die verlinkte Originalquelle mit und stelle die Antwort nicht als Rechts-, Steuer- oder Förderberatung dar.

Werkzeuge

Sechs Werkzeuge, alle lesend. Jede Antwort kommt als lesbarer JSON-Block im Feldcontent und zusätzlich als Rohdaten im FeldstructuredContent.

search_programs

Förderprogramme suchen

Durchsucht die Förderdatenbank von Antragio nach Programmen von Bund, Land, EU und Kommunen. Volltextsuche über Name, Fördergeber und Kurzbeschreibung, dazu Filter nach Kategorie, Ebene, Bundesland, Zielgruppe und Förderart. Liefert je Treffer die öffentliche URL auf antragio.com.

Parameter	Typ	Bedeutung
query	Text	Suchbegriff, zum Beispiel Wärmepumpe oder Gründungszuschuss.
kategorie	Text oder Liste aus Text	Eine Kategorie oder eine Liste von Kategorien.
ebene	Text oder Liste aus Text	Förderebene: bund, land, eu, kommune oder sonstige.
bundesland	Text	Zwei Buchstaben Landescode, zum Beispiel BY. Liefert Landesprogramme dieses Landes plus bundesweite Programme.
zielgruppe	Text oder Liste aus Text	Zielgruppe des Programms, zum Beispiel privat oder unternehmen.
art	Text oder Liste aus Text	Art der Förderung, zum Beispiel zuschuss oder kredit.
limit	ZahlVorgabe 20	Maximale Trefferzahl.

get_program

Programm im Detail

Liefert den vollständigen Datensatz zu einem Förderprogramm inklusive Voraussetzungen, Frist, Kombinierbarkeit, Quelle und Stand der letzten Prüfung. Der Slug stammt aus search_programs oder aus der URL.

Parameter	Typ	Bedeutung
slug*	Text	Eindeutiger Slug des Programms, durchgehend ASCII und klein geschrieben, Umlaute sind gefaltet (ae, oe, ue). Zum Beispiel aufbauprogramm-waermepumpe-baw-bafa. Slugs kommen aus search_programs oder aus der URL auf antragio.com.

Mit Stern markierte Parameter sind Pflicht.

match_programs

Passende Programme finden

Bewertet die gesamte Datenbank gegen eine konkrete Situation und gibt die besten Treffer mit Score, Begründungen, Warnungen und Checkliste zurück. Unbekannte Felder in answers werden ignoriert. Der Score ist eine Einschaetzung, keine Zusage.

Parameter	Typ	Bedeutung
answers*	Objekt	Angaben zur Situation im Format Answers. Alle Felder sind optional, unbekannte werden ignoriert. Die Werte sind exakt so zu übergeben, wie sie hier stehen: durchgehend ASCII, also ue statt ü, oe statt ö, ae statt ä. Felder: persona (privat, unternehmen, selbstaendig, gruender, verein, landwirt, kommune, student); bundesland (Landescode nach ISO, z. B. BY, NW); vorhaben (Liste aus sanierung, heizung, daemmung, fenster_tueren, photovoltaik, mobilitaet, thg, neubau, gruendung, digitalisierung, forschung, personal, bildung, familie, natur, landwirtschaft, ehrenamt, kultur, sport, sozialleistung, wohnen, gesundheit, migration, export); eigentum (eigentuemer, kaufabsicht, mieter); gebaeudeBaujahr (vor1979, 1979_2001, nach2002, neubau); selbstbewohnt (true oder false); heizungAlt (oel, gas, nachtspeicher, holz, waermepumpe, fernwaerme, keine); pvArt (dach, balkon, freiflaeche, unklar); speicher (true oder false); fahrzeugTyp (auto, motorrad, roller, lastenrad, transporter, keins); antrieb (elektro, hybrid, verbrenner); thgGenutzt (true oder false); wallbox (true oder false); gruendungsStatus (idee, in_gruendung, gegruendet, etabliert); ausArbeitslosigkeit (true oder false); hochschulbezug (true oder false); mitarbeiter (0, 1_9, 10_49, 50_249, 250plus); vereinStatus (eingetragen_gemeinnuetzig, eingetragen, in_gruendung); vereinBereich (Liste aus sport, kultur, soziales, natur, jugend, feuerwehr); oekopunkte (true oder false); lebenslage (Liste aus arbeitslos, wenig_einkommen, rente, krankheit, alleinerziehend, schwangerschaft, behinderung, pflege, schulden, keine); einkommen (unter20k, 20_40k, 40_60k, 60_80k, ueber80k, keine_angabe); haushalt (1, 2, 3, 4, 5plus); kinder (0, 1, 2, 3plus); pflegeRolle (selbst, angehoerige, beides); pflegegrad (keiner, beantragt, 1, 2, 3, 4, 5); wohnsituation (miete_zu_teuer, wohnungssuche, kuendigung, umzug, erstausstattung); aufenthalt (asyl, aufenthaltserlaubnis, eu_buerger, spaetaussiedler, deutsch); abschlussAnerkennung (true oder false); sportVorhaben (Liste aus sportstaette, ausruestung, uebungsleiter, verein_gruenden, veranstaltung, inklusion); exportZiel (eu, ausserhalb_eu, beides, noch_offen); budget (unter5k, 5_20k, 20_100k, 100k_500k, ueber500k, unklar); zeithorizont (sofort, 3_monate, 12_monate, spaeter); freitext (freier Text).
limit	ZahlVorgabe 10	Maximale Trefferzahl.

Mit Stern markierte Parameter sind Pflicht.

list_categories

Kategorien auflisten

Listet alle Förderkategorien mit deutschem Label und der Anzahl der hinterlegten Programme. Gut geeignet, um vor einer Suche den richtigen Wert für den Parameter kategorie zu finden.

Keine Parameter.

list_regions

Bundesländer auflisten

Listet die 16 Bundesländer mit Landescode, Name und der Anzahl der Landesprogramme, dazu die Anzahl der bundesweit geltenden Programme.

Keine Parameter.

explain_term

Förderbegriff erklären

Schlaegt einen Begriff im Förderlexikon nach und gibt Kurzdefinition, ausführliche Erklärung, verwandte Begriffe und die amtlichen Quellen zurück. Das Lexikon erklaert die Mechanik und enthält bewusst keine Beträge, Saetze oder Fristen.

Parameter	Typ	Bedeutung
term*	Text	Begriff oder Slug, zum Beispiel Tilgungszuschuss oder de-minimis.

Mit Stern markierte Parameter sind Pflicht.

Einrichten

Claude Desktop

Trag den Block in deine Datei claude_desktop_config.json ein und starte Claude Desktop neu.

claude_desktop_config.json

{
  "mcpServers": {
    "antragio": {
      "type": "http",
      "url": "https://antragio.com/api/mcp"
    }
  }
}

Ältere Versionen ohne eingebauten HTTP-Transport verbinden sich über die Brücke mcp-remote:

Variante mit mcp-remote

{
  "mcpServers": {
    "antragio": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://antragio.com/api/mcp"]
    }
  }
}

Claude Code, Kommandozeile

Ein Befehl im Projektordner, danach steht der Server allen Sitzungen zur Verfügung.

Terminal

claude mcp add --transport http antragio https://antragio.com/api/mcp

Kommandozeile, für Clients ohne HTTP

Spricht dein Client nur stdio, liegt dazwischen ein schmales Kommandozeilenwerkzeug. Es reicht die Aufrufe an denselben Endpunkt weiter, speichert nichts und braucht keinen Schlüssel.

Terminal

npx -y @antragio/cli mcp

Direkt mit curl

Zum Ausprobieren ohne Client. Erst die Werkzeugliste, dann ein echter Aufruf.

Werkzeuge auflisten

curl -sS -X POST https://antragio.com/api/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Programme suchen

curl -sS -X POST https://antragio.com/api/mcp \
  -H 'content-type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "search_programs",
      "arguments": { "query": "Wärmepumpe", "bundesland": "BY", "limit": 3 }
    }
  }'

Fehlercodes

Code	Bedeutung
-32700	Der Body war kein gültiges JSON.
-32600	Die Nachricht ist keine gültige JSON-RPC-Anfrage.
-32601	Diese Methode kennt der Server nicht.
-32602	Parameter fehlen oder haben einen unerlaubten Wert.
-32603	Interner Fehler.
-32000	Ratenbegrenzung erreicht, zusätzlich HTTP 429.

Fehler innerhalb eines Werkzeugs, etwa wenn die Datenbank gerade nicht erreichbar ist, kommen nicht als JSON-RPC-Fehler zurück, sondern als Werkzeugergebnis mit dem FeldisError und einer verständlichen Meldung.

Ich bin langsam, aber gründlich. Wenn dein Agent die Daten weitergibt, gib bitte immer die Quelle mit dazu und schreib dran, dass die Zahlen beim Fördergeber gegengeprüft gehören.

Alle Zugänge im Überblick Programme im Browser Förder-Check starten Förderlexikon