# 50heads

An MCP server that lets your coding agent put a five-second question to fifty verified people and read their answers without leaving the editor.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: 50heads
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/50heads/mcp
- Updated: 2026-10-13
- HTML: https://affpapa.org/en/nevibecode/mcp/50heads

## What it does

The server exposes nine tools, and every one takes an `action`. Pricing and balance sit in `estimate`, and its `quote` action costs nothing and spends no credits. `ask` puts a question to fifty heads or to your own audience, uploads an image, or builds a link someone presses to answer. `results` pulls the answers back, while `organization`, `audit`, `questions`, `projects`, `webhooks` and `help` cover the rest. Permissions follow actions rather than tools: a grant missing the scope for one action gets `insufficient_scope` on that action alone, so a read-only connection cannot reach anything that writes.

You have two ways to connect. The hosted endpoint `https://mcp.50heads.com/mcp` speaks Streamable HTTP, asks you to sign in with OAuth in the browser and installs nothing, and the same sign-in sets the connection's daily spend cap. The local route `npx -y @50heads/mcp` is a stdio server for hosts that start a command; it wants Node 20 or newer plus an API key. Create the key on the Developers page of the dashboard — it begins with `fh_live_` and you get one look at it. Running `npx -y @50heads/mcp login` once skips the key and keeps the token in the macOS Keychain or the Linux Secret Service, falling back to a mode 600 file.

When both are present, `FIFTYHEADS_API_KEY` overrides the saved sign-in. Before spending anything, run `estimate` with `quote`: the check is free.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.50heads.com/mcp`
- Environment variables: `FIFTYHEADS_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.50heads.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env FIFTYHEADS_API_KEY=<FIFTYHEADS_API_KEY> --transport stdio 50heads -- npx -y @50heads/mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add 50heads --url https://mcp.50heads.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add 50heads --env FIFTYHEADS_API_KEY=<FIFTYHEADS_API_KEY> -- npx -y @50heads/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "50heads": {
            "url": "https://mcp.50heads.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "50heads": {
            "command": "npx",
            "args": [
                "-y",
                "@50heads/mcp"
            ],
            "env": {
                "FIFTYHEADS_API_KEY": "<FIFTYHEADS_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "50heads": {
            "type": "http",
            "url": "https://mcp.50heads.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "50heads": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@50heads/mcp"
            ],
            "env": {
                "FIFTYHEADS_API_KEY": "<FIFTYHEADS_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http 50heads https://mcp.50heads.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e FIFTYHEADS_API_KEY=<FIFTYHEADS_API_KEY> 50heads npx -y @50heads/mcp
```
Replace <…> with your own values

## When to use it
- test a name on fifty people before launch
- see what a question costs in credits
- read survey answers from inside the editor
- share a link a person answers with one tap
- limit a connection to read-only actions

## Example prompts
- Use 50heads to ask fifty people which of these two names sounds better
- Get a 50heads quote for a poll about the logo choice
- Pull the answers to my last 50heads question

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md