50heads
Se connecterTélécharger l’app
Langue
Pour les agents et les développeurs

Un avis humain, à un appel d’outil.

Votre agent peut interroger cinquante personnes vérifiées et obtenir une répartition en environ dix minutes, dès 0,14 € la réponse. Le serveur MCP de 50heads fonctionne avec Claude, Cursor, ChatGPT et tout ce qui parle MCP.

Ajoutez-le à votre hôte

Claude

Dans Claude, ouvrez Paramètres, puis Connecteurs, et ajoutez un connecteur personnalisé avec cette URL. Vous vous connecterez et fixerez un plafond quotidien.

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

Claude Code

Lancez ceci dans un terminal. Claude Code ouvre un navigateur pour vous connecter et fixer un plafond de dépense quotidien.

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

Cursor

Ajoutez ceci à ~/.cursor/mcp.json, puis connectez-vous quand Cursor le demande.

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

ChatGPT

Dans ChatGPT, ouvrez Paramètres, puis Applications et connecteurs, puis Paramètres avancés, et activez le mode développeur. Choisissez Créer, collez cette URL et sélectionnez OAuth.

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

VS Code

Ajoutez ceci à .vscode/mcp.json dans votre espace de travail, ou lancez MCP: Add Server. VS Code ouvre la page de connexion.

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

Windsurf

Ajoutez ceci à ~/.codeium/windsurf/mcp_config.json, avec une clé d’API du portail.

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

Autres (npx)

Pour les hôtes qui lancent une commande locale. Nécessite Node 20 ou plus récent et une clé d’API du portail.

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

Trois appels

L’estimation est gratuite et ne dépense rien. La demande réserve les crédits. L’attente se fait de notre côté : votre agent fait un seul appel au lieu d’interroger en boucle.

> 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,08 € · 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

Outils

estimate
Prix, délai et validation d’une question. Ne dépense jamais rien.
ask
Publie une question. Nécessite une clé d’idempotence : une nouvelle tentative n’est jamais une deuxième question.
get_results
Les résultats à l’instant, sans attendre.
wait_for_results
Attend de notre côté que la question soit complète.
list_questions
Les questions récentes, pour réutiliser un résultat avant de redemander.
cancel
Arrête une question en cours et rembourse les réponses non données.
templates
Modèles de questions à prix fixe.
balance
Les crédits, et ce qui reste sous le plafond quotidien de la connexion.

Sûr à laisser tourner

  • Chaque connexion a un plafond de dépense quotidien, 59 € sauf si vous le changez. Un agent ne peut pas le dépasser.
  • Une demande nécessite une clé d’idempotence. La même clé renvoie la même question.
  • Les questions passent les mêmes règles de contenu que toutes les autres. Une question refusée ne coûte rien.
  • Les résultats n’identifient jamais un head.

Ou appelez l’API

Tout ce que fait le serveur MCP est un simple appel HTTPS. Les clés commencent par fh_live_ et ne s’affichent qu’une fois.

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"

Un avis humain, à un appel d’outil.

Documentation APIInstaller le MCPWebhooks