Para agentes e programadores

Um juízo humano, à distância de uma chamada de ferramenta.

O seu agente pode perguntar a cinquenta pessoas verificadas e receber uma distribuição em cerca de dez minutos, a partir de 0,21 € por resposta. O servidor MCP do 50heads funciona com Claude, Cursor, ChatGPT e tudo o que fale MCP.

Adicione-o ao seu anfitrião

Claude

No Claude, abra Definições, depois Conectores, e adicione um conector personalizado com este URL. Vai iniciar sessão e definir um limite de gasto diário.

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

Claude Code

Execute isto num terminal. O Claude Code abre o navegador para iniciar sessão 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 inicie sessão quando o Cursor pedir.

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

ChatGPT

No ChatGPT, abra Definições, depois Apps e conectores, depois Definições avançadas, e ative o modo de programador. Escolha Criar, cole este URL e selecione OAuth.

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

VS Code

Adicione isto a .vscode/mcp.json no seu espaço de trabalho, ou execute MCP: Add Server. O VS Code abre a página de início de sessão.

{
  "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 anfitriões que executam um comando local. Requer o Node 20 ou posterior e uma chave de API do portal.

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

Três chamadas

Estimar é gratuito e nunca gasta. Perguntar reserva os créditos. A espera acontece do nosso lado, por isso o seu agente faz uma chamada em vez de consultar repetidamente.

> 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

Ferramentas

estimate: Preço, prazo e validação de uma pergunta. Nunca gasta.
ask: Publica uma pergunta. Exige uma chave de idempotência, por isso uma nova tentativa nunca dá origem a uma segunda pergunta.
get_results: Os resultados até agora, sem esperar.
wait_for_results: Aguarda do nosso lado até a pergunta estar respondida.
list_questions: Perguntas recentes, para que um agente possa reutilizar um resultado antes de voltar a perguntar.
cancel: Para uma pergunta ativa e reembolsa as respostas não dadas.
templates: Modelos de pergunta com preço fixo.
balance: Créditos e o que resta do limite diário da ligação.

Seguro para deixar a funcionar

Cada ligação tem um limite de gasto diário, 59 € salvo se o alterar. Um agente não consegue ultrapassá-lo.
Perguntar exige uma chave de idempotência. A mesma chave devolve a mesma pergunta.
As perguntas seguem as mesmas regras de conteúdo que as de toda a gente. 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 simples chamada HTTPS. As chaves começam por fh_live_ e só são mostradas uma 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"