Marcel

Marcel Patrimoine

optimiser_patrimoine

Read-onlyIdempotent

Marcel Patrimoine porte sur la transmission globale d'un patrimoine : donation, succession, démembrement et comparaison d'options, chiffrées à partir d'un même profil. Estimation indicative, pas un conseil en investissement. Entrées : âge et situation du foyer, enfants, plusieurs biens immobiliers avec leur crédit, titres de société, enveloppes d'épargne dont le PER, dettes, valeur à transmettre et donations antérieures. Chaque champ du profil est optionnel ; la réponse contient les scénarios chiffrés, les scénarios écartés, les sujets non couverts, les champs manquants et les avertissements. Elle porte un traceId, le même pour un même profil et une même version de règles, et sa rulesVersion. Pour un seul acte déjà choisi, voir simulate_donation, simulate_donation_partage, simulate_demembrement ou simulate_succession ; pour trois modes déjà fixés, compare_transmission.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "optimiser_patrimoine"
  }
}

Input Schema

Name	Required	Description
`foyer`	No	Foyer. Chaque champ est optionnel.
`dettes`	No	Dettes, dont le crédit Lombard adossé à l'assurance-vie.
`retraite`	No	Retraite. Chaque champ est optionnel.
`objectifs`	No	Buts du calcul. Au moins un objectif permet de chiffrer. Absents : une question est posée, sans montant.
`enveloppes`	No	Enveloppes détenues. Chaque champ est optionnel.
`horizonAns`	No	Horizon du chiffrage, en années. Seule la valeur 10 est acceptée. Absente : 10 ans.
`hypotheses`	No	Hypothèses explicites. Aucun taux n'est inventé.
`transmission`	No	Transmission. Chaque champ est optionnel.
`dateReference`	No	Date de référence des calculs, AAAA-MM-JJ. Absente : la date du jour n'est pas utilisée pour le rappel des donations.
`capaciteEpargneMensuelle`	No	Somme que le foyer peut mettre de côté chaque mois, en euros.

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 25, 2026

changedInput schema / properties / transmission / properties / valeurATransmettre / description

Previous value: -"Montant que le foyer peut donner, en euros, hors enveloppes bloquées ou nanties."New value: +"Montant que le foyer peut donner, en euros, hors enveloppes bloquées. La dette qui garantit un contrat est déjà déduite du patrimoine net."

Changed6 schema fields changedOct 25, 2026

addedInput schema / properties / enveloppes / properties / immobilier / items / properties / bienCommun

Added value: +{
+  "description": "true lorsque le bien est commun aux deux membres du couple.",
+  "type": "boolean"
+}

addedInput schema / properties / transmission / properties / ageUsufruitierConjoint

Added value: +{
+  "description": "Âge en années révolues du second donateur. Absent : l'âge du conjoint, sinon le même âge, signalé.",
+  "maximum": 120,
+  "minimum": 0,
+  "type": "integer"
+}

addedInput schema / properties / transmission / properties / bienCommun

Added value: +{
+  "description": "true lorsque le bien transmis est commun. Avec une situation couple, deux donateurs sont alors retenus.",
+  "type": "boolean"
+}

addedInput schema / properties / transmission / properties / donateurs

Added value: +{
+  "description": "Nombre de donateurs de la transmission. Absent : 1, sauf si la situation est couple et que le bien est indiqué comme commun.",
+  "enum": [
+    1,
+    2
+  ],
+  "type": "number"
+}

addedInput schema / properties / transmission / properties / donationsAnterieures / items / properties / beneficiaire

Added value: +{
+  "anyOf": [
+    {
+      "exclusiveMinimum": 0,
+      "type": "integer"
+    },
+    {
+      "const": "tous",
+      "type": "string"
+    }
+  ],
+  "description": "Bénéficiaire de la donation antérieure : index à partir de 1, ou tous. Absent : le premier, et l'hypothèse est indiquée."
+}

addedInput schema / properties / transmission / properties / donationsAnterieures / items / properties / donateur

Added value: +{
+  "description": "Donateur de la donation antérieure, 1 ou 2. Absent : le donateur 1 lorsque deux donateurs sont retenus.",
+  "enum": [
+    1,
+    2
+  ],
+  "type": "number"
+}

Changed1 schema field changedOct 25, 2026

changedInput schema / properties / horizonAns / description

Previous value: -"Horizon du classement, en années. Seule la valeur 10 est acceptée. Absente : 10 ans."New value: +"Horizon du chiffrage, en années. Seule la valeur 10 est acceptée. Absente : 10 ans."

AddedOct 25, 2026

TDQS

A4.6/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly/idempotent/non-destructive, and the description adds real behavioral context beyond them: the response includes retained scenarios, discarded scenarios, uncovered topics, missing fields and warnings, plus a traceId that is stable for the same profile and rules version, and a rulesVersion. It also sets expectations that this is an indicative estimate and not investment advice, and notes that absent goals yield a question rather than amounts.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with purpose, then inputs, then output contents, then sibling routing — a logical order with zero filler. It is dense and slightly long, with the input enumeration partially redundant against a fully documented schema, which keeps it from a 5.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 10-parameter, deeply nested, all-optional tool with no output schema, the description supplies what is missing: what comes back (scenarios, discarded scenarios, gaps, warnings), determinism/traceability (traceId, rulesVersion), the all-optional contract, and the escape hatches for simpler needs. An agent can call it correctly and interpret the result without further reading.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with per-field French descriptions, so the schema already carries parameter meaning. The description enumerates the input families (âge/situation, enfants, biens avec crédit, titres de société, enveloppes dont le PER, dettes, valeur à transmettre, donations antérieures) and reminds that every profile field is optional, but adds no format or interaction rules beyond the schema. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific scope: overall wealth transmission (donation, succession, démembrement, option comparison) valued from a single profile. It explicitly distinguishes itself from the single-act simulators and from compare_transmission, so an agent can place it among ~45 siblings without opening a schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It says when to use this tool (global multi-discipline transmission study from one profile) and when not to (a single already-chosen act → simulate_donation / simulate_donation_partage / simulate_demembrement / simulate_succession; three fixed modes → compare_transmission). Explicit alternatives with the selecting condition, nothing left to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Marcel tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.