Para sa agents at developers

Opinyon ng tao, isang tool call lang ang layo.

Puwedeng magtanong ang agent mo sa limampung verified na tao at makakuha ng hatian sa loob ng mga sampung minuto, mula 15.2¢ bawat sagot. Gumagana ang 50heads MCP server sa Claude, Cursor, ChatGPT at anumang nakakaintindi ng MCP.

Idagdag sa host mo

Claude

Sa Claude, buksan ang Settings, tapos Connectors, at magdagdag ng custom connector gamit ang URL na ito. Magsa-sign in ka at magtatakda ng daily spend cap.

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

Claude Code

Patakbuhin ito sa terminal. Magbubukas ang Claude Code ng browser para mag-sign in ka at magtakda ng daily spend cap.

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

Cursor

Idagdag ito sa ~/.cursor/mcp.json, tapos mag-sign in kapag hiningi ng Cursor.

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

ChatGPT

Sa ChatGPT, buksan ang Settings, tapos Apps and connectors, tapos Advanced settings, at i-on ang Developer mode. Piliin ang Create, i-paste ang URL na ito at piliin ang OAuth.

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

VS Code

Idagdag ito sa .vscode/mcp.json sa workspace mo, o patakbuhin ang MCP: Add Server. Bubuksan ng VS Code ang sign-in page.

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

Windsurf

Idagdag ito sa ~/.codeium/windsurf/mcp_config.json, kasama ang API key mula sa portal.

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

Iba pa (npx)

Para sa mga host na nagpapatakbo ng lokal na command. Kailangan ng Node 20 o mas bago at API key mula sa portal.

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

Tatlong call

Libre ang estimate at hindi kailanman gumagastos. Nire-reserve ng ask ang credits. Sa panig namin ang paghihintay, kaya isang call lang ang gagawin ng agent mo sa halip na paulit-ulit na tumingin.

> 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

Mga tool

estimate
Presyo, oras at validation ng tanong. Hindi kailanman gumagastos.
ask
Nagpo-post ng tanong. Kailangan ng idempotency key, kaya hindi kailanman magiging pangalawang tanong ang pag-retry.
get_results
Ang resulta sa ngayon, nang walang hintayan.
wait_for_results
Naghihintay sa panig namin hanggang masagot ang tanong.
list_questions
Mga kamakailang tanong, para magamit ulit ng agent ang resulta bago magtanong ulit.
cancel
Pinapahinto ang live na tanong at nire-refund ang mga sagot na hindi naibigay.
templates
Mga template ng tanong na fixed ang presyo.
balance
Credits, at kung magkano pa ang natitira sa daily cap ng koneksyon.

Ligtas iwanang tumatakbo

  • May daily spend cap ang bawat koneksyon, $63.5 maliban kung palitan mo. Hindi ito malalampasan ng agent.
  • Kailangan ng idempotency key ang ask. Parehong key, parehong tanong.
  • Dumadaan ang mga tanong sa parehong content rules ng lahat. Walang bayad ang tanong na tinanggihan.
  • Hindi kailanman ipinapakilala ng resulta ang isang head.

O tawagan ang API

Lahat ng ginagawa ng MCP server ay simpleng HTTPS call. Nagsisimula ang keys sa fh_live_ at isang beses lang ipinapakita.

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"

Opinyon ng tao, isang tool call lang ang layo.