# Guitarmaniac24/getabrain-mcp-server [Health: Active]

**Category:** 🔬 Research  
**Repository:** https://github.com/Guitarmaniac24/getabrain-mcp-server  
**GitHub Stars:** 0  
**npm Downloads (last month):** 495  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/guitarmaniac24-getabrain-mcp-server

## Description
Query real, quality-scored humans as an agent tool. GetABrain routes a question to paid human workers and returns schema-validated JSON — 16 response types (yes/no, ratings, rankings, A/B tests, sentiment, image/video/audio review, voice/video/photo capture). Fully programmatic signup with a $5 free trial credit, no card required. npx -y @getabrain/mcp-server.

## Tools
Capabilities this server exposes over MCP:

- **get_balance** — read-only: prepaid balance (cents), `mode` (`"test"`/`"live"`), and `auto_reload_enabled`
- **create_topup_link** — mints a Stripe Checkout URL to add funds (min $5); a human opens it in a browser to
- **submit_query** — ask real humans a question (16 query types: A/B test, rating, ranking, sentiment, yes/no,
- **get_responses** — one-shot, read-only: current status + whatever responses exist right now, no waiting.
- **wait_for_responses** — bounded polling (up to `max_wait_seconds`, default/max 50s); returns `ready` with
- **list_queries** — read-only: your recent queries, optionally filtered by `status`.
- **rate_response** — rate a worker's answer 1–5 (optional `feedback_text`); feeds the worker quality system.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

**Requires environment variables:** `GETABRAIN_API_KEY`, `GETABRAIN_API_SECRET` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## 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`:

```json
{
  "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. Live keys use the account balance, and the README describes a $5 minimum for a top-up link as well as a $5 free trial credit with no card required.

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. The server requires GetABrain credentials, and the provided material does not specify a software license.

_Full upstream README: https://allmcps.com/mcp/guitarmaniac24-getabrain-mcp-server/readme_