50heads
Iniciar sesiónDescarga la app
Idioma
Para agentes y desarrolladores

Un juicio humano, a una llamada de distancia.

Tu agente puede preguntar a cincuenta personas verificadas y recibir un reparto en unos diez minutos, desde 0,14 € por respuesta. El servidor MCP de 50heads funciona con Claude, Cursor, ChatGPT y cualquier cosa que hable MCP.

Añádelo a tu host

Claude

En Claude, abre Ajustes, luego Conectores, y añade un conector personalizado con esta URL. Iniciarás sesión y fijarás un límite de gasto diario.

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

Claude Code

Ejecútalo en una terminal. Claude Code abre el navegador para que inicies sesión y fijes un límite de gasto diario.

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

Cursor

Añade esto a ~/.cursor/mcp.json e inicia sesión cuando Cursor te lo pida.

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

ChatGPT

En ChatGPT, abre Ajustes, luego Apps y conectores, luego Ajustes avanzados, y activa el modo desarrollador. Elige Crear, pega esta URL y selecciona OAuth.

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

VS Code

Añade esto a .vscode/mcp.json en tu espacio de trabajo, o usa MCP: Add Server. VS Code abre la página para iniciar sesión.

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

Windsurf

Añade esto a ~/.codeium/windsurf/mcp_config.json, con una clave de API del portal.

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

Otros (npx)

Para hosts que ejecutan un comando local. Necesita Node 20 o posterior y una clave de API del portal.

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

Tres llamadas

Estimar es gratis y nunca gasta. Preguntar reserva los créditos. La espera ocurre en nuestro lado, así que tu agente hace una llamada en vez de sondear.

> 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 = 7,08 € · 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

Herramientas

estimate
Precio, tiempo y validación de una pregunta. Nunca gasta.
ask
Publica una pregunta. Necesita una clave de idempotencia, así que un reintento nunca es una segunda pregunta.
get_results
Los resultados hasta ahora, sin esperar.
wait_for_results
Espera en nuestro lado hasta que la pregunta esté respondida.
list_questions
Preguntas recientes, para reutilizar un resultado antes de volver a preguntar.
cancel
Detiene una pregunta activa y devuelve las respuestas no dadas.
templates
Plantillas de preguntas con precio fijo.
balance
Créditos, y lo que queda del límite diario de la conexión.

Seguro para dejarlo funcionando

  • Cada conexión tiene un límite de gasto diario, 59 € salvo que lo cambies. Un agente no puede superarlo.
  • Preguntar requiere una clave de idempotencia. La misma clave devuelve la misma pregunta.
  • Las preguntas pasan las mismas normas de contenido que las de todos. Una pregunta rechazada no cuesta nada.
  • Los resultados nunca identifican a un head.

O llama a la API

Todo lo que hace el servidor MCP es una llamada HTTPS normal. Las claves empiezan por fh_live_ y se muestran una sola 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"

Un juicio humano, a una llamada de distancia.

Documentación de la APIConfigurar MCPWebhooks