För AI-assistenter och utvecklare

Använd 50heads från en AI-assistent.

Koppla 50heads till en kompatibel AI-assistent så att den kan fråga riktiga personer och ta emot resultatet. Det tar ungefär tio minuter att sätta upp och kostar från 0,25 € per svar. Det fungerar via MCP, standarden som låter en assistent använda externa verktyg, så det går att köra i Claude, Cursor, ChatGPT och alla värdar som stöder MCP.

Lägg till i din värd

Claude

Öppna Inställningar i Claude, sedan Kopplingar, och lägg till en egen koppling med den här adressen. Du loggar in och sätter ett dagligt utgiftstak.

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

Claude Code

Kör det här i en terminal. Claude Code öppnar en webbläsare där du loggar in och sätter ett dagligt utgiftstak.

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

Cursor

Lägg till det här i ~/.cursor/mcp.json och logga sedan in när Cursor frågar.

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

ChatGPT

Öppna Inställningar i ChatGPT, sedan Appar och kopplingar, sedan Avancerade inställningar, och slå på utvecklarläget. Välj Skapa, klistra in den här adressen och välj OAuth.

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

VS Code

Lägg till det här i .vscode/mcp.json i din arbetsyta, eller kör MCP: Add Server. VS Code öppnar inloggningssidan.

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

Windsurf

Lägg till det här i ~/.codeium/windsurf/mcp_config.json, med en API-nyckel från portalen.

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

Annat (npx)

För värdar som startar ett lokalt kommando. Kräver Node 20 eller senare och en API-nyckel från portalen.

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

Grundflödet har tre steg

Uppskattningen är gratis och kostar aldrig något. Frågan reserverar krediterna. Vänta på resultat: 50heads håller i väntan, så din assistent gör ett anrop i stället för att kolla om och om igen.

> 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

Tillgängliga verktyg

estimate: Pris, tid och kontroll av en fråga. Kostar aldrig något.
ask: Skickar en fråga. Kräver en idempotensnyckel: ett nytt försök med samma nyckel kan inte skapa en andra fråga eller en andra debitering.
get_results: Resultaten hittills, utan att vänta.
wait_for_results: Väntar hos oss tills frågan är besvarad, så att klienten inte behöver fråga om och om igen.
list_questions: Senaste frågor, så att en agent kan återanvända ett resultat innan den frågar igen.
cancel: Stoppar en aktiv fråga och återbetalar de svar som inte gavs.
templates: Frågemallar med fast pris.
balance: Krediter, och vad som är kvar av kopplingens dagliga tak.

Kontroller för obevakad användning

Varje koppling har ett dagligt utgiftstak, 5 000 krediter om du inte ändrar det. Servern nekar en fråga som skulle gå över taket.
Frågan kräver en idempotensnyckel. Ett nytt försök med samma nyckel kan inte skapa en andra fråga eller en andra debitering.
Frågor går igenom samma innehållsregler som alla andras. En nekad fråga kostar ingenting.
Resultat identifierar aldrig en head.

Eller anropa API:et

Allt som MCP-servern gör är ett vanligt HTTPS-anrop. Nycklar börjar med fh_live_ och visas en gång.

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"

Låt din AI-assistent fråga riktiga personer.

API-dokumentation MCP-installation Webhooks