five peers

Developers · API & MCP

Your tools.
Explainable decisions.

The API lets your application submit facts and receive a comparison. MCP connects an assistant to Five Peers tools. Here is what works today and what still needs connecting.

Just want to try it? Open an example →

Three access paths, three scopes.

Numeric demo APIAvailable · no account
Facts, limits and comparison. Fictional data only, no saved dossiers or provider calls.
Workspace MCPAvailable · authentication required
Seven tools for your subjects. Browser approval for changes and deliberations.
Memory and TypeSafe deliberationAvailable · optional activation
Persistent notes, weekly review and five perspectives. Full simulation engine remains private.

Available · numeric demonstration

One call, verifiable rules.

A costs €12,000 and delivers in 21 days; B costs €9,800 and delivers in 35 days. The contract below explicitly sets a 28-day limit and prioritises cost. Only A remains eligible; B misses the deadline by 7 days.

  1. Download the complete fictional contract, with no key or account identifier.
  2. Run the command from your download folder.
  3. Inspect the returned facts, constraints and differences. The decision stays human.
Download the JSON contract
curl --fail-with-body https://fivepeers.com/decision-demo/api/simple-compare \
  -H 'Content-Type: application/json' \
  --data-binary @fivepeers-comparison.json
View the complete JSON contract
{
  "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"
}

What you can check in the response

Response excerpt: A is eligible, B is ruled out. This route calculates neither a weighted score nor AI probabilities.

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

The complete options rows include sourced cells and the status of each constraint; contrasts holds the differences. Schema weights are not used for ranking on this route: only the explicit priority counts.

Starting from a text brief

POST /decision-demo/api/intake accepts question and context, then returns state and limit_review. A detected deadline is a suggestion: your interface must ask for confirmation and add the constraint to the dossier before calling simple-compare. The API does not replace that human confirmation.

This demo API accepts only numbers and fictional data. It does not save dossiers or manage accounts, and rejects qualitative criteria. No TypeSafe token is needed. It is not yet a business integration API with a service guarantee.

Available · authenticated personal workspace

Your subjects, from your assistant.

MCP HTTP connector:

https://fivepeers.com/api/mcp
  1. Open your workspace with LinkedIn (French interface).
  2. In Connections, grant read, capture and proposal permissions separately for work and personal subjects.
  3. Add the connector in your MCP client using existing OAuth or a revocable personal key from Connections.

Seven tools: capture_note, list_focus, list_decisions, list_waiting_due, update_item, review_week, deliberate_decision.

Three conversation starters are available through prompts/list: start_fivepeers, review_my_week and prepare_my_decision. prompts/get requires a scope argument (pro or perso) and its read permission. Open setup and my first conversation starter →

Every call specifies scope: "pro" or "perso". Captures are stored as notes for review. Changes and deliberations return a review_url for approval in your browser. Reuse the same request_id after a network interruption.

TypeSafe is optional in Settings: reviewed classification and five perspectives for an open decision, without an automatic choice. Up to 20 assessments per account per day, subject to a global cap. These seven tools use no other provider.

Anonymous POST: 401. MCP GET: 405. Personal keys expire after 30 days and can be revoked immediately. Permissions are checked by the server on every call.

22 October 2026 migration: these seven tools replace the legacy board catalogue. Old tool names are no longer exposed at this address. Other legacy product workflows remain separate.

Separate scopes

Persistent memory. A separate numeric demo.

The workspace stores notes, actions, decisions, waiting items, projects, sources and reviews. Export and deletion are available in the browser. Waiting subjects stay out of focus until their review date or new information.

The full local fivepeers.decision/v3 dossier engine and simulation remain private. Workspace deliberation assesses explicitly described options against objective, resources, risk, reversibility and evidence. Estimates are not guarantees of success.

Calendar, Drive, CRM, accounting and HOLCO H-MEMORY synchronisation are not connected. Browser approval belongs to Five Peers; it is not an integration with the central H-VISA review surface.

Open my workspace →