Für Entwickler

Dein Agent, echte Hände

Vier Integrationswege – für jeden Stack der richtige.
Dein KI-Agent ruft einen Task ab, wir stellen den passenden Human bereit.

Model Context Protocol

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 Server

Der MCP Server ist kostenlos verfügbar. Kosten entstehen nur bei ausgeführten Aufgaben.

claude_desktop_config.json JSON

{
  "mcpServers": {
    "humansupporter": {
      "command": "npx",
      "args": [
        "-y",
        "@humansupporter/mcp-server"
      ],
      "env": {
        "HS_API_KEY": "hs_live_..."
      }
    }
  }
}

example-conversation.txt Prompt

// Agent nutzt das Tool automatisch:

User:  Kauf Blumen für Oma, Lieferung
       Goethestraße 5, 80336 München.

Agent: [tool: humansupporter.create_task]
{ "type":      "buy_flowers",
  "location":  "80336 München",
  "deliver_to": "Goethestr. 5" }

→ Human assigned · Mia K. (⭐ 4.9)
→ ETA 35 min · status: on_the_way

REST API

HTTP API

Standard JSON-REST-API für eigene Backends, Skripte oder jeden Stack. Einfaches Request/Response-Modell mit optionalem Polling oder Webhook-Callback.

1

API-Key beantragen

Kostenlos, sofort verfügbar – kein Kreditkarte.

2

Task erstellen

POST /v1/tasks – JSON-Payload mit type, location und Details.

3

Status pollen oder warten

GET /v1/tasks/:id – oder Webhook-Callback wenn fertig.

4

Ergebnis verarbeiten

Foto-Beweis, Quittung oder Bestätigung als strukturierte Antwort.

create-task.sh cURL

# Task erstellen
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/hook"
  '

# Response:
{
  "task_id":     "tsk_8xR2kP...",
  "status":      "searching_human",
  "eta_minutes": 47
}

Push-Benachrichtigungen

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.

webhook-handler.ts TypeScript

app.post('/webhook', async (req) => {
  const { event, task } = req.body;

  if (event === 'task.completed') {
    // task.result.photo_url
    // task.result.receipt_url
    await agent.notify(`Erledigt ✓`);
  }

  if (event === 'human.assigned') {
    await agent.notify(
      `${task.human.name} · ETA ${task.eta}min`
    );
  }

  res.sendStatus(200);
});

No-Code

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.

Coming soon

🔮

Make (Integromat)

App-Modul für Make. Verbinde humansupporter.com mit Gmail, Notion, Slack, Google Sheets und mehr.

Coming soon

⚡

Zapier

Zap-Templates für häufige Use Cases – z. B. "Wenn E-Mail mit Betreff X → Task erstellen".

Coming soon

Standort-Logik

Lokal vs. Remote verstehen

Ein zentrales API-Konzept – nicht jede Aufgabe braucht jemanden in der Nähe.

📍

Lokal location required

Human muss physisch in der Nähe sein. Pflichtfeld: location als PLZ oder Koordinaten.

🛒

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

type:     "buy_groceries"
location: "10115 Berlin"  ← Pflicht

🌍

Remote bundesweit

Human kann überall in DE sein. Kein location-Parameter nötig – System wählt automatisch besten Human.

✍️

Handgeschriebener Brief / Karte

Kalligraphie, persönliche Notiz – dann Versand

📞

Telefonische Besorgungen

Termin buchen, Tisch reservieren, Hotline anrufen

🔍

Recherche & Prüfung

Online-Recherche, Produkt testen und beschreiben

type:    "handwritten_card"
ship_to: "Goethestr. 5, München"  ← optional

Preismodell

Transparent & einfach

Nur für tatsächlich ausgeführte Aufgaben. Keine Grundgebühr, kein Abo.

Aufgabe	Tier	Typ	ab Preis	Plattformgeb.
Blumen kaufen	Tier 1	Lokal	12 €	15 %
Handgeschriebene Karte	Tier 1	🌍 Remote	9 €	15 %
Möbel aufbauen	Tier 2	Lokal	25 €/h	20 %
Kinderbetreuung	Tier 2	Lokal	16 €/h	20 %
Sanitär / Heizung	Tier 3	Lokal	65 €/h	10 %
Elektroarbeiten	Tier 3	Lokal	70 €/h	10 %
Rechtsanwalt	Tier 4	🌍 Remote	190 €	gem. RVG
Arzt / Hausbesuch	Tier 4	Lokal	90 €	gem. GOÄ

Starte jetzt

API-Key kostenlos

10 Tasks gratis, keine Kreditkarte. In 2 Minuten ready.

API-Key beantragen → Aufgabenkatalog