five peers

Développeurs · API & MCP

Vos outils.
Des décisions explicables.

L’API permet à votre application d’envoyer des faits et de récupérer une comparaison. MCP relie un assistant à des outils Five Peers. Voici ce qui fonctionne aujourd’hui et ce qui reste à raccorder.

Vous voulez simplement essayer ? Ouvrir un exemple →

Trois accès, trois périmètres.

API numérique de démonstrationDisponible · sans compte
Faits, limites et comparaison. Données fictives uniquement, aucun stockage de dossier ni appel fournisseur.
MCP du board historiqueDisponible · authentification requise
Connexion à votre compte existant. Ce connecteur n’expose pas encore le nouveau moteur de décision TypeSafe.
API complète et TypeSafePrivé · intégration à brancher
API locale et évaluations TypeSafe testées. Accès unifié depuis les comptes et outils MCP du nouveau moteur en préparation.

Disponible · démonstration numérique

Un appel, des règles vérifiables.

A coûte 12 000 € et livre en 21 jours ; B coûte 9 800 € et livre en 35 jours. Le contrat ci-dessous fixe explicitement une limite de 28 jours et donne la priorité au coût. A reste seul admissible ; B dépasse le délai de 7 jours.

  1. Téléchargez le contrat fictif complet, sans clé ni identifiant de compte.
  2. Exécutez la commande depuis le dossier du téléchargement.
  3. Inspectez les faits, contraintes et écarts renvoyés. La décision reste humaine.
Télécharger le contrat JSON
curl --fail-with-body https://fivepeers.com/decision-demo/api/simple-compare \
  -H 'Content-Type: application/json' \
  --data-binary @fivepeers-comparison.json
Voir le contrat JSON complet
{
  "state": {
    "schema": "fivepeers.decision/v3",
    "id": "fictional_quotes",
    "issue": "Quel devis choisir ?",
    "domain": "comparaison de données déclarées",
    "options": [
      {
        "id": "option_0",
        "label": "Devis A",
        "inputs": {
          "cost": "option_0_cost",
          "delay": "option_0_delay"
        }
      },
      {
        "id": "option_1",
        "label": "Devis B",
        "inputs": {
          "cost": "option_1_cost",
          "delay": "option_1_delay"
        }
      }
    ],
    "facts": {
      "option_0_cost": {
        "value": 12000.0,
        "kind": "declared",
        "unit": "EUR",
        "source": "Votre contexte · page 1, ligne 1",
        "observed_at": "2026-10-09"
      },
      "option_0_delay": {
        "value": 21.0,
        "kind": "declared",
        "unit": "jours",
        "source": "Votre contexte · page 1, ligne 1",
        "observed_at": "2026-10-09"
      },
      "option_1_cost": {
        "value": 9800.0,
        "kind": "declared",
        "unit": "EUR",
        "source": "Votre contexte · page 1, ligne 2",
        "observed_at": "2026-10-09"
      },
      "option_1_delay": {
        "value": 35.0,
        "kind": "declared",
        "unit": "jours",
        "source": "Votre contexte · page 1, ligne 2",
        "observed_at": "2026-10-09"
      }
    },
    "criteria": [
      {
        "id": "cost",
        "label": "Montant",
        "kind": "numeric",
        "unit": "EUR",
        "weight": 1,
        "best": 9800.0,
        "worst": 12000.0
      },
      {
        "id": "delay",
        "label": "Délai",
        "kind": "numeric",
        "unit": "jours",
        "weight": 1,
        "best": 21.0,
        "worst": 35.0
      }
    ],
    "constraints": [
      {
        "id": "delivery_limit",
        "criterion_id": "delay",
        "operator": "lte",
        "limit": 28
      }
    ],
    "priorities_confirmed": false,
    "review_date": "2026-11-08",
    "framing": {
      "objective": "Quel devis choisir ?",
      "context": "Devis A : 12 000 €, livraison 21 jours.\nDevis B : 9 800 €, livraison 35 jours."
    }
  },
  "priority": "cost"
}

Ce que la réponse permet de vérifier

Extrait de la réponse : A est admissible, B est écarté. Aucun score pondéré ni probabilité IA ne sont calculés par cette route.

{
  "status": "ready",
  "mode": "single_explicit_priority",
  "priority": "cost",
  "leading_options": ["option_0"],
  "weighted_score_used": false
}

Les lignes complètes options contiennent les cellules sourcées et le statut de chaque contrainte ; contrasts porte les écarts. Les champs de poids du schéma ne servent pas au classement de cette route : seule la priorité explicite compte.

Partir d’une saisie libre

POST /decision-demo/api/intake accepte question et context, puis renvoie state et limit_review. Un délai détecté est une proposition : votre interface doit le faire confirmer puis ajouter la contrainte au dossier avant d’appeler simple-compare. L’API ne remplace pas cette confirmation humaine.

Cette API de démonstration est limitée aux chiffres et aux données fictives. Elle ne conserve pas les dossiers, ne gère pas vos comptes et refuse les critères qualitatifs. Aucun jeton TypeSafe n’est requis. Ce n’est pas encore une API d’intégration métier avec garantie de service.

Disponible · accès authentifié

Le MCP existant, avec son périmètre exact.

Adresse à renseigner dans un client compatible MCP HTTP et OAuth :

https://fivepeers.com/api/mcp
  1. Ajoutez cette adresse dans votre client MCP.
  2. Autorisez l’accès à votre compte Five Peers dans le navigateur.
  3. Demandez la liste des outils : elle dépend de l’état de votre board.

Le serveur expose start_board, answer_board_step, finalize_board et get_board. Quand un board est disponible, mon_board, mon_registre et run_decision_session s’ajoutent. Certains outils créent ou modifient des données ; lancer une séance peut appeler un fournisseur.

Ce MCP appartient au produit historique. Ses séances utilisent encore Anthropic, pas TypeSafe. Il ne faut pas le considérer comme un accès au nouveau moteur TypeSafe. Son raccordement reste à réaliser ; la démo publique n’utilise jamais ce connecteur.

La découverte OAuth est publique. Les appels MCP exigent une authentification personnelle : un POST sans authentification renvoie 401 ; un GET sur l’adresse MCP renvoie 405. Ne collez jamais une clé fournisseur dans une configuration de client.

Vérifié le 9 octobre 2026 : découverte et refus d’accès anonyme en ligne ; catalogue des outils contrôlé sur le code déployé. Aucune séance ni connexion à un compte réel lancée lors de cette recette.

Privé · raccordement en préparation

Le nouveau moteur ne passe pas encore par ce MCP.

L’API locale sait préparer, évaluer, simuler et enregistrer un dossier fivepeers.decision/v3, puis consigner le choix humain et sa revue. Les évaluations TypeSafe sont activées côté serveur uniquement dans les tests et flux privés autorisés.

Un score de préférence n’est pas une probabilité de réussite. Les probabilités TypeSafe expriment l’incertitude d’une évaluation ; elles ne constituent pas une garantie métier. Elles ne sont pas calculées dans l’essai public.

À raccorder avant un accès d’intégration

Les connecteurs agenda, Drive, CRM et comptabilité ne sont pas branchés. Aucun accès automatique à vos outils n’est demandé par la démo.

Revenir à la méthode →