Per agenti e sviluppatori

Un giudizio umano, a una chiamata di distanza.

Il tuo agente può chiedere a cinquanta persone verificate e ricevere una distribuzione in circa dieci minuti, da 0,21 € a risposta. Il server MCP di 50heads funziona con Claude, Cursor, ChatGPT e con tutto ciò che parla MCP.

Aggiungilo al tuo host

Claude

In Claude, apri Impostazioni, poi Connettori, e aggiungi un connettore personalizzato con questo URL. Accederai e imposterai un tetto di spesa giornaliero.

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

Claude Code

Eseguilo in un terminale. Claude Code apre un browser per accedere e impostare un tetto di spesa giornaliero.

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

Cursor

Aggiungilo a ~/.cursor/mcp.json, poi accedi quando Cursor lo chiede.

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

ChatGPT

In ChatGPT, apri Impostazioni, poi App e connettori, poi Impostazioni avanzate, e attiva la modalità sviluppatore. Scegli Crea, incolla questo URL e seleziona OAuth.

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

VS Code

Aggiungilo a .vscode/mcp.json nel tuo workspace, oppure esegui MCP: Add Server. VS Code apre la pagina di accesso.

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

Windsurf

Aggiungilo a ~/.codeium/windsurf/mcp_config.json, con una chiave API dal portale.

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

Altro (npx)

Per gli host che avviano un comando locale. Richiede Node 20 o successivo e una chiave API dal portale.

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

Tre chiamate

La stima è gratuita e non spende mai. La domanda riserva i crediti. L’attesa avviene dalla nostra parte, così il tuo agente fa una sola chiamata invece del polling.

> 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

Strumenti

estimate: Prezzo, tempi e validazione di una domanda. Non spende mai.
ask: Pubblica una domanda. Richiede una chiave di idempotenza, così un nuovo tentativo non è mai una seconda domanda.
get_results: I risultati finora, senza attendere.
wait_for_results: Attende dalla nostra parte finché la domanda ha risposta.
list_questions: Domande recenti, così un agente può riusare un risultato prima di chiedere di nuovo.
cancel: Ferma una domanda in corso e rimborsa le risposte non date.
templates: Modelli di domanda a prezzo fisso.
balance: Crediti, e quanto resta sotto il tetto giornaliero della connessione.

Puoi lasciarlo andare

Ogni connessione ha un tetto di spesa giornaliero, 59 € se non lo cambi. Un agente non può superarlo.
Chiedere richiede una chiave di idempotenza. La stessa chiave restituisce la stessa domanda.
Le domande seguono le stesse regole sui contenuti di tutti gli altri. Una domanda rifiutata non costa nulla.
I risultati non identificano mai un head.

Oppure chiama l’API

Tutto ciò che fa il server MCP è una semplice chiamata HTTPS. Le chiavi iniziano con fh_live_ e vengono mostrate una sola volta.

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"