Pour les assistants IA et les développeurs

Utilisez 50heads depuis un assistant IA.

Connectez 50heads à un assistant IA compatible pour qu’il pose une question à des personnes vérifiées et reçoive le résultat. Cela coûte dès 20 crédits la réponse. Cela passe par MCP, le standard qui permet à un assistant d’utiliser des outils externes, donc cela fonctionne avec Claude, Cursor, ChatGPT et tout hôte compatible 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

Où trouver 50heads

Chacune de ces options donne les mêmes outils à votre assistant IA. Utilisez celle qu’il prend en charge.

Serveur hébergé: https://mcp.50heads.com/mcp Disponible dès maintenant. Rien à installer : ajoutez l’adresse et connectez-vous.
Paquet npm: npx -y @50heads/mcp Disponible dès maintenant, pour les assistants qui lancent une commande locale. Nécessite Node 20 ou plus récent et une clé d’API.
Registre MCP officiel: com.50heads/mcp Disponible dès maintenant. Les assistants et les annuaires qui lisent le registre y trouveront 50heads.
Annuaires: Bientôt dans les annuaires de Claude, ChatGPT et Cursor, ainsi que sur Smithery, Glama, PulseMCP et mcp.so. En attendant, ajoutez vous-même le serveur hébergé.

Le parcours de base tient en trois étapes

L’estimation est gratuite et ne dépense rien. La demande réserve les crédits. Pour les résultats, 50heads gère l’attente : votre assistant fait un seul appel au lieu de revérifier sans cesse.

> estimate({ action: "quote", question: { type: "single_choice", text: "Which menu would you order from tonight?",
             options: [{ label: "Menu A" }, { label: "Menu B" }], n: 50, tier: 1 } })
  20 credits × 50 = 1000 credits

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

> results({ action: "get", question_id: "q_8k2f" })   # or action "wait" on older hosts
  complete · winner "Menu B" · margin 36 points · confidence high

Demander un go ou un no go

Fixez un seuil sur une question fermée, par exemple Oui au-dessus de 60 %. Vous obtenez un verdict avec une fourchette : go, no go ou incertain. Le seuil ne coûte rien de plus.

Outils disponibles

estimate: Prix, délai et validation d’une question. Ne dépense jamais rien.
ask: Publie une question. Nécessite une clé d’idempotence : réessayer avec la même clé ne peut créer ni une deuxième question ni un deuxième débit.
results: Les résultats à l’instant, les réponses une à une, des fichiers et vos questions récentes, pour réutiliser un résultat avant de redemander. Peut attendre les réponses de notre côté.
questions: Arrête une question en cours et rembourse les réponses non données, ajoute des réponses, signale une mauvaise réponse ou range une question.
projects: Des projets et des étiquettes pour retrouver facilement vos questions.
webhooks: Les points de terminaison webhook, leurs envois et les derniers événements, pour qu’un script n’ait pas à revérifier sans cesse.
organization: Lecture seule : l’organisation, ses domaines, SCIM, les comptes de service et les connexions Slack et Zapier.
audit: Lecture seule : le journal d’audit de l’organisation, en liste ou en export.
help: Cherche dans le centre d’aide et envoie un retour au support.

Contrôles pour un usage sans surveillance

Chaque connexion a un plafond de dépense quotidien, 5 000 crédits sauf si vous le changez. Le serveur refuse toute demande qui le dépasserait.
Une demande nécessite une clé d’idempotence. Réessayer avec la même clé ne peut créer ni une deuxième question ni un deuxième débit.
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.

Vos données ne servent pas à entraîner l’IA

Nous n’utilisons ni vos questions, ni les réponses que vous achetez, ni les raisons écrites par les heads pour entraîner des modèles d’IA, et nous ne les vendons pas. L’IA et vos données

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"

Utiliser 50heads depuis Zapier

Sans code. Dans Zapier, vous pouvez poser une question, ajouter des heads, annuler et obtenir les résultats avec le verdict go ou no go. Les Zaps peuvent aussi démarrer quand une question se termine. Zapier se connecte en OAuth comme n’importe quelle app, avec les mêmes scopes et le même plafond quotidien.

Zapier dans la documentation développeurs

Laissez votre assistant IA interroger des personnes vérifiées.

Documentation API Installer le MCP Webhooks