Marcel

Fiscalité d'une sortie de PEA

simulate_pea

Read-onlyIdempotent

Calcule la fiscalité d'une sortie de PEA (CGI art. 157) : clôture, rente, rachat partiel ou comparaison. Entrées : valeur actuelle, total des versements, ancienneté en années, objet du calcul, et éventuellement TMI, âges, rendement et montant du rachat. Sortie : impôt, prélèvements sociaux et net de sortie. Après 5 ans : exonération d'impôt sur le revenu, prélèvements sociaux au taux général du registre, distinct du taux de l'assurance-vie. En rente exonérée d'impôt, ces prélèvements portent sur la fraction d'âge de l'article 158, 6, et la rente nette est après prélèvements sociaux. Sans versementsTotal, les gains ne sont pas estimés.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "valeurPEA": "<valeurPEA>",
      "versementsTotal": "<versementsTotal>",
      "ancienneteAns": "<ancienneteAns>",
      "objetCalcul": "<objetCalcul>"
    },
    "name": "simulate_pea"
  }
}

Input Schema

Name	Required	Description
`tmi`	No	TMI du foyer en taux décimal (0.30 pour 30 %), lorsqu'elle est fournie.
`ageActuel`	No	Âge actuel. Entrée d'une projection ou d'une rente.
`valeurPEA`	Yes	Valeur actuelle du PEA.
`ageRetraite`	No	Âge de sortie. Absent, et sans rendement : calcul sur la valeur actuelle, sans projection.
`objetCalcul`	Yes
`ancienneteAns`	Yes	Ancienneté du plan en années. Le régime dépend du seuil de 5 ans.
`montantRachat`	No	Montant du retrait. Entrée lorsque objetCalcul vaut rachat_partiel.
`rendementAnnuel`	No	Rendement annuel fourni par l'appelant. Absent : aucune projection à ce taux.
`versementsTotal`	Yes	Total des versements sur le plan. Absent : les gains ne sont pas calculés.

Schema Changelog

Changes observed during successful MCP inspections.

Changed8 schema fields changedOct 21, 2026

changedInput schema / properties / ageActuel / description

Previous value: -"Âge actuel. Requis pour une projection ou une rente."New value: +"Âge actuel. Entrée d'une projection ou d'une rente."

changedInput schema / properties / ageRetraite / description

Previous value: -"Âge de sortie. Sans lui et sans rendement, aucune projection : calcul sur la valeur actuelle."New value: +"Âge de sortie. Absent, et sans rendement : calcul sur la valeur actuelle, sans projection."

changedInput schema / properties / ancienneteAns / description

Previous value: -"Ancienneté du plan en années. Requise : le régime dépend des 5 ans."New value: +"Ancienneté du plan en années. Le régime dépend du seuil de 5 ans."

changedInput schema / properties / montantRachat / description

Previous value: -"Montant du retrait, requis pour objetCalcul rachat_partiel."New value: +"Montant du retrait. Entrée lorsque objetCalcul vaut rachat_partiel."

changedInput schema / properties / rendementAnnuel / description

Previous value: -"Rendement annuel, seulement si la personne le donne. Ne jamais le supposer."New value: +"Rendement annuel fourni par l'appelant. Absent : aucune projection à ce taux."

changedInput schema / properties / tmi / description

Previous value: -"TMI du foyer en taux décimal (0.30 pour 30 %), seulement si la personne la donne"New value: +"TMI du foyer en taux décimal (0.30 pour 30 %), lorsqu'elle est fournie."

changedInput schema / properties / valeurPEA / description

Previous value: -"Valeur actuelle du PEA"New value: +"Valeur actuelle du PEA."

changedInput schema / properties / versementsTotal / description

Previous value: -"Total des versements sur le plan. Requis : sans lui, les gains ne sont pas calculables."New value: +"Total des versements sur le plan. Absent : les gains ne sont pas calculés."

First observedOct 21, 2026

TDQS

A3.9/5.0

Behavior4/5

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

Annotations already declare a safe, read-only, idempotent computation, so the bar is lower; the description still adds real domain behavior: the 5-year exoneration threshold, social levies at the general register rate (not the assurance-vie rate), the art. 158,6 age-fraction rule for exempt rentes, and degraded output when versementsTotal is absent. It also names what is returned (impôt, prélèvements sociaux, net de sortie), which matters since no output schema exists.

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 outputs, then the tax rules that genuinely affect interpretation. Dense but each sentence carries information; only the closing sentence on gains overlaps with what the schema already says about absent versementsTotal.

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

Completeness4/5

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

With 9 parameters, no output schema and four calculation branches, the description covers inputs, outputs, the legal rules governing each branch, and a fallback behavior. It is nearly sufficient; a brief note on validation/preconditions (e.g. versementsTotal requirement for comparison) would close the gap.

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 89%, so the schema already documents every parameter including units and conditional usage. The description only restates the parameter set in prose and confirms optionality of TMI, âges, rendement and montantRachat, adding no syntax or edge-case detail beyond the schema.

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

Purpose4/5

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

States a specific verb and resource (calculating PEA exit taxation under CGI art. 157) and enumerates the four calculation modes. It also distinguishes itself from the neighbouring assurance-vie rate, though it never names simulate_av/simulate_cto/simulate_per_sortie directly.

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

Usage Guidelines4/5

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

Makes the modes of use concrete (clôture, rente, rachat partiel, comparaison) and states conditional inputs: montantRachat for rachat_partiel, rendement for projections, and that missing versementsTotal means gains are not estimated. It gives context but no explicit 'use this instead of X' exclusion.

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.