Getabrain MCP Server

What Guitarmaniac24/getabrain-mcp-server MCP server does

Guitarmaniac24/getabrain-mcp-server MCP server connects an MCP-compatible agent to GetABrain.ai. It lets an agent send questions to human respondents, receive structured results, inspect query progress, and rate submitted answers. The service supports 16 query formats, including yes/no questions, ratings, rankings, A/B comparisons, sentiment analysis, and reviews of images, video, or audio. It also supports requests that collect voice, video, or photo responses.

The server can operate against either a test-mode or live-mode API key. Test mode is intended for developing and exercising an end-to-end workflow: submissions do not consume balance, and returned answers are synthetic and marked as simulated. Live mode sends requests to paid human workers and uses the account's prepaid funds.

How it works

Configure the server with a GetABrain API key and API secret, then expose it to an MCP client. An agent can first call get_balance to check the account's available cents, environment mode, and auto-reload status. For a live account that needs funds, create_topup_link produces a Stripe Checkout URL that a human must open and complete; the agent cannot pay through the tool.

The usual request sequence is to call submit_query, retain the returned query ID, and retrieve answers with either get_responses or wait_for_responses. The first retrieval method returns the current state immediately. The second performs bounded polling for up to 50 seconds, returning either available responses or a pending state for a later call. list_queries provides a recent-query view with optional status filtering. After reviewing an answer, rate_response accepts a score from 1 to 5 and optional written feedback for the worker-quality system.

Setup and configuration

The package can run locally through npx:

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

Get the credential pair by signing up at GetABrain.ai. Test or live mode is determined by the key configuration, not by a different key-string format. Test keys require no funding.

A hosted option is also available at https://www.getabrain.ai/api/mcp over Streamable HTTP. In that configuration, send the credentials as X-API-Key and X-API-Secret headers instead of environment variables. The hosted endpoint exposes the same seven tools and supports test mode.

Tools and capabilities

Guitarmaniac24/getabrain-mcp-server MCP server exposes:

• get_balance for balance, mode, and auto-reload information.
• create_topup_link for generating a human-completed Stripe payment URL.
• submit_query for creating one of the supported human-judgment requests.
• get_responses for an immediate status and response check.
• wait_for_responses for bounded polling.
• list_queries for recent queries and optional status filtering.
• rate_response for scoring worker answers and adding feedback.

Limitations and notes

The agent cannot complete the Stripe payment itself. Live submissions depend on available prepaid balance, whereas test submissions are synthetic and do not represent responses from real workers. wait_for_responses is bounded at 50 seconds per call, so an agent may need to call it again when the result remains pending.