GetABrain

@getabrain/mcp-server

Servidor MCP para GetABrain.ai — dê ao seu agente de IA julgamento humano real como ferramentas nativas.

Uso com Claude Desktop / Cursor

Adicione à sua configuração do cliente MCP (ex.: claude_desktop_config.json):

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

Obtenha sua chave de API cadastrando-se em https://getabrain.ai.

Servidor MCP remoto (hospedado) — sem instalação

Prefere não executar nada localmente? O GetABrain também hospeda este mesmo servidor via HTTP Streamable em https://www.getabrain.ai/api/mcp. Aponte qualquer cliente MCP que suporte servidores remotos para essa URL e passe seu par de chaves como cabeçalhos em vez de variáveis de ambiente:

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

Mesmas 7 ferramentas, mesmos esquemas, mesmo suporte ao modo de teste — veja docs/deploy/remote-mcp.md neste repositório para detalhes (clientes estilo Smithery, requisitos de autenticação, etc.).

Modo de teste

O modo de teste é uma flag na chave, não um formato de chave diferente. Quando você gera uma chave de API — via POST /api/v1/requestor/keys com {"mode":"test"}, ou escolhendo "teste" no painel — você recebe um par de chaves gab_k_… / gab_s_… completamente normal. Não há _test_ na string; a característica de teste reside no banco de dados como uma flag is_test nessa chave. Nenhum financiamento ou cartão é necessário.

Aponte GETABRAIN_API_KEY / GETABRAIN_API_SECRET para uma chave em modo de teste e o servidor se comporta de forma idêntica, exceto:

• submit_query nunca toca no seu saldo — sem cobrança, sem erros de insufficient_balance.
• As respostas vêm sintéticas e são sempre marcadas como simulated: true, para que seu pipeline (enviar → aguardar/poll → avaliar) possa ser construído e exercitado de ponta a ponta antes de envolver qualquer trabalhador humano real ou dinheiro real.
• get_balance relata mode: "test" para que o agente/humano possa saber rapidamente em qual ambiente está.

Quando estiver pronto para ir ao ar: gere uma chave de modo ao vivo (mesma chamada, {"mode":"live"} ou o padrão do painel), funde a conta com create_topup_link (funciona com qualquer tipo de chave — um agente em modo de teste pode gerar o link, um humano conclui o checkout para adicionar fundos reais) e troque as variáveis de ambiente. get_balance então relata mode: "live", e submit_query começa a gastar saldo real e despachar para trabalhadores pagos reais.

Ferramentas

• get_balance — somente leitura: saldo pré-pago (centavos), mode ("test"/"live") e auto_reload_enabled (com um link de configuração + dica quando estiver desligado e poderia travar uma conta ao vivo com saldo zero).
• create_topup_link — gera uma URL de Checkout do Stripe para adicionar fundos (mínimo $5); um humano a abre no navegador para pagar — o agente não pode concluir o pagamento sozinho.
• submit_query — faça uma pergunta a humanos reais (16 tipos de consulta: teste A/B, avaliação, classificação, sentimento, sim/não, revisão de imagem/vídeo/áudio, captura de voz/vídeo/foto, …). Retorna um query_id. Gasta saldo em uma chave ao vivo; gratuito e simulated: true em uma chave de teste.
• get_responses — única chamada, somente leitura: status atual + quaisquer respostas existentes agora, sem espera.
• wait_for_responses — polling limitado (até max_wait_seconds, padrão/máx 50s); retorna ready com respostas quando suficientes chegarem, ou pending — chame novamente para continuar esperando. Use isso em vez de get_responses quando quiser que a própria chamada da ferramenta espere.
• list_queries — somente leitura: suas consultas recentes, opcionalmente filtradas por status.
• rate_response — avalie a resposta de um trabalhador de 1 a 5 (feedback_text opcional); alimenta o sistema de qualidade do trabalhador.

Exemplo de fluxo do agente

1. get_balance → confirme os fundos (ou mode: "test" para uma execução gratuita em sandbox).
2. Se os fundos forem insuficientes em uma chave ao vivo: create_topup_link → humano conclui o checkout → get_balance novamente.
3. submit_query → obtenha query_id.
4. wait_for_responses (repita enquanto pending) → leia as respostas humanas (ou simuladas, no modo de teste).
5. rate_response → opcionalmente avalie cada resposta para melhorar a correspondência futura de trabalhadores.

Documentação completa da API: https://getabrain.ai/docs/api