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.

Schnellstart

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.

Aktionen

Was die Verbindung bietet.

Workspace-Aktionen funktionieren ohne Liste. Listen-Werkzeuge arbeiten auf den Listen, die du freigibst, so weit deren Zugriff reicht.

GruppeAktionenHinweise
Findenfind_person, search_options, count_companies, search_people, load_companiesfind_person und Zählungen sind kostenlos; eine Suche legt eine neue Liste an
Prüfencheck_records, verify_email100+ Checks auf den gesendeten Datensätzen, nichts wird gespeichert
Anreichernenrich_records, get_jobGeschäftliche E-Mail, Mobilnummer, Jobtitel, LinkedIn, Firmendaten; Credits pro Treffer
Listen · Lesen + Prüfendescribe_list, query_records, check_list34 Filterbedingungen, z. B. c_level_executive, disposable_email, fuzzy_match
Listen · Bearbeitenadd_records, update_records, mark_records, fix_list, copy_recordsadd_records bis 1.000 pro Aufruf; update_records unterstützt only_empty
Listen · Allesenrich_records mit list_id, derive_column, send_to_pipelinederive_column füllt eine Spalte per KI, nach Verbrauch
Rechte

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.
Kosten

Was ein Aufruf kostet.

1 Credit ist €0,03 mit Pro, €0,05 mit Basic. Lesen, Checks und Korrekturen sind kostenlos.

VorgangCredits
find_person, check_records, count_companies, search_optionskostenlos
describe_list, query_records, check_list, fix_list und die anderen Listen-Werkzeugekostenlos
search_people (pro Seite mit bis zu 25 Personen)2
load_companies (pro Firma)0,25
verify_email (pro Adresse)0,3
enrich_recordspro gefundenem Feld, vorher estimate: true
derive_columnKI 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.