50heads

com.50headsv2026.1006.1更新於 Oct 6, 2026

Ask fifty verified real people a five-second question and get the split back.

已驗證Streamable HTTP可網頁執行Business & CommerceData & Analytics

概覽

AI 產生的概覽

讓助理向五十位通過驗證的真實使用者提出一個簡短問題，並取回答案分布，同時提供估價與結果查詢工具。

功能
這台伺服器提供工具來為問題估價（estimate）、向五十人小組提問（ask），並在結果產生時讀取（get_results、wait_for_results、get_answers）。它也能列出過去的问题、取消問題並退還未回答部分的費用、追加人數、標記某個答案以供審核，以及把結果匯出為 CSV、PDF 或 PNG。輔助工具涵蓋範本、受眾、定向選項、餘額、圖片上傳、可分享的提問連結、說明搜尋與意見回饋。
適用情境
當你需要真實人群的快速意見或偏好資料，而不是模型的猜測時使用，例如在兩個名稱之間做選擇，或檢驗一句簡短說法是否被接受。它適合需要在對話中發起小型調查並讀回分布的助理。
執行需求
可以使用託管端點 並在瀏覽器中透過 OAuth 登入，也可以使用 npx 執行的本機 npm 套件，後者需要 Node 20 或更新版本。本機方式需要 FIFTYHEADS_API_KEY 中的 API 金鑰（金鑰以 fh_live_ 開頭）或執行一次登入指令；託管方式也可以改用 Authorization bearer 標頭。提問需要 50heads 帳號與點數。
安裝前請注意
提問會消耗點數：Tier 1 的 50 份回答約需 1000 點數，每個連線都有每日支出上限（預設 5,000 點數），由 OAuth 登入時設定。FIFTYHEADS_API_KEY 與 Authorization bearer 標頭是僅顯示一次的秘密，不要放進共用設定。多個工具會寫入或變更資料：ask、add_heads、cancel、upload_image、flag_answer 與 send_feedback 都會作用於你的帳號，問題文字與上傳的圖片會傳送給 50heads 及其受訪小組。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 50heads，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.50heads.com/mcp"
    }
  }
}

README

50heads MCP

Ask fifty verified real people a five-second question from Claude, ChatGPT, Cursor or your own agent, and get the split back. 50 answers at Tier 1: about 10 minutes and 1000 credits, priced in your account's currency.

There are two ways in, with the same tools:

  • Hosted (recommended): https://mcp.50heads.com/mcp. Streamable HTTP, sign in with OAuth in the browser. Nothing to install.
  • Local: npx -y @50heads/mcp, a stdio server for hosts that launch a command. Needs Node 20 or later and an API key (or a one-time login).

Install

Pick your host below. The hosted server needs nothing installed: add the URL and sign in with OAuth in the browser, which also sets the connection's daily spend cap. The local server (npx -y @50heads/mcp) needs Node 20 or later and an API key.

Make an API key, if you need one, on the Developers page of the dashboard: https://50heads.com/app/developers. Keys start fh_live_ and are shown once. Or run npx -y @50heads/mcp login once and leave the key out.

npx -y @50heads/mcp config [host] prints any of these. The same instructions are on https://50heads.com/en-us/docs/mcp.

Claude (claude.ai and Claude Desktop)

Hosted, sign in with OAuth. Settings, Connectors, Add custom connector. Paste the URL and sign in when asked. On Team and Enterprise plans an owner adds it for the organisation first.

text
https://mcp.50heads.com/mcp

Or with an API key, in claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude).

json
{  "mcpServers": {    "50heads": {      "command": "npx",      "args": [        "-y",        "@50heads/mcp"      ],      "env": {        "FIFTYHEADS_API_KEY": "fh_live_…"      }    }  }}

Claude Code

Hosted, sign in with OAuth. Run in a terminal, then /mcp in Claude Code to sign in.

sh
claude mcp add --transport http 50heads https://mcp.50heads.com/mcp

Or with an API key (CI and scripts):

sh
claude mcp add --transport http 50heads https://mcp.50heads.com/mcp --header "Authorization: Bearer fh_live_…"

Cursor

Hosted, sign in with OAuth. ~/.cursor/mcp.json (or .cursor/mcp.json in a project). Cursor opens the sign-in page.

json
{  "mcpServers": {    "50heads": {      "url": "https://mcp.50heads.com/mcp"    }  }}

Or with an API key:

json
{  "mcpServers": {    "50heads": {      "url": "https://mcp.50heads.com/mcp",      "headers": {        "Authorization": "Bearer fh_live_…"      }    }  }}

ChatGPT

Hosted, sign in with OAuth. Settings, Apps and Connectors, Advanced settings, turn on Developer mode, then Create. Paste the URL and choose OAuth. On Business and Enterprise plans an admin turns on Developer mode first.

text
https://mcp.50heads.com/mcp

VS Code

Hosted, sign in with OAuth. .vscode/mcp.json in the workspace, or MCP: Add Server from the command palette.

json
{  "servers": {    "50heads": {      "type": "http",      "url": "https://mcp.50heads.com/mcp"    }  }}

Or from a terminal:

sh
code --add-mcp '{"name":"50heads","type":"http","url":"https://mcp.50heads.com/mcp"}'

Windsurf

Local, with an API key. ~/.codeium/windsurf/mcp_config.json, or Windsurf Settings, Cascade, MCP servers, View raw config.

json
{  "mcpServers": {    "50heads": {      "command": "npx",      "args": [        "-y",        "@50heads/mcp"      ],      "env": {        "FIFTYHEADS_API_KEY": "fh_live_…"      }    }  }}

Or the hosted server with an API key:

json
{  "mcpServers": {    "50heads": {      "serverUrl": "https://mcp.50heads.com/mcp",      "headers": {        "Authorization": "Bearer fh_live_…"      }    }  }}

Any other host

Local, with an API key. Hosts that launch a local command. Needs Node 20 or later and an API key from the dashboard.

sh
FIFTYHEADS_API_KEY=fh_live_… npx -y @50heads/mcp

Hosts that speak Streamable HTTP: https://mcp.50heads.com/mcp with the header "Authorization: Bearer fh_live_…", or OAuth.

json
{  "mcpServers": {    "50heads": {      "url": "https://mcp.50heads.com/mcp",      "headers": {        "Authorization": "Bearer fh_live_…"      }    }  }}

Check it works

Ask your host to "use 50heads to estimate asking fifty people which of two names they prefer". estimate is free and never spends credits. In Claude Code, /mcp lists the server and its tools; elsewhere, look for 50heads in the host's tools or connectors list.

Signing in on the command line

sh
npx -y @50heads/mcp login     # opens the browser; the token goes in your keychainnpx -y @50heads/mcp statusnpx -y @50heads/mcp logout

login uses the OAuth device flow against https://auth.50heads.com. Tokens are kept in the macOS Keychain or the Secret Service on Linux, else in ~/.config/50heads/credentials.json (mode 600). An API key in FIFTYHEADS_API_KEY wins when both are present.

--proxy forwards stdio to the hosted server instead of running the tools locally.

VariableMeaning
FIFTYHEADS_API_KEYAPI key for CI and scripts
FIFTYHEADS_API_URLAPI base, default https://api.50heads.com
FIFTYHEADS_MCP_URLHosted endpoint for --proxy
FIFTYHEADS_AUTH_URLSign-in server for login
FIFTYHEADS_CREDENTIALS_STORE=fileKeep the sign-in in a file, not the keychain
FIFTYHEADS_DEBUG=1Log each call to stderr (never question text)

Tools

ToolScopeDoes
estimatequestions:writePrice, time and fixes for a question. Never spends. Call it first.
askquestions:writeAsks. Needs a fresh UUID as idempotency_key. Returns a task (or a question_id on older hosts).
get_resultsquestions:readResults so far, without waiting.
wait_for_resultsquestions:readOlder hosts only: waits up to 600 s on the server.
list_questionsquestions:readYour recent questions. Check before asking again.
cancelquestions:writeStops a question and refunds unanswered heads.
templatesnoneFixed-price templates. Works without signing in.
balanceaccount:readCredits, reserved credits and what is left under the connection's daily cap.
upload_imagequestions:writePuts an image into 50heads from base64 or an https link; returns an image_url for a question.
get_answersquestions:readIndividual answers a page at a time, filtered by option, tier, country, age band or keyword.
add_headsquestions:writeMore heads on the same question, merged into the same result. Needs an idempotency_key.
flag_answerquestions:writeReports one answer by its attestation_ref for review; upheld flags are refunded.
exportquestions:readThe results as a file: CSV, a one-page PDF report, or a PNG chart (square, wide or story).
build_ask_linknoneA portal link with the question filled in, for a person to check and ask. Spends nothing.
list_audiencesnoneInterest audiences you can ask instead of targeting, with prices by grade.
list_targetingnoneCountries, languages, pool bands and the tags you can target.
search_helpnoneSearches the help centre and returns articles with links.
send_feedbacknoneSends feedback or a problem to support as a ticket (signed out: add email).

Every connection has a daily spend cap (default 5,000 credits). Asking past it returns spend_cap_exceeded with what is left and when it resets.

Errors are JSON-RPC errors with error.data.code (validation, not_found, insufficient_credits, spend_cap_exceeded, idempotency_conflict, content_refused, rate_limited, unavailable) and a retryable hint.

Resources: 50heads://guide (the skill), 50heads://templates, 50heads://question-types, 50heads://pricing, 50heads://countries, 50heads://results/{question_id}. Prompts: ask_the_heads, read_results. Hosts that show MCP Apps get the estimate and the results as cards.

The Agent Skill

The package ships the 50heads Agent Skill in skills/50heads (@50heads/mcp/skills/50heads/SKILL.md): when to ask, the eight rules for a good question, how to read results, and references for question types and pricing. Copy the folder into your host's skills directory, or let a host that speaks the com.50heads/skills extension fetch it from the server.

As a library

ts
import { serveStdio } from "@modelcontextprotocol/server/stdio";import { serverFactory } from "@50heads/mcp";
serveStdio(serverFactory({ apiKey: process.env.FIFTYHEADS_API_KEY }));

serveStdioServer(options) runs the whole stdio server, tasks included. configSnippets() returns the install snippets above.

Versions

Releases use calendar versions, YYYY.MDD.N: 2026.924.1 is the first release on 24 September 2026, and a second that day is 2026.924.2. The npm package, the hosted server (serverInfo.version), the registry manifest, --version and the Agent Skill all carry the same number. See CHANGELOG.md.

server.json is ready for the official MCP Registry as com.50heads/mcp. The registry has no listing yet (a search returns no servers). Publishing it needs MCP_REGISTRY_ED25519_KEY on the release workflow. See docs/publishing.md. The npm package itself is published.

Development

This package lives in the 50heads monorepo. The hosted server (apps/mcp) and the stdio server share one module, src/server.ts, so they cannot drift.

sh
pnpm --filter @50heads/mcp generate   # skill module, skill references, server.json, README install sectionpnpm --filter @50heads/mcp testpnpm --filter @50heads/mcp build      # dist/cli.js, dist/index.js, types, skills/ and skills/50heads.zip

Releasing (npm with provenance from the public mirror, the MCP Registry and a GitHub Release) is described in docs/publishing.md.

MIT licence.

來源：README.md，提交 7f8ae79

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v2026.1006.1最新Oct 6, 2026