Skip to main content
Glama

retraite_optimisation

Read-onlyIdempotent

Optimisation de fin de carrière (menu classé des leviers) — À partir d'une situation (âge, trimestres, SAM, statut, enfants…), renvoie le MENU CLASSÉ des leviers d'optimisation retraite avec gain/ROI/confiance/sources : rachat de trimestres (2 options), surcote parentale, retraite progressive, âge de départ optimal, cumul emploi-retraite, optimisation du SAM, PER fin de carrière. PAS de total sommé (les leviers ne s'additionnent pas naïvement) — chaque levier chiffré séparément, classé par pertinence. Chaque montant porte sa confiance et sa source (Legifrance/BOFiP/service-public). (sources: CSS art. L351-14-1 (rachat), L351-1-2-1 (surcote parentale), L161-22-1-5 (retraite progressive), L161-22 (cumul) ; Circulaire CNAV 2026-04 (barème VPLR) ; Service-Public F15675/F16336/F12842/F13243 ; retraite_engine.js (leviers golden-testés, exemples officiels))

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": {
      "age": "<age>"
    },
    "name": "retraite_optimisation"
  }
}

Input Schema

NameRequiredDescriptionDefault
ageYesÂge actuel (ans).
rfrNoRFR — active le net (prélèvements sociaux).
samNoSalaire annuel moyen (25 meilleures années) — active les gains chiffrés.
tmiNoTMI en FRACTION 0-1 (ex. 0,30 pour 30 %) — chiffre l'économie d'IR du rachat / PER. ⚠️ l'outil "tmi" RENVOIE un pourcentage (30) ; ici on attend la fraction (0,30).
partsNo
statutNoStatut (insensible à la casse/accents). Reconnus : "salarié" (défaut), "fonctionnaire", "profession libérale" / "TNS" / "indépendant".
teaserNoAperçu gratuit, sans paiement : true renvoie le chiffre de tête avec sa confiance et ses sources (free preview, no payment).
zrr_qpvNoCumul plafonné d'un indépendant (artisan, commerçant) : activité en ZRR ou QPV → seuil porté au PASS (ZRR : renvoi au CGI 1465 A, zonage à confirmer depuis la LF 2024).
age_legalNoÂge légal de départ (défaut 64).
age_departNoÂge de départ envisagé (défaut : âge légal). Avec date_naissance, fixe la date d'effet : 1re pension de base à partir du 01/01/2027 → règles de cumul 2027 (LFSS 2026 art. 102 XI).
nb_enfantsNoNombre d'enfants — active surcote parentale (MDA) + majoration ≥3.
mda_parentaleNo≥1 trimestre de majoration de durée d'assurance pour enfant.
date_naissanceNoDate de naissance (YYYY-MM-DD) — recale le gel LFSS 2026 et la fenêtre surcote parentale.
n_annees_cumulNoCumul emploi-retraite : années d'activité après le départ.
trim_manquantsNoTrimestres manquants pour le taux plein — active le levier rachat.
quotite_travailNoRetraite progressive : quotité de temps partiel (0-1).
regime_activiteNoCumul emploi-retraite plafonné (pension d'avant 2027) : régime de l'activité reprise. salarie (défaut) = pensions + revenus ≤ max(dernier salaire, 160 % SMIC) ; liberal (CNAVPL) = revenus nets libéraux ≤ PASS ; independant (artisan, commerçant) = revenus professionnels ≤ ½ PASS (PASS en ZRR/QPV). Pour liberal/independant, revenu_activite_annuel = revenu professionnel net.
salaires_annuelsNoOptionnel : carrière année par année pour l'optimisation du SAM.
trimestres_acquisNo
trimestres_requisNo
micro_entrepreneurNoCumul emploi-retraite, règles 2027 : activité reprise en micro-entreprise → revenu_activite_annuel = chiffre d'affaires ou recettes, sans abattement (D.161-2-11 → L.613-7 II). Sinon, pour un indépendant, revenu_activite_annuel = bénéfice, et l'abattement de 26 % (L.136-3 III) est appliqué.
pension_brute_annuelleNoPension de base brute annuelle — active les gains nets.
revenu_activite_annuelNoCumul emploi-retraite : revenu d'activité brut annuel après la retraite — chiffre la réduction de pension (règles 2027 : 50 % au-delà de 7 000 €/an de l'âge légal à 67 ans) et la seconde pension.
pension_complementaire_annuelleNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedInput schema / properties / teaser
      Added value: +{
      +  "default": false,
      +  "description": "Aperçu gratuit, sans paiement : true renvoie le chiffre de tête avec sa confiance et ses sources (free preview, no payment).",
      +  "type": "boolean"
      +}
  2. Changed1 schema field changed
    • addedInput schema / properties / micro_entrepreneur
      Added value: +{
      +  "description": "Cumul emploi-retraite, règles 2027 : activité reprise en micro-entreprise → revenu_activite_annuel = chiffre d'affaires ou recettes, sans abattement (D.161-2-11 → L.613-7 II). Sinon, pour un indépendant, revenu_activite_annuel = bénéfice, et l'abattement de 26 % (L.136-3 III) est appliqué.",
      +  "type": "boolean"
      +}
  3. Changed2 schema fields changed
    • addedInput schema / properties / regime_activite
      Added value: +{
      +  "description": "Cumul emploi-retraite plafonné (pension d'avant 2027) : régime de l'activité reprise. salarie (défaut) = pensions + revenus ≤ max(dernier salaire, 160 % SMIC) ; liberal (CNAVPL) = revenus nets libéraux ≤ PASS ; independant (artisan, commerçant) = revenus professionnels ≤ ½ PASS (PASS en ZRR/QPV). Pour liberal/independant, revenu_activite_annuel = revenu professionnel net.",
      +  "enum": [
      +    "salarie",
      +    "liberal",
      +    "independant"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / properties / zrr_qpv
      Added value: +{
      +  "description": "Cumul plafonné d'un indépendant (artisan, commerçant) : activité en ZRR ou QPV → seuil porté au PASS (ZRR : renvoi au CGI 1465 A, zonage à confirmer depuis la LF 2024).",
      +  "type": "boolean"
      +}
  4. Changed3 schema fields changed
    • addedInput schema / properties / age_depart
      Added value: +{
      +  "description": "Âge de départ envisagé (défaut : âge légal). Avec date_naissance, fixe la date d'effet : 1re pension de base à partir du 01/01/2027 → règles de cumul 2027 (LFSS 2026 art. 102 XI).",
      +  "minimum": 50,
      +  "type": "number"
      +}
    • addedInput schema / properties / n_annees_cumul
      Added value: +{
      +  "description": "Cumul emploi-retraite : années d'activité après le départ.",
      +  "minimum": 0,
      +  "type": "number"
      +}
    • addedInput schema / properties / revenu_activite_annuel
      Added value: +{
      +  "description": "Cumul emploi-retraite : revenu d'activité brut annuel après la retraite — chiffre la réduction de pension (règles 2027 : 50 % au-delà de 7 000 €/an de l'âge légal à 67 ans) et la seconde pension.",
      +  "minimum": 0,
      +  "type": "number"
      +}
  5. First observed

TDQS

B3.4/5.0
Behavior3/5

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

Adds genuine context beyond the annotations: levers are not summed, each is chiffré and ranked separately, and every amount carries confidence and source with legal citations. That is useful disclosure for a read-only, idempotent tool. However it says nothing about the payment/teaser gating behavior, output breadth, or latency, which are the traits an agent would actually need to plan around.

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

Conciseness3/5

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

The core is front-loaded and the 'PAS de total sommé' caveat is well placed. But the trailing parenthetical is a dense block of statute numbers, circulaire references, and file names that adds audit weight without helping an agent decide or call the tool, and the rest of the sentence is overloaded with appositive clauses.

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?

For a 24-parameter, no-output-schema tool this is reasonably complete: the description conveys the return shape (ranked menu with gain/ROI/confiance/sources per lever), the no-summing rule, and the sourcing basis. It could go further on what happens with sparse inputs (e.g. when sam or rfr are absent) and on the teaser/payment split, but nothing essential is missing for correct invocation.

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 description coverage is 83%, so the schema already documents nearly every parameter in depth (including the TMI fraction warning and the ZRR/QPV rules). The description only recaps the parameter families ('âge, trimestres, SAM, statut, enfants…') without adding syntax, defaults, or dependency logic. Baseline 3 applies when the schema carries the load.

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: 'renvoie le MENU CLASSÉ des leviers d'optimisation retraite' and enumerates the levers (rachat, surcote parentale, retraite progressive, cumul, SAM, PER). This distinguishes it from single-lever siblings like retraite_rachat or retraite_surcote_parentale by framing it as an aggregated ranked menu, though the contrast is implicit rather than stated.

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

Usage Guidelines3/5

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

The 'À partir d'une situation (âge, trimestres, SAM, statut, enfants…)' framing implies when the tool is appropriate, and 'PAS de total sommé' hints at its comparative purpose. But there is no explicit statement of when to prefer this over the individual lever tools (retraite_rachat, retraite_progressive) that it subsumes, nor any exclusions or prerequisites.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.