50heads
AnmeldenApp laden
Sprache
Für Agents und Entwickler

Ein menschliches Urteil, einen Tool-Aufruf entfernt.

Dein Agent kann fünfzig verifizierte Menschen fragen und in etwa zehn Minuten eine Verteilung zurückbekommen, ab 0,14 € pro Antwort. Der 50heads-MCP-Server funktioniert mit Claude, Cursor, ChatGPT und allem, was MCP spricht.

Zu deinem Host hinzufügen

Claude

Öffne in Claude die Einstellungen, dann Konnektoren, und füg einen eigenen Konnektor mit dieser URL hinzu. Du meldest dich an und legst ein Tageslimit fest.

https://mcp.50heads.com/mcp

Claude Code

Führ das in einem Terminal aus. Claude Code öffnet einen Browser, in dem du dich anmeldest und ein Tageslimit festlegst.

claude mcp add --transport http 50heads https://mcp.50heads.com/mcp

Cursor

Füg das in ~/.cursor/mcp.json ein und melde dich an, wenn Cursor fragt.

{
  "mcpServers": {
    "50heads": {
      "url": "https://mcp.50heads.com/mcp"
    }
  }
}

ChatGPT

Öffne in ChatGPT die Einstellungen, dann Apps und Konnektoren, dann Erweiterte Einstellungen, und schalte den Entwicklermodus ein. Wähl Erstellen, füg diese URL ein und wähl OAuth.

https://mcp.50heads.com/mcp

VS Code

Füg das in .vscode/mcp.json in deinem Workspace ein oder nutz MCP: Add Server. VS Code öffnet die Anmeldeseite.

{
  "servers": {
    "50heads": {
      "type": "http",
      "url": "https://mcp.50heads.com/mcp"
    }
  }
}

Windsurf

Füg das in ~/.codeium/windsurf/mcp_config.json ein, mit einem API-Schlüssel aus dem Portal.

{
  "mcpServers": {
    "50heads": {
      "command": "npx",
      "args": [
        "-y",
        "@50heads/mcp"
      ],
      "env": {
        "FIFTYHEADS_API_KEY": "fh_live_…"
      }
    }
  }
}

Andere (npx)

Für Hosts, die einen lokalen Befehl starten. Braucht Node 20 oder neuer und einen API-Schlüssel aus dem Portal.

FIFTYHEADS_API_KEY=fh_live_… npx -y @50heads/mcp

Drei Aufrufe

Schätzen ist kostenlos und gibt nie etwas aus. Fragen reserviert die Credits. Gewartet wird auf unserer Seite, also macht dein Agent einen Aufruf statt ständig nachzufragen.

> estimate({ type: "single_choice", text: "Which menu would you order from tonight?",
             options: [{ label: "Menu A" }, { label: "Menu B" }], n: 50, tier: 1 })
  12 credits × 50 = 7,08 € · eta 10 min

> ask({ ...same question, idempotency_key: "4f9c…" })
  task q_8k2f · working · 0 of 50 answered

> get_results("q_8k2f")        # or wait_for_results on older hosts
  complete · winner "Menu B" · margin 36 points · confidence high

Tools

estimate
Preis, Dauer und Prüfung einer Frage. Gibt nie etwas aus.
ask
Stellt eine Frage. Braucht einen Idempotenzschlüssel, damit ein erneuter Versuch nie eine zweite Frage wird.
get_results
Die bisherigen Ergebnisse, ohne zu warten.
wait_for_results
Wartet auf unserer Seite, bis die Frage beantwortet ist.
list_questions
Letzte Fragen, damit ein Agent ein Ergebnis wiederverwenden kann, statt neu zu fragen.
cancel
Stoppt eine laufende Frage und erstattet die nicht gegebenen Antworten.
templates
Fragevorlagen zum Festpreis.
balance
Credits und was vom Tageslimit der Verbindung übrig ist.

Sicher im Dauerbetrieb

  • Jede Verbindung hat ein Tageslimit, 59 €, solange du es nicht änderst. Ein Agent kann nicht darüber hinaus ausgeben.
  • Fragen braucht einen Idempotenzschlüssel. Derselbe Schlüssel liefert dieselbe Frage.
  • Fragen durchlaufen dieselben Inhaltsregeln wie alle anderen. Eine abgelehnte Frage kostet nichts.
  • Ergebnisse identifizieren nie einen head.

Oder ruf die API auf

Alles, was der MCP-Server tut, ist ein einfacher HTTPS-Aufruf. Schlüssel beginnen mit fh_live_ und werden nur einmal angezeigt.

curl https://api.50heads.com/v1/billing/estimate \
  -H "Content-Type: application/json" \
  -d '{"draft":{"type":"single_choice","text":"Which menu would you order from tonight?",
       "options":[{"label":"Menu A"},{"label":"Menu B"}],"n":50,"tier":1}}'

curl https://api.50heads.com/v2/questions \
  -H "Authorization: Bearer $FIFTYHEADS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"draft":{"type":"single_choice","text":"Which menu would you order from tonight?",
       "options":[{"label":"Menu A"},{"label":"Menu B"}],"n":50,"tier":1,"language":"en"}}'

curl "https://api.50heads.com/v2/questions/q_8k2f/wait?seconds=25" \
  -H "Authorization: Bearer $FIFTYHEADS_API_KEY"

Ein menschliches Urteil, einen Tool-Aufruf entfernt.

API-DokumentationMCP einrichtenWebhooks