Dein Agent, echte Hände
Drei Integrationswege – für jeden Stack der richtige. Dein KI-Agent ruft einen Task ab, wir stellen den passenden Human bereit.
MCP Server
Das Model Context Protocol ermöglicht KI-Agenten wie Claude oder GPT-4 direkten Zugriff auf externe Tools. Unser MCP-Server ist der schnellste Weg, deinen Agenten mit echten Menschen zu verbinden.
Tool-basiert
Dein Agent ruft humansupporter.create_task() auf – wie jedes andere Tool.
Bidirektional
Der Agent kann den Status abfragen, auf Updates warten und Ergebnisse direkt verarbeiten.
Kostenloser Zugang
Der MCP Server ist kostenlos verfügbar. Kosten entstehen nur bei tatsächlich ausgeführten Aufgaben.
"mcpServers": {
"humansupporter": {
"command": "npx",
"args": [
"-y",
"@humansupporter/mcp-server"
],
"env": {
"HS_API_KEY": "hs_live_..."
}
}
}
}
User: Kauf heute Blumen für Oma und bringe sie
in die Goethestraße 5, 80336 München.
Agent: [tool: humansupporter.create_task]
{ "type": "buy_flowers",
"location": "80336 München",
"deliver_to": "Goethestr. 5" }
→ Human assigned · ETA 35 min
HTTP API
Standard JSON-REST-API für eigene Backends, Skripte oder jeden Stack. Einfaches Request/Response-Modell mit optionalem Polling oder Webhook-Callback.
API-Key beantragen
Kostenlos, sofort verfügbar.
Task erstellen
POST /v1/tasks – JSON-Payload mit Task-Type, Location und Details.
Status pollen oder warten
GET /v1/tasks/:id – oder Webhook-Callback wenn fertig.
Ergebnis verarbeiten
Foto, Quittung, Bestätigung als strukturierte Antwort.
curl -X POST https://api.humansupporter.com/v1/tasks \
-H "Authorization: Bearer hs_live_..." \
-H "Content-Type: application/json" \
-d '{
"type": "buy_groceries",
"tier": 1,
"location": "10115 Berlin",
"items": ["Milch 1L", "Brötchen x6"],
"deliver_to": "Musterstr. 12",
"urgency": "within_2h",
"webhook_url": "https://mein.app/webhook"
}'
# Response:
{ "task_id": "tsk_8xR2...",
"status": "searching_human",
"eta_minutes": 47 }
Webhooks
Kein Polling nötig – wir schicken dir Events direkt, sobald sich der Task-Status ändert. Dein Agent reagiert in Echtzeit.
Events
human.assigned
Ein Human hat die Aufgabe angenommen. Inkl. Profil und ETA.
task.in_progress
Die Aufgabe wird gerade ausgeführt. Optionaler Live-Standort.
task.completed
Aufgabe abgeschlossen. Inkl. Foto-Beweis, Quittung und Zeitstempel.
task.failed
Aufgabe nicht ausführbar. Grund + automatisches Refund-Trigger.
const { event, task } = req.body;
if (event === 'task.completed') {
// task.result.photo_url vorhanden
// task.result.receipt_url vorhanden
await agent.notify(`Erledigt ✓`);
}
if (event === 'human.assigned') {
// task.human.name, task.eta
await agent.notify(
`${task.human.name} kommt in ${task.eta}min`
);
}
});
n8n, Make & Zapier
Für alle, die ohne Code arbeiten möchten – fertige Nodes und Templates für die beliebtesten Automationstools.
n8n Node
Nativer Node für n8n-Workflows. Drag & Drop, keine API-Kenntnisse nötig. Workflow-Templates zum Import verfügbar.
Make (Integromat)
App-Modul für Make. Verbinde humansupporter.com mit Gmail, Notion, Slack, Google Sheets und mehr.
Zapier
Zap-Templates für häufige Use Cases – z. B. "Wenn E-Mail mit Betreff X → Task erstellen".
Standort-Logik verstehen
Nicht jede Aufgabe braucht jemanden in der Nähe – das ist ein zentrales Konzept in der API.
Lokal (location required)
Human muss physisch in der Nähe sein. Du gibst location als PLZ oder Koordinaten an.
-
🛒
Einkäufe & Lieferung
Bäcker und Supermarkt vor Ort, Lieferung zur Adresse
-
🗑️
Haushalt & Alltag
Müll, Pakete, Treppe – geht nur in der Wohnung selbst
-
🔧
Handwerk & Montage
Aufbau und Reparaturen erfordern Anwesenheit
location: "10115 Berlin" ← Pflicht
Remote (bundesweit / ortsunabhängig)
Human kann überall in DE sein. Kein location-Parameter nötig – System wählt besten verfügbaren Human.
-
✍️
Handgeschriebener Brief / Karte
Kalligraphie, persönliche Notiz, Glückwunschkarte – dann Versand
-
📞
Telefonische Besorgungen
Termin buchen, Tisch reservieren, Hotline anrufen
-
🔍
Recherche & Prüfung
Online-Recherche, Produkt testen und beschreiben
ship_to: "Goethestr. 5, München" ← optional
Transparent & einfach
Du zahlst nur für tatsächlich ausgeführte Aufgaben. Keine Grundgebühr, kein Abo.
API-Key kostenlos beantragen
10 Tasks gratis, kein Kreditkarte. In 2 Minuten ready.
API-Key holen →