Agenten-API-Referenz · REST + MCP
Eine Verbindung. Dein Workspace und die Listen, die du freigibst.
REST und MCP mit denselben Aktionen. GET /a liefert jede Aktion mit ihrem Preis, die kostenlosen Limits und die Regeln. So weiß ein Agent vor dem Start, was er darf und was es kostet.
Selbstbeschreibend
GET /a für die Anleitung; describe_list für Spalten, Status und Rechte einer freigegebenen Liste.
MCP & REST
Claude, ChatGPT oder jeder MCP-Client auf /mcp, jeder HTTP-Client auf /a/v1/{action}.
Rechte
Listen pro Verbindung freigegeben als „Lesen + Prüfen“, „Bearbeiten“ oder „Alles“, dazu ein Credit-Budget pro Tag.
Vier Aufrufe.
Erstelle einen Schlüssel auf der Seite „Eigene KI“ oder lass Claude, ChatGPT oder Claude Code sich anmelden. Den Rest erklärt die Anleitung deinem Agenten.
# 1. Read the guide: every action, its price and the rules
curl https://listplus.ai/a
# 2. Check records for errors (free, nothing is stored)
curl -X POST https://listplus.ai/a/v1/check_records \
-H "Authorization: Bearer lpk_…" \
-H "Content-Type: application/json" \
-d '{ "records": [ { "first_name": "MAYA", "last_name": "Chen",
"email": "maya.chen@gmial.com", "company_name": "Northstar Labs" } ] }'
# 3. Price the missing job titles before anything runs
curl -X POST https://listplus.ai/a/v1/enrich_records \
-H "Authorization: Bearer lpk_…" \
-H "Content-Type: application/json" \
-d '{ "records": [ { "first_name": "Maya", "last_name": "Chen",
"company_name": "Northstar Labs" } ],
"fields": ["job_title"], "estimate": true }'
# 4. Add a record to a list you shared with this connection
curl -X POST https://listplus.ai/a/v1/add_records \
-H "Authorization: Bearer lpk_…" \
-H "Content-Type: application/json" \
-d '{ "list_id": "ws_…", "records": [ { "first_name": "Maya",
"last_name": "Chen", "company_name": "Northstar Labs" } ] }'Jeder Aufruf wird auf der Seite „Eigene KI“ mit Aktion und Credits protokolliert.
Was die Verbindung bietet.
Workspace-Aktionen funktionieren ohne Liste. Listen-Werkzeuge arbeiten auf den Listen, die du freigibst, so weit deren Zugriff reicht.
| Gruppe | Aktionen | Hinweise |
|---|---|---|
| Finden | find_person, search_options, count_companies, search_people, load_companies | find_person und Zählungen sind kostenlos; eine Suche legt eine neue Liste an |
| Prüfen | check_records, verify_email | 100+ Checks auf den gesendeten Datensätzen, nichts wird gespeichert |
| Anreichern | enrich_records, get_job | Geschäftliche E-Mail, Mobilnummer, Jobtitel, LinkedIn, Firmendaten; Credits pro Treffer |
| Listen · Lesen + Prüfen | describe_list, query_records, check_list | 34 Filterbedingungen, z. B. c_level_executive, disposable_email, fuzzy_match |
| Listen · Bearbeiten | add_records, update_records, mark_records, fix_list, copy_records | add_records bis 1.000 pro Aufruf; update_records unterstützt only_empty |
| Listen · Alles | enrich_records mit list_id, derive_column, send_to_pipeline | derive_column füllt eine Spalte per KI, nach Verbrauch |
Die Verbindung entscheidet, nicht der Prompt.
Jede Liste wird pro Verbindung als „Lesen + Prüfen“, „Bearbeiten“ oder „Alles“ freigegeben. Über einen Agenten werden nie Datensätze gelöscht: Ausblenden ist das Äußerste — ein ausgeblendeter Datensatz fällt aus dem normalen Ablauf (keine Checks, Regeln, Anreicherung oder Sync), bis er wieder eingeblendet wird, und das lässt sich rückgängig machen.
- Ausgeblendete Spalten, Teillisten
- Was der Agent auf einer Liste lesen darf. Ausgeblendete Spalten verlassen ListPlus nie.
- Beschreibbare Spalten, nur leere füllen
- Was der Agent ändern darf, und ob gefüllte Werte geschützt sind.
- Tagesbudget, Ablaufdatum
- Credits, die die Verbindung pro Tag ausgeben darf, und ein optionales Ablaufdatum. Ein Widerruf stoppt ihre laufenden Aufträge.
Was ein Aufruf kostet.
1 Credit ist €0,03 mit Pro, €0,05 mit Basic. Lesen, Checks und Korrekturen sind kostenlos.
| Vorgang | Credits |
|---|---|
| find_person, check_records, count_companies, search_options | kostenlos |
| describe_list, query_records, check_list, fix_list und die anderen Listen-Werkzeuge | kostenlos |
| search_people (pro Seite mit bis zu 25 Personen) | 2 |
| load_companies (pro Firma) | 0,25 |
| verify_email (pro Adresse) | 0,3 |
| enrich_records | pro gefundenem Feld, vorher estimate: true |
| derive_column | KI nach Verbrauch |
Der Agenten-API-Zugang ist in jedem Plan enthalten — auch im kostenlosen.
Gut zu wissen.
Brauche ich ein SDK?
Nein. Die API ist reines HTTP mit JSON. curl, Python, JavaScript oder jeder MCP-Client funktionieren. GET /a dokumentiert jede Aktion.
Wie funktioniert die Authentifizierung?
Claude, ChatGPT und Claude Code melden sich mit deinem ListPlus-Konto an. Andere Clients senden einen Schlüssel als Authorization: Bearer lpk_…. Eigentümer oder Admins eines Workspaces verbinden eine KI auf der Seite „Eigene KI“, setzen ihr Tagesbudget und ein Ablaufdatum und widerrufen sie, wenn die Aufgabe erledigt ist.
Kann ich vorher sehen, was ein Auftrag kostet?
Ja. enrich_records, search_people und load_companies nehmen estimate: true und nennen den Preis, ohne zu laufen. only_empty schützt gefüllte Felder, wenn dein Agent eine Liste ändert.
Welcher Plan enthält die API?
Jeder Plan, auch Basic. Suchen, Anreicherung und Verifizierung folgen ihren Credit-Regeln; Lesen, Checks und Korrekturen sind kostenlos.
Egal womit du startest. Du weißt, was bereit ist.
Probiere die Beispielliste oder bring deinen eigenen Startpunkt mit.