Voor agents en developers

Een menselijk oordeel, één tool call verderop.

Je agent kan vijftig geverifieerde mensen iets vragen en in ongeveer tien minuten een verdeling terugkrijgen, vanaf € 0,21 per antwoord. De 50heads MCP-server werkt met Claude, Cursor, ChatGPT en alles wat MCP spreekt.

Voeg het toe aan je host

Claude

Open in Claude Instellingen en dan Connectors, en voeg een eigen connector toe met deze URL. Je logt in en stelt een dagelijkse bestedingslimiet in.

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

Claude Code

Voer dit uit in een terminal. Claude Code opent een browser waarin je inlogt en een dagelijkse bestedingslimiet instelt.

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

Cursor

Voeg dit toe aan ~/.cursor/mcp.json en log in zodra Cursor erom vraagt.

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

ChatGPT

Open in ChatGPT Instellingen, dan Apps en connectors, dan Geavanceerde instellingen, en zet de ontwikkelaarsmodus aan. Kies Maken, plak deze URL en kies OAuth.

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

VS Code

Voeg dit toe aan .vscode/mcp.json in je workspace, of voer MCP: Add Server uit. VS Code opent de inlogpagina.

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

Windsurf

Voeg dit toe aan ~/.codeium/windsurf/mcp_config.json, met een API-sleutel uit het portaal.

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

Anders (npx)

Voor hosts die een lokale opdracht starten. Vereist Node 20 of hoger en een API-sleutel uit het portaal.

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

Drie calls

Inschatten is gratis en kost nooit iets. Vragen reserveert de credits. Het wachten gebeurt aan onze kant, dus je agent doet één call in plaats van te pollen.

> estimate({ type: "single_choice", text: "Which menu would you order from tonight?",
             options: [{ label: "Menu A" }, { label: "Menu B" }], n: 50, tier: 1 })
  18 credits × 50 = 900 credits · 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: Prijs, tijd en validatie voor een vraag. Kost nooit iets.
ask: Plaatst een vraag. Vereist een idempotency key, zodat een nieuwe poging nooit een tweede vraag wordt.
get_results: De resultaten tot nu toe, zonder te wachten.
wait_for_results: Wacht aan onze kant tot de vraag beantwoord is.
list_questions: Recente vragen, zodat een agent een resultaat kan hergebruiken in plaats van opnieuw te vragen.
cancel: Stopt een live vraag en betaalt de niet-gegeven antwoorden terug.
templates: Vraagsjablonen met een vaste prijs.
balance: Credits, en wat er over is binnen de daglimiet van de verbinding.

Veilig om te laten draaien

Elke verbinding heeft een dagelijkse bestedingslimiet, € 59 tenzij je die wijzigt. Een agent kan er niet overheen.
Vragen vereist een idempotency key. Dezelfde key geeft dezelfde vraag terug.
Vragen moeten aan dezelfde inhoudsregels voldoen als die van iedereen. Een geweigerde vraag kost niets.
Resultaten maken nooit bekend wie een head is.

Of roep de API aan

Alles wat de MCP-server doet is een gewone HTTPS-call. Keys beginnen met fh_live_ en worden één keer getoond.

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"