For KI-assistenter og utviklere

Bruk 50heads fra en KI-assistent.

Koble 50heads til en kompatibel KI-assistent, så kan den stille ekte personer et spørsmål og motta resultatet. Det tar omtrent ti minutter å sette opp og koster fra 0,25 € per svar. Det fungerer gjennom MCP, standarden som lar en assistent bruke eksterne verktøy, så det virker i Claude, Cursor, ChatGPT og alle verter som støtter MCP.

Legg det til i verten din

Claude

Åpne Innstillinger i Claude, velg Koblinger, og legg til en egendefinert kobling med denne URL-en. Du logger inn og setter en daglig utgiftsgrense.

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

Claude Code

Kjør dette i en terminal. Claude Code åpner en nettleser der du logger inn og setter en daglig utgiftsgrense.

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

Cursor

Legg dette til i ~/.cursor/mcp.json, og logg inn når Cursor ber om det.

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

ChatGPT

Åpne Innstillinger i ChatGPT, velg Apper og koblinger, deretter Avanserte innstillinger, og slå på utviklermodus. Velg Opprett, lim inn denne URL-en og velg OAuth.

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

VS Code

Legg dette til i .vscode/mcp.json i arbeidsområdet ditt, eller kjør MCP: Add Server. VS Code åpner innloggingssiden.

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

Windsurf

Legg dette til i ~/.codeium/windsurf/mcp_config.json, med en API-nøkkel fra portalen.

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

Annet (npx)

For verter som starter en lokal kommando. Krever Node 20 eller nyere og en API-nøkkel fra portalen.

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

Grunnflyten har tre steg

Prisberegningen er gratis og koster aldri noe. Spørsmålet reserverer kreditter. Vent på resultater: 50heads tar ventingen, så assistenten din gjør ett kall i stedet for å sjekke igjen og igjen.

> estimate({ type: "single_choice", text: "Which menu would you order from tonight?",
             options: [{ label: "Menu A" }, { label: "Menu B" }], n: 50, tier: 1 })
  20 credits × 50 = 1000 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

Tilgjengelige verktøy

estimate: Pris, tid og kontroll av et spørsmål. Koster aldri noe.
ask: Sender et spørsmål. Krever en idempotensnøkkel: et nytt forsøk med samme nøkkel kan ikke opprette et nytt spørsmål eller en ny belastning.
get_results: Resultatene så langt, uten å vente.
wait_for_results: Venter hos oss til spørsmålet er besvart, så klienten slipper å sjekke om og om igjen.
list_questions: Nylige spørsmål, så en agent kan gjenbruke et resultat før den spør på nytt.
cancel: Stopper et åpent spørsmål og refunderer svarene som ikke er gitt.
templates: Spørsmålsmaler til fast pris.
balance: Kreditter, og hva som er igjen av den daglige grensen for tilkoblingen.

Kontroller for bruk uten tilsyn

Hver tilkobling har en daglig utgiftsgrense, 5 000 kreditter hvis du ikke endrer den. Serveren avviser et spørsmål som ville gått over grensen.
Spørsmålet krever en idempotensnøkkel. Et nytt forsøk med samme nøkkel kan ikke opprette et nytt spørsmål eller en ny belastning.
Spørsmål må følge de samme innholdsreglene som alle andres. Et avvist spørsmål koster ingenting.
Resultater identifiserer aldri en head.

Eller bruk API-et direkte

Alt MCP-serveren gjør, er et vanlig HTTPS-kall. Nøkler begynner med fh_live_ og vises én gang.

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"

La KI-assistenten din spørre ekte personer.

API-dokumentasjon Oppsett av MCP Webhooks