Untuk agen dan developer

Penilaian manusia, cukup satu panggilan tool.

Agen Anda bisa bertanya kepada lima puluh orang terverifikasi dan mendapat sebaran dalam sekitar sepuluh menit, mulai 15,2¢ per jawaban. Server MCP 50heads bekerja dengan Claude, Cursor, ChatGPT, dan apa pun yang mendukung MCP.

Tambahkan ke host Anda

Claude

Di Claude, buka Settings, lalu Connectors, dan tambahkan konektor khusus dengan URL ini. Anda akan masuk dan menetapkan batas pengeluaran harian.

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

Claude Code

Jalankan ini di terminal. Claude Code membuka browser agar Anda masuk dan menetapkan batas pengeluaran harian.

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

Cursor

Tambahkan ini ke ~/.cursor/mcp.json, lalu masuk saat Cursor meminta.

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

ChatGPT

Di ChatGPT, buka Settings, lalu Apps and connectors, lalu Advanced settings, dan aktifkan Developer mode. Pilih Create, tempel URL ini, lalu pilih OAuth.

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

VS Code

Tambahkan ini ke .vscode/mcp.json di workspace Anda, atau jalankan MCP: Add Server. VS Code membuka halaman masuk.

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

Windsurf

Tambahkan ini ke ~/.codeium/windsurf/mcp_config.json, dengan kunci API dari portal.

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

Lainnya (npx)

Untuk host yang menjalankan perintah lokal. Perlu Node 20 atau lebih baru dan kunci API dari portal.

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

Tiga panggilan

Perkiraan gratis dan tidak pernah memakai kredit. Bertanya mencadangkan kredit. Menunggu dilakukan di sisi kami, jadi agen Anda cukup sekali memanggil, tanpa terus mengecek.

> estimate({ type: "single_choice", text: "Which menu would you order from tonight?",
             options: [{ label: "Menu A" }, { label: "Menu B" }], n: 50, tier: 1 })
  12 credits × 50 = US$7,62 · 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

Tool

estimate
Harga, waktu, dan validasi pertanyaan. Tidak pernah memakai kredit.
ask
Mengirim pertanyaan. Butuh kunci idempotensi, jadi percobaan ulang tidak pernah menjadi pertanyaan kedua.
get_results
Hasil sejauh ini, tanpa menunggu.
wait_for_results
Menunggu di sisi kami sampai pertanyaan terjawab.
list_questions
Pertanyaan terbaru, agar agen bisa memakai ulang hasil sebelum bertanya lagi.
cancel
Menghentikan pertanyaan yang berjalan dan mengembalikan jawaban yang belum masuk.
templates
Templat pertanyaan dengan harga tetap.
balance
Kredit, dan sisa batas harian koneksi.

Aman dibiarkan berjalan

  • Setiap koneksi punya batas pengeluaran harian, US$63,5 kecuali Anda mengubahnya. Agen tidak bisa melewatinya.
  • Bertanya butuh kunci idempotensi. Kunci yang sama mengembalikan pertanyaan yang sama.
  • Pertanyaan melewati aturan konten yang sama dengan milik semua orang. Pertanyaan yang ditolak tidak dikenai biaya.
  • Hasil tidak pernah mengungkap identitas head.

Atau panggil API

Semua yang dilakukan server MCP adalah panggilan HTTPS biasa. Kunci diawali fh_live_ dan hanya ditampilkan sekali.

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"

Penilaian manusia, cukup satu panggilan tool.