Entwickler

MCP-Zugang für Agenten

thgverkauf.de hat einen MCP-Endpunkt. Sprachmodelle und Agenten können damit die Fahrzeugliste, die Förderprogramme, anonyme Marktplatz-Summen und den Ablauf des THG-Verkaufs abfragen. Nur lesen. Es gibt keinen Weg, darüber einen Antrag zu stellen oder Daten zu ändern.

Endpunkt: POST https://thgverkauf.de/mcp
Protokoll: MCP 2025-06-18
Transport: Streamable HTTP, JSON-RPC 2.0
Anmeldung: keine, kein Schlüssel nötig
Grenze: 60 Aufrufe je Adresse und Minute
Sprache: Deutsch, Daten aus denselben Dateien wie die Website

Die Werkzeuge

Sieben Werkzeuge, alle lesend. Kein Aufruf schreibt in die Datenbank, kein Aufruf sieht Nutzerdaten, Anträge oder Dokumente.

Werkzeuge des Servers
Name	Was es tut	Parameter
berechtigung_pruefen	Prüft nach den Regeln der 38. BImSchV, ob für ein Fahrzeug eine THG-Quote angemeldet werden kann. Gefragt sind Antriebsart (Feld P.3), Fahrzeugklasse (Feld J) und ob die fragende Person der eingetragene Halter ist (Feld C). Speichert nichts.	antrieb elektrisch \| hybrid \| plug-in-hybrid \| verbrenner \| unbekannt Pflicht klasse M1 \| M3 \| N1 \| N2 \| N3 \| L \| keine \| unbekannt Pflicht halter ja \| nein \| unklar Pflicht
fahrzeug_suchen	Sucht in der Fahrzeugliste von thgverkauf.de nach Marke, Modell, Variante, Karosserie oder Fahrzeugklasse. Liefert Slug und Adresse der Modellseite. Nur reine Elektrofahrzeuge.	query string Pflicht limit integer optional
fahrzeug_details	Liefert alle Angaben zu einem Fahrzeug aus der Liste: Fahrzeugklasse, Akku, Reichweite, Verkaufsjahre, Hinweise, Quellen und Bildnachweis. Der Slug kommt aus fahrzeug_suchen.	slug string Pflicht
foerderungen	Listet Förderprogramme rund um Elektromobilität mit Status, Zeitraum, Zielgruppe und Prüfdatum. Ohne Filter kommt die ganze Liste, auch beendete Programme.	status aktiv \| angekuendigt \| unklar \| beendet optional zielgruppe privat \| gewerbe \| laden optional
foerderung_details	Liefert ein Förderprogramm mit Zusammenfassung, Zielgruppe, Weg zum Antrag, Betragstext, Quellen und Prüfdatum. Der Slug kommt aus foerderungen.	slug string Pflicht
marktplatz_uebersicht	Anonyme Übersicht der offenen Bedarfe auf dem Quoten-Marktplatz: Anzahl und angefragte Menge in Tonnen CO2 je Quotenjahr und Zertifikatsart. Keine Firmennamen, keine Preise, keine Kontaktdaten. Beispieleinträge werden getrennt ausgewiesen.	jahr integer optional
so_funktioniert_es	Erklärt den Ablauf auf thgverkauf.de: welche Schritte es gibt, welche Unterlagen gebraucht werden, was es kostet und wann der Auszahlungsbetrag feststeht.	keine

Die Tabelle kommt aus derselben Definition wie der Server. Was hier steht, liefert auch tools/list.

Einrichten

Beide Beispiele tragen den Server unter dem Namen thgverkauf ein. Nach dem Speichern startest du das Programm neu.

Claude Desktop

Claude Desktop startet MCP-Server als Programm auf deinem Rechner. Für einen Server im Netz brauchst du eine Brücke, üblicherweise mcp-remote. Die Datei heißt claude_desktop_config.json und liegt im Einstellungsordner von Claude.

claude_desktop_config.json

{
  "mcpServers": {
    "thgverkauf": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://thgverkauf.de/mcp"]
    }
  }
}

Cursor

Cursor spricht Streamable HTTP direkt an. Die Datei heißt mcp.json und liegt entweder im Ordner .cursor deines Projekts oder in deinem Benutzerordner.

.cursor/mcp.json

{
  "mcpServers": {
    "thgverkauf": {
      "url": "https://thgverkauf.de/mcp"
    }
  }
}

Andere Clients brauchen nur die Adresse https://thgverkauf.de/mcp als Streamable-HTTP-Server. Es gibt keine Sitzungs-ID, jeder Aufruf steht für sich.

Selbst ausprobieren

Drei Aufrufe mit curl: anmelden, Werkzeuge auflisten, ein Werkzeug rufen. Die Antwort ist immer JSON.

1. initialize

curl -s https://thgverkauf.de/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18",
                 "capabilities":{},
                 "clientInfo":{"name":"curl","version":"1"}}}'

2. tools/list

curl -s https://thgverkauf.de/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

3. tools/call

curl -s https://thgverkauf.de/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call",
       "params":{"name":"fahrzeug_suchen",
                 "arguments":{"query":"kia","limit":3}}}'

GET auf den Endpunkt beantwortet der Server mit 405 und einem kurzen Hinweis. Sammelanfragen als JSON-Array lehnt er ab, so steht es in der Spezifikation 2025-06-18.

Datenschutz und Grenzen

Der Endpunkt ist bewusst dumm gehalten. Er kennt niemanden und merkt sich nichts.

Keine Speicherung

Die Anwendung schreibt zu keinem Aufruf einen Datensatz. Keine Cookies, keine Sitzung, keine Anmeldung, kein Tracking. Für die Grenze von 60 Aufrufen je Minute zählt der Server im Arbeitsspeicher mit. Der Zähler läuft nach einer Minute ab.

Keine Nutzerdaten

Kein Werkzeug sieht Konten, Anträge, Fahrzeugscheine oder Auszahlungen. Der Marktplatz kommt nur als Summe heraus: Anzahl und Menge je Quotenjahr, ohne Firmennamen, ohne Preise, ohne Kontaktdaten.

Nur lesen

Es gibt kein Werkzeug, das etwas anlegt, ändert oder löscht. Ein Antrag entsteht ausschließlich über die Website, angemeldet und mit Fahrzeugschein.

Keine festen Beträge

Der Server kann einen Höchstwert für Pkw nennen, jeweils mit Fahrzeugklasse und Quotenjahr. Er hängt vom Marktpreis ab und ist keine Auszahlungszusage. Der genaue Betrag steht fest, sobald der Partner den Vorgang bestätigt hat.

Die Daten hinter den Werkzeugen sind dieselben wie auf der Website. Fahrzeuge und Förderprogramme tragen ihre Quellen und ihr Prüfdatum. Angaben ohne Gewähr. Fragen dazu gehen an info@thgverkauf.de.

Lieber selbst nachsehen?

Alles, was der Server liefert, steht auch als Seite da: die Modelle mit Fahrzeugklasse und Quelle, die Förderprogramme mit Prüfdatum und der Ablauf Schritt für Schritt.

Alle Modelle Förderprogramme So läuft es