Dla agentów i programistów

Ludzka ocena o jedno wywołanie narzędzia stąd.

Twój agent może zapytać pięćdziesięciu zweryfikowanych ludzi i dostać rozkład odpowiedzi po około dziesięciu minutach, od 0,21 € za odpowiedź. Serwer MCP 50heads działa z Claude, Cursor, ChatGPT i wszystkim, co obsługuje MCP.

Dodaj go do swojego hosta

Claude

W Claude otwórz Ustawienia, potem Łączniki, i dodaj własny łącznik z tym adresem URL. Zalogujesz się i ustawisz dzienny limit wydatków.

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

Claude Code

Uruchom to w terminalu. Claude Code otworzy przeglądarkę, żebyś się zalogował i ustawił dzienny limit wydatków.

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

Cursor

Dodaj to do ~/.cursor/mcp.json, a potem zaloguj się, gdy Cursor o to poprosi.

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

ChatGPT

W ChatGPT otwórz Ustawienia, potem Aplikacje i łączniki, potem Ustawienia zaawansowane, i włącz Tryb dewelopera. Wybierz Utwórz, wklej ten adres URL i wybierz OAuth.

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

VS Code

Dodaj to do .vscode/mcp.json w swoim obszarze roboczym albo uruchom MCP: Add Server. VS Code otworzy stronę logowania.

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

Windsurf

Dodaj to do ~/.codeium/windsurf/mcp_config.json, z kluczem API z portalu.

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

Inne (npx)

Dla hostów, które uruchamiają lokalne polecenie. Wymaga Node 20 lub nowszego i klucza API z portalu.

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

Trzy wywołania

Wycena jest bezpłatna i nigdy nic nie wydaje. Pytanie rezerwuje kredyty. Czekanie odbywa się po naszej stronie, więc twój agent wykonuje jedno wywołanie zamiast odpytywać.

> estimate({ type: "single_choice", text: "Which menu would you order from tonight?",
             options: [{ label: "Menu A" }, { label: "Menu B" }], n: 50, tier: 1 })
  18 credits × 50 = 900 credits · eta 10 min

> ask({ ...same question, idempotency_key: "4f9c…" })
  task q_8k2f · working · 0 of 50 answered

> get_results("q_8k2f")        # or wait_for_results on older hosts
  complete · winner "Menu B" · margin 36 points · confidence high

Narzędzia

estimate: Cena, czas i walidacja pytania. Nigdy nic nie wydaje.
ask: Publikuje pytanie. Wymaga klucza idempotencji, więc ponowna próba nigdy nie jest drugim pytaniem.
get_results: Dotychczasowe wyniki, bez czekania.
wait_for_results: Czeka po naszej stronie, aż pytanie dostanie odpowiedzi.
list_questions: Ostatnie pytania, żeby agent mógł użyć gotowego wyniku, zanim zapyta ponownie.
cancel: Zatrzymuje aktywne pytanie i zwraca kredyty za nieudzielone odpowiedzi.
templates: Szablony pytań o stałej cenie.
balance: Kredyty i to, co zostało w dziennym limicie połączenia.

Można zostawić bez nadzoru

Każde połączenie ma dzienny limit wydatków, 59 €, chyba że go zmienisz. Agent nie może go przekroczyć.
Pytanie wymaga klucza idempotencji. Ten sam klucz zwraca to samo pytanie.
Pytania podlegają tym samym zasadom treści co wszystkie inne. Odrzucone pytanie nic nie kosztuje.
Wyniki nigdy nie identyfikują heada.

Albo wywołaj API

Wszystko, co robi serwer MCP, to zwykłe wywołanie HTTPS. Klucze zaczynają się od fh_live_ i są pokazywane raz.

curl https://api.50heads.com/v1/billing/estimate \
  -H "Content-Type: application/json" \
  -d '{"draft":{"type":"single_choice","text":"Which menu would you order from tonight?",
       "options":[{"label":"Menu A"},{"label":"Menu B"}],"n":50,"tier":1}}'

curl https://api.50heads.com/v2/questions \
  -H "Authorization: Bearer $FIFTYHEADS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"draft":{"type":"single_choice","text":"Which menu would you order from tonight?",
       "options":[{"label":"Menu A"},{"label":"Menu B"}],"n":50,"tier":1,"language":"en"}}'

curl "https://api.50heads.com/v2/questions/q_8k2f/wait?seconds=25" \
  -H "Authorization: Bearer $FIFTYHEADS_API_KEY"