GetABrain

@getabrain/mcp-server

Servidor MCP para GetABrain.ai: dale a tu agente de IA criterio humano real como herramientas nativas.

Uso con Claude Desktop / Cursor

Agrégalo a la configuración de tu cliente MCP (p. ej., claude_desktop_config.json):

{
  "mcpServers": {
    "getabrain": {
      "command": "npx",
      "args": ["-y", "@getabrain/mcp-server"],
      "env": {
        "GETABRAIN_API_KEY": "gab_k_…",
        "GETABRAIN_API_SECRET": "gab_s_…"
      }
    }
  }
}

Obtén tu clave de API registrándote en https://getabrain.ai.

Servidor MCP remoto (alojado): sin instalación

¿Prefieres no ejecutar nada localmente? GetABrain también aloja este mismo servidor mediante Streamable HTTP en https://www.getabrain.ai/api/mcp. Apunta cualquier cliente MCP compatible con servidores remotos a esa URL y pasa tu par de claves como encabezados en lugar de variables de entorno:

{
  "mcpServers": {
    "getabrain": {
      "url": "https://www.getabrain.ai/api/mcp",
      "headers": {
        "X-API-Key": "gab_k_…",
        "X-API-Secret": "gab_s_…"
      }
    }
  }
}

Las mismas 7 herramientas, los mismos esquemas, el mismo soporte de modo de prueba; consulta docs/deploy/remote-mcp.md en este repositorio para más detalles (clientes estilo Smithery, requisitos de autenticación, etc.).

Modo de prueba

El modo de prueba es una marca en la clave, no un formato de clave distinto. Cuando generas una clave de API — mediante POST /api/v1/requestor/keys con {"mode":"test"}, o eligiendo "test" en el panel — recibes un par de claves gab_k_… / gab_s_… completamente normal. No hay _test_ en la cadena; el estado de prueba vive en la base de datos como una marca is_test en esa clave. No se requiere saldo ni tarjeta.

Apunta GETABRAIN_API_KEY / GETABRAIN_API_SECRET a una clave en modo de prueba y el servidor se comportará de forma idéntica, excepto que:

• submit_query nunca toca tu saldo: sin cargo, sin errores de insufficient_balance.
• Las respuestas son sintéticas y siempre están marcadas como simulated: true, para que tu flujo (enviar → esperar/consultar → calificar) se pueda construir y probar de principio a fin antes de involucrar a un trabajador humano real o dinero real.
• get_balance informa mode: "test" para que el agente o la persona pueda ver de un vistazo en qué entorno está.

Cuando estés listo para pasar a producción: genera una clave en modo live (misma llamada, {"mode":"live"} o el panel por defecto), financia la cuenta con create_topup_link (funciona con cualquier tipo de clave: un agente en modo de prueba puede generar el enlace, una persona completa el pago para agregar fondos reales) y cambia las variables de entorno. get_balance entonces informa mode: "live", y submit_query comienza a gastar saldo real y a enviar solicitudes a trabajadores reales pagados.

Herramientas

• get_balance — solo lectura: saldo prepagado (en centavos), mode ("test"/"live") y auto_reload_enabled (con un enlace de configuración y una pista cuando está desactivado y bloquearía una cuenta live con saldo cero).
• create_topup_link — genera una URL de Stripe Checkout para agregar fondos (mínimo $5); una persona la abre en un navegador para pagar: el agente no puede completar el pago por sí mismo.
• submit_query — haz una pregunta a humanos reales (16 tipos de consulta: prueba A/B, calificación, ranking, sentimiento, sí/no, revisión de imagen/video/audio, captura de voz/video/foto, …). Devuelve un query_id. Gasta saldo en una clave live; es gratis y simulated: true en una clave de prueba.
• get_responses — de una sola vez, solo lectura: estado actual + las respuestas que existan en ese momento, sin esperar.
• wait_for_responses — sondeo acotado (hasta max_wait_seconds, máx. 50 s por defecto); devuelve ready con respuestas una vez que lleguen suficientes, o pending — vuelve a llamar para seguir esperando. Usa esto en lugar de get_responses cuando quieras que la propia llamada a la herramienta espere.
• list_queries — solo lectura: tus consultas recientes, opcionalmente filtradas por status.
• rate_response — califica la respuesta de un trabajador del 1 al 5 (feedback_text opcional); alimenta el sistema de calidad de los trabajadores.

Ejemplo de flujo de agente

1. get_balance → confirma fondos (o mode: "test" para una ejecución de prueba gratuita).
2. Si faltan fondos en una clave live: create_topup_link → una persona completa el pago → get_balance otra vez.
3. submit_query → obtén query_id.
4. wait_for_responses (repite mientras pending) → lee las respuestas humanas (o simuladas, en modo de prueba).
5. rate_response → opcionalmente califica cada respuesta para mejorar la asignación futura de trabajadores.

Documentación completa de la API: https://getabrain.ai/docs/api