एजेंट्स और डेवलपर्स के लिए

इंसानी राय, बस एक टूल कॉल दूर।

आपका एजेंट पचास वेरिफ़ाइड लोगों से पूछ सकता है और लगभग दस मिनट में बँटवारा पा सकता है, 15.2¢ प्रति जवाब से। 50heads MCP सर्वर Claude, Cursor, ChatGPT और MCP बोलने वाली किसी भी चीज़ के साथ काम करता है।

अपने होस्ट में जोड़ें

Claude

Claude में Settings, फिर Connectors खोलें और इस URL के साथ एक कस्टम कनेक्टर जोड़ें। आप साइन इन करके रोज़ की ख़र्च सीमा तय करेंगे।

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

Claude Code

इसे टर्मिनल में चलाएँ। Claude Code ब्राउज़र खोलता है जहाँ आप साइन इन करके रोज़ की ख़र्च सीमा तय करते हैं।

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

Cursor

इसे ~/.cursor/mcp.json में जोड़ें, फिर Cursor के कहने पर साइन इन करें।

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

ChatGPT

ChatGPT में Settings, फिर Apps and connectors, फिर Advanced settings खोलें और Developer mode चालू करें। Create चुनें, यह URL डालें और OAuth चुनें।

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

VS Code

इसे अपने वर्कस्पेस की .vscode/mcp.json में जोड़ें, या MCP: Add Server चलाएँ। VS Code साइन-इन पेज खोलता है।

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

Windsurf

इसे पोर्टल की API की के साथ ~/.codeium/windsurf/mcp_config.json में जोड़ें।

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

अन्य (npx)

उन होस्ट के लिए जो लोकल कमांड चलाते हैं। Node 20 या नया और पोर्टल की API की चाहिए।

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

तीन कॉल

अनुमान मुफ़्त है और कभी ख़र्च नहीं करता। पूछने पर क्रेडिट आरक्षित होते हैं। इंतज़ार हमारी तरफ़ होता है, इसलिए आपका एजेंट बार-बार जाँचने के बजाय एक कॉल करता है।

> 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 = $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

टूल

estimate: सवाल की क़ीमत, समय और जाँच। कभी ख़र्च नहीं करता।
ask: सवाल पोस्ट करता है। इसे idempotency key चाहिए, ताकि दोबारा कोशिश कभी दूसरा सवाल न बने।
get_results: अब तक के नतीजे, बिना इंतज़ार।
wait_for_results: सवाल का जवाब आने तक हमारी तरफ़ इंतज़ार करता है।
list_questions: हाल के सवाल, ताकि एजेंट दोबारा पूछने से पहले पुराना नतीजा इस्तेमाल कर सके।
cancel: लाइव सवाल रोकता है और न दिए गए जवाबों का रिफ़ंड देता है।
templates: तय क़ीमत वाले सवालों के टेम्पलेट।
balance: क्रेडिट, और कनेक्शन की रोज़ की सीमा में कितना बाक़ी है।

चालू छोड़ने के लिए सुरक्षित

हर कनेक्शन की रोज़ की ख़र्च सीमा होती है, $63.5, जब तक आप उसे न बदलें। एजेंट उससे ज़्यादा ख़र्च नहीं कर सकता।
पूछने के लिए idempotency key चाहिए। वही key वही सवाल लौटाती है।
सवालों पर वही कंटेंट नियम लागू होते हैं जो बाक़ी सब पर। ख़ारिज किए गए सवाल का कोई शुल्क नहीं।
नतीजे कभी किसी हेड की पहचान नहीं बताते।

या API कॉल करें

MCP सर्वर जो कुछ करता है, वह एक सामान्य HTTPS कॉल है। Keys fh_live_ से शुरू होती हैं और सिर्फ़ एक बार दिखाई जाती हैं।

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"

इंसानी राय, बस एक टूल कॉल दूर।

API दस्तावेज़MCP सेटअप वेबहुक