50heads
EntrarBaixe o app
Idioma
Para agentes e desenvolvedores

Um julgamento humano, a uma chamada de ferramenta.

Seu agente pode perguntar a cinquenta pessoas verificadas e receber uma distribuição em cerca de dez minutos, a partir de 15,2¢ por resposta. O servidor MCP do 50heads funciona com Claude, Cursor, ChatGPT e qualquer coisa que fale MCP.

Adicione ao seu host

Claude

No Claude, abra Configurações, depois Conectores, e adicione um conector personalizado com esta URL. Você vai entrar e definir um limite diário.

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

Claude Code

Rode isto num terminal. O Claude Code abre o navegador para você entrar e definir um limite de gasto diário.

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

Cursor

Adicione isto a ~/.cursor/mcp.json e entre quando o Cursor pedir.

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

ChatGPT

No ChatGPT, abra Configurações, depois Apps e conectores, depois Configurações avançadas, e ative o modo desenvolvedor. Escolha Criar, cole esta URL e selecione OAuth.

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

VS Code

Adicione isto a .vscode/mcp.json no seu workspace, ou use MCP: Add Server. O VS Code abre a página de login.

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

Windsurf

Adicione isto a ~/.codeium/windsurf/mcp_config.json, com uma chave de API do portal.

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

Outros (npx)

Para hosts que rodam um comando local. Precisa do Node 20 ou mais recente e de uma chave de API do portal.

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

Três chamadas

Estimar é grátis e nunca gasta. Perguntar reserva os créditos. A espera acontece do nosso lado, então seu agente faz uma chamada em vez de ficar consultando.

> 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 = US$ 7,62 · 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

Ferramentas

estimate
Preço, prazo e validação de uma pergunta. Nunca gasta.
ask
Publica uma pergunta. Exige uma chave de idempotência, então uma nova tentativa nunca vira uma segunda pergunta.
get_results
Os resultados até agora, sem esperar.
wait_for_results
Espera do nosso lado até a pergunta ser respondida.
list_questions
Perguntas recentes, para reaproveitar um resultado antes de perguntar de novo.
cancel
Para uma pergunta no ar e reembolsa as respostas não dadas.
templates
Modelos de pergunta com preço fixo.
balance
Créditos e quanto resta do limite diário da conexão.

Seguro para deixar rodando

  • Toda conexão tem um limite de gasto diário, US$ 63,5 se você não mudar. Um agente não consegue passar disso.
  • Perguntar exige uma chave de idempotência. A mesma chave devolve a mesma pergunta.
  • As perguntas passam pelas mesmas regras de conteúdo que as de todo mundo. Uma pergunta recusada não custa nada.
  • Os resultados nunca identificam um head.

Ou chame a API

Tudo o que o servidor MCP faz é uma chamada HTTPS comum. As chaves começam com fh_live_ e aparecem uma única vez.

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"

Um julgamento humano, a uma chamada de ferramenta.

Documentação da APIConfigurar o MCPWebhooks