The official GetABrain MCP server plugs real, quality-scored human judgment straight into Claude Desktop, Cursor, or any Model Context Protocol client -- as 7 tools your agent can call directly. No HTTP client to write, no auth boilerplate.
npx -y @getabrain/mcp-server · 7 tools · free synthetic test mode
@getabrain/mcp-server is an official Model Context Protocol (MCP) server. It wraps the GetABrain human-in-the-loop API as 7 native tools, so an MCP-aware agent -- Claude Desktop, Cursor, or a custom runtime -- can ask a real person a structured question, wait for the answer, and rate it, without your code touching HTTP or auth headers directly.
It runs over stdio via npx -y @getabrain/mcp-server, same as any other MCP server -- add it to your client's config with two environment variables and it's live.
Add this to your MCP client config -- e.g. claude_desktop_config.json -- and your agent gets all 7 tools immediately.
{
"mcpServers": {
"getabrain": {
"command": "npx",
"args": ["-y", "@getabrain/mcp-server"],
"env": {
"GETABRAIN_API_KEY": "gab_k_…",
"GETABRAIN_API_SECRET": "gab_s_…"
}
}
}
}Get your API key by signing up at getabrain.ai.
Test mode is a flag on the key, not a different key shape. Mint a key with {"mode":"test"} -- via POST /api/v1/requestor/keys or the dashboard -- and you get back a completely normal gab_k_… / gab_s_…key pair. There's no _test_ in the string -- the test-ness is a database flag on that key.
Point the MCP server's env vars at a test-mode key and:
submit_query returns free synthetic responses, always marked simulated: trueinsufficient_balance errorsget_balance reports mode: "test"Build and exercise your whole pipeline -- submit, wait/poll, read responses, rate them, even webhooks -- for free. When you're ready, mint a live key, fund it with create_topup_link (a human opens the returned Stripe checkout URL to pay), and swap the env vars. Real humans, real spend, same tools.
get_balanceRead-only: prepaid balance in cents, account mode ("test"/"live"), and auto-reload status.
create_topup_linkMints a Stripe Checkout URL (min $5) for a human to open and add funds -- the agent cannot pay itself.
submit_queryAsk real humans a structured question (16 query types). Returns a query_id. Free + simulated on a test key, spends balance on a live key.
get_responsesOne-shot, read-only: current status and whatever responses exist right now, no waiting.
wait_for_responsesBounded polling (up to 50s) that returns "ready" with responses once enough arrive, or "pending" to call again.
list_queriesRead-only: your recent queries, optionally filtered by status.
rate_responseRate a worker's answer 1-5 with optional feedback text, feeding the worker quality system.
get_balance confirms mode ("test" for a free sandbox run) and funds. submit_query asks real humans a structured question and returns a query_id.
wait_for_responses blocks for up to 50s and returns the answers once enough arrive -- or get_responses for an instant, one-shot snapshot.
Read the human (or simulated, in test mode) answers, then rate_response to feed the worker quality system before your next call.
Sign up, grab an API key, and try it free in test mode -- no card, no sales call.