GetABrain MCP Server 是面向 GetABrain.ai 的 MCP 服务器，核心目标是把真实人类判断作为 AI 智能体的原生工具来调用。
用途 让 AI 智能体在需要真人判断时，通过 MCP 工具向付费真人工作者提问，并获得结构化、符合 schema 的 JSON 答案。适用场景包括 A/B 测试、评分、排序、情感分析、是/否判断、图像/视频/音频审核，以及语音/视频/照片捕捉等。
主要能力 服务器提供 7 个工具：
- get_balance：只读，返回预付余额（美分）、模式（test/live）以及 auto_reload_enabled；当自动充值关闭且可能导致正式账户余额为零时，会附带设置链接与提示。
- create_topup_link：生成 Stripe Checkout URL 用于充值（最低 5 美元），需真人打开浏览器完成支付，智能体无法自行完成付款。
- submit_query：向真人提问，支持 16 种查询类型（A/B 测试、评分、排序、情感、是/否、图像/视频/音频审核、语音/视频/照片捕捉等），返回 query_id。正式密钥会消耗余额；测试密钥免费且返回 simulated: true。
- get_responses：一次性、只读，立即返回当前状态和已有响应，不等待。
- wait_for_responses：有界轮询，最长 max_wait_seconds（默认和最大均为 50 秒）；当足够响应到达时返回 ready 及响应，否则返回 pending，可再次调用继续等待。
- list_queries：只读，列出最近查询，可按状态过滤。
- rate_response：对工作者回答按 1–5 评分（可选反馈文本），反馈至工作者质量系统。
使用方式 本地使用：将服务器加入 MCP 客户端配置（例如 claude_desktop_config.json），并在 https://getabrain.ai 注册以获得 API 密钥，通过环境变量传入 GETABRAIN_API_KEY / GETABRAIN_API_SECRET。 远程托管：无需本地安装，GetABrain 以 Streamable HTTP 在 https://www.getabrain.ai/api/mcp 提供同一服务器；将支持远程服务器的 MCP 客户端指向该 URL，并以请求头传递密钥对，而非环境变量。远程版本提供相同的 7 个工具、相同 schema 及测试模式支持；关于 Smithery 风格客户端、鉴权要求等细节，见仓库中的 docs/deploy/remote-mcp.md。 测试模式：测试模式是密钥上的标志，而非不同的密钥格式。通过 POST /api/v1/requestor/keys 并传 {"mode":"test"}，或在仪表盘选择 "test"，会得到完全正常的 gab_k_… / gab_s_… 密钥对；字符串中没有 test，测试状态以 is_test 标志存在数据库中。无需充值或银行卡。将环境变量指向测试密钥后，服务器行为一致，但 submit_query 不触碰余额、无扣费、无 insufficient_balance 错误；响应为合成数据并始终标记 simulated: true，便于在涉及真人或真钱之前端到端构建并演练提交→等待/轮询→评价的流水线；get_balance 会报告 mode: "test"。 切换到正式：生成 live 模式密钥（同样调用，传 {"mode":"live"} 或使用仪表盘默认值），用 create_topup_link 为账户充值（两种密钥类型均可生成链接，测试模式智能体可生成链接，由真人完成结账以添加真实资金），然后替换环境变量。此时 get_balance 报告 mode: "live"，submit_query 开始消耗真实余额并派发给付费真人工作者。
示例智能体流程
- get_balance 确认资金（或 mode: "test" 进行免费沙盒运行）。
- 若正式密钥资金不足：create_topup_link → 真人完成结账 → 再次 get_balance。
- submit_query → 获得 query_id。
- wait_for_responses（pending 时重复）→ 读取真人（测试模式下为模拟）答案。
- rate_response → 可选地对每个响应评分，以改善未来工作者匹配。
限制 查询等待最长 50 秒，超时后需再次调用。支付必须由真人完成，智能体不能自行付款。测试模式返回的是合成数据，不代表真人结果。完整 API 文档见 https://getabrain.ai/docs/api。
