MCP Server

Dein KI-Client kann jetzt Kleinanzeigen durchsuchen.

Der Kleinanzeigen Agent MCP Server gibt LLM-Clients echte Werkzeuge: live suchen, Inseratdetails nachladen, Verkäufer prüfen. Eine URL, dein API-Key als Header — fertig.

MCP Server verbinden Dokumentation lesen

Ein Endpoint, zehn Tools
Gleiche Credits wie die REST-API
Funktioniert mit Claude, Codex & Co.
Live-Daten, keine Kopie

So funktioniert es

Verbunden in unter einer Minute

MCP ist ein offener Standard. Wenn dein Client Remote-Server über HTTP unterstützt, brauchst du nur URL und API-Key.

Server eintragen

Trage https://api.kleinanzeigen-agent.de/mcp in deinem MCP-Client ein und sende deinen API-Key als Authorization-Header.

Tools werden entdeckt

Dein Client liest die Tool-Liste automatisch — Suche, Inseratdetails, Verkäuferprofile, Kategorien und Standorte.

Aufgabe stellen

Du beschreibst, was du wissen willst. Das Modell entscheidet selbst, welche Tools es in welcher Reihenfolge aufruft.

Was du bekommst

Eine zweite Oberfläche für dieselbe Plattform

Der MCP Server ist keine eigene Datenwelt. Er gibt KI-Clients kontrollierten Zugriff auf die Live-Funktionen, die du schon aus der API kennst.

Echte Live-Daten

Jeder Tool-Aufruf geht live auf Kleinanzeigen — dieselben normalisierten Felder wie in der REST-API, kein veralteter Index.

Keine Überraschungen

Gleiche Credits, gleiche Rate-Limits, gleiche Fehlercodes wie die API. Was dein Client tut, siehst du im Dashboard.

Validierte Eingaben

Jedes Tool prüft seine Argumente, bevor etwas passiert. Ungültige Aufrufe kosten keine Credits, fehlgeschlagene werden erstattet.

Ein Key für alles

Dein bestehender API-Key reicht — als Authorization-Header im Client hinterlegt, jederzeit im Dashboard rotierbar.

Tools

Zehn Werkzeuge, ein Server

Dein Client entdeckt alle Tools automatisch. Jeder Aufruf kostet dieselben Credits wie der passende REST-Endpunkt — ungültige Eingaben kosten nichts.

search_kleinanzeigen

Live-Inserate suchen — Stichwort, Kategorie, Standort, Umkreis, Preis, Versand.

1 Credit

get_kleinanzeigen_ad

Details zu einem Inserat laden, optional mit Aufrufzahlen.

1 Credit

get_kleinanzeigen_ad_status

Prüfen, ob ein Inserat noch aktiv oder bereits gelöscht ist.

1 Credit

get_kleinanzeigen_seller_profile

Öffentliches Verkäuferprofil mit Name, Badges und Zählern.

1 Credit

get_kleinanzeigen_seller_ads

Weitere Inserate eines Verkäufers durchblättern.

2 Credits

list_kleinanzeigen_categories

Den kompletten Kategoriebaum laden.

1 Credit

get_kleinanzeigen_category_metadata

Felder und Metadaten einer Kategorie ansehen.

1 Credit

get_kleinanzeigen_category_search_metadata

Suchfilter und Attribute einer Kategorie laden.

1 Credit

search_kleinanzeigen_locations

Standorte nach Name, PLZ oder Koordinaten finden.

1 Credit

get_kleinanzeigen_location

Details zu einem Standort laden.

1 Credit

Aufrufzahlen über include_views kosten je einen zusätzlichen Credit. Schlägt ein Live-Abruf upstream fehl, wird der Credit automatisch zurückerstattet.

Setup

Drei Angaben, die jeder Client versteht

URL, HTTP-Transport, Authorization-Header — mehr braucht ein MCP-Client nicht. Für Claude Code und Codex gibt es fertige CLI-Befehle, für alle anderen die JSON-Config.

Dein API-Key gehört dabei in die Secret-Verwaltung deines Clients — nicht in Prompts, nicht in committete Configs. Rotieren kannst du ihn jederzeit im Dashboard.

Setup-Anleitung lesen

MCP-Configmcp.json

1{
2  "mcpServers": {
3    "kleinanzeigen-agent": {
4      "url": "https://api.kleinanzeigen-agent.de/mcp",
5      "headers": {
6        "Authorization": "Bearer klaz_live_…"
7      }
8    }
9  }
10}

Per CLIterminal

1# Claude Code
2claude mcp add --transport http kleinanzeigen-agent \
3  https://api.kleinanzeigen-agent.de/mcp \
4  --header "Authorization: Bearer $KLAZ_API_KEY"
5 
6# Codex CLI
7codex mcp add kleinanzeigen-agent \
8  --url https://api.kleinanzeigen-agent.de/mcp \
9  --bearer-token-env-var KLAZ_API_KEY

Wofür MCP sich lohnt

Überall dort, wo Recherche mehrstufig ist und ein Modell unterwegs entscheiden soll, welche Daten es als nächstes braucht.

Deal-Recherche

Der Client sucht Angebote, lädt Details der besten Treffer nach, prüft Verkäufer und liefert dir eine Shortlist mit Preisen und Links.

Marktanalyse

Mehrere Suchen über Kategorien oder Städte hinweg, daraus Preisbereiche und Auffälligkeiten — formuliert als lesbare Zusammenfassung.

Agenten & Automationen

Agenten entscheiden anhand der Zwischenergebnisse selbst, ob sie weitere Details, Kategorien oder Standorte nachladen.

Preise

Abgerechnet wird wie bei der API

Der MCP Server hat keinen eigenen Tarif. Jeder Tool-Aufruf kostet dieselben Credits wie der passende REST-Endpunkt — dein bestehender Plan und dein Guthaben gelten unverändert.

Kein eigenes MCP-Abo — du zahlst nur die Credits der Tool-Aufrufe
Free-Plan mit täglichem Gratis-Guthaben zum Ausprobieren
Credit-Packs und Volumentarife, wenn dein Client mehr abruft
Ungültige Aufrufe kosten nichts, fehlgeschlagene werden erstattet

Kostenlos starten Alle Pläne ansehen

Credits pro Tool-Aufruf

Live-Suche: 1
Inseratdetails / Inseratstatus: 1
Verkäuferprofil: 1
Verkäufer-Inserate: 2
Kategorien, Metadaten, Standorte: je 1
Aufrufzahlen (include_views): +1

Gleiche Kosten wie die REST-API — eine vollständige Übersicht steht in der Dokumentation.

Häufig gestellte Fragen

Wenn du etwas vermisst, schreib uns — wir nehmen es gerne hier mit auf.

MCP steht für Model Context Protocol — ein offener Standard, über den KI-Clients externe Werkzeuge entdecken und aufrufen können. Unser Server stellt darüber zehn Kleinanzeigen-Tools bereit: Live-Suche, Inseratdetails, Verkäuferprofile, Kategorien und Standorte. Dein Client liest die Tool-Liste automatisch, sobald er verbunden ist.

Eine URL trennt deinen Client von echten Kleinanzeigen-Daten.

Account erstellen, API-Key kopieren, Server im Client eintragen — der Free-Plan reicht zum Loslegen, ganz ohne Kreditkarte.

Dokumentation MCP Server verbinden