tax-retirement

fiscal_tmi

Read-onlyIdempotent

Taux marginal d'imposition (TMI) — Tranche marginale d'imposition du foyer au barème 2026, en tenant compte du plafonnement du quotient familial. Renvoie le taux en POINTS DE POURCENTAGE (unit PERCENT, ex. 30 = 30 %) — à distinguer de prelevements_sociaux qui renvoie une fraction (unit RATE, 0-1). Ne pas multiplier ce taux par un montant pour chiffrer une économie d'impôt (versement PER, déduction) : la TMI ignore le changement de tranche, la décote, la CEHR et la CDHR → fiscal_per_gain pour un versement PER ; fiscal_impot_revenu pour l'impôt dû. (sources: CGI art. 197 ; BOFiP BOI-IR-LIQ-20)

Input Schema

TableJSON Schema

Name	Required	Description	Default
`parts`	No	Nombre de parts de quotient familial.
`situation`	No	Situation familiale.	Célibataire
`parent_isole`	No	Parent isolé (case T, art. 194 II CGI) : célibataire ou divorcé vivant seul avec au moins un enfant à charge. La part du 1er enfant est alors plafonnée à 4 262 € (art. 197 I-2) au lieu de 2 × 1 807 €. Les parts transmises doivent déjà inclure la demi-part case T.
`demi_parts_195_abe`	No	Demi-parts de l'art. 195-1 a, b ou e CGI (personne vivant seule ayant élevé seule un enfant 5 ans, enfant décédé, enfant adopté) incluses dans les parts : plafonnées à 1 079 € chacune.
`residence_alternee`	No	Avec parent_isole : enfants UNIQUEMENT en résidence alternée — la demi-part de chacun des deux premiers enfants est plafonnée à 2 131 € (art. 197 I-2 CGI). Les parts transmises doivent inclure les majorations de 0,25 (art. 194 I).
`revenu_net_imposable`	Yes	Revenu net imposable du foyer (€).
`demi_parts_invalidite`	No	Demi-parts d'invalidité ou d'ancien combattant (art. 195-1 c, d, d bis, f et 195-2 à 6 CGI) incluses dans les parts : plafond de droit commun + réduction de 1 801 € chacune quand le plafonnement joue.

Schema Changelog

Changes observed during successful MCP inspections.

Changed4 schema fields changedSep 28, 2026

addedInput schema / properties / demi_parts_195_abe

Added value: +{
+  "default": 0,
+  "description": "Demi-parts de l'art. 195-1 a, b ou e CGI (personne vivant seule ayant élevé seule un enfant 5 ans, enfant décédé, enfant adopté) incluses dans les parts : plafonnées à 1 079 € chacune.",
+  "minimum": 0,
+  "type": "number"
+}

addedInput schema / properties / demi_parts_invalidite

Added value: +{
+  "default": 0,
+  "description": "Demi-parts d'invalidité ou d'ancien combattant (art. 195-1 c, d, d bis, f et 195-2 à 6 CGI) incluses dans les parts : plafond de droit commun + réduction de 1 801 € chacune quand le plafonnement joue.",
+  "minimum": 0,
+  "type": "number"
+}

addedInput schema / properties / parent_isole

Added value: +{
+  "default": false,
+  "description": "Parent isolé (case T, art. 194 II CGI) : célibataire ou divorcé vivant seul avec au moins un enfant à charge. La part du 1er enfant est alors plafonnée à 4 262 € (art. 197 I-2) au lieu de 2 × 1 807 €. Les parts transmises doivent déjà inclure la demi-part case T.",
+  "type": "boolean"
+}

addedInput schema / properties / residence_alternee

Added value: +{
+  "default": false,
+  "description": "Avec parent_isole : enfants UNIQUEMENT en résidence alternée — la demi-part de chacun des deux premiers enfants est plafonnée à 2 131 € (art. 197 I-2 CGI). Les parts transmises doivent inclure les majorations de 0,25 (art. 194 I).",
+  "type": "boolean"
+}

First observedSep 1, 2026

TDQS

A4.4/5.0

Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint and openWorldHint=false, so safety is covered. The description adds genuinely useful behavioral context beyond that: the output is in percentage points (unit PERCENT, e.g. 30 = 30%), it is a marginal rate only, and it explicitly enumerates what the value excludes (changement de tranche, décote, CEHR, CDHR).

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 the definition and unit before the misuse warning and source citation, so the agent gets the essential facts first. It is dense and fairly long, but every clause (unit contrast, misuse warning, cross-tool routing) carries information; only the inline legal sourcing is arguably expendable.

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?

No output schema exists, and the description still conveys the return value's unit and scale, along with its semantic limits and the sibling tools to use for adjacent questions. For a read-only rate calculator that is complete.

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 100%, so the schema already documents all seven parameters including the intricate plafonnement rules for parent_isole, demi_parts_195_abe and residence_alternee. The description adds no per-parameter meaning beyond that, which is the appropriate baseline when the schema does the heavy lifting.

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?

States a precise verb+resource (taux marginal d'imposition du foyer au barème 2026) with the computation basis (plafonnement du quotient familial). It distinguishes itself from fiscal_prelevements_sociaux by naming the sibling and the different unit it returns.

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?

Explicit when-to-use and when-NOT-to-use: the agent is told not to multiply this rate to size a tax saving (PER versement, déduction) because TMI ignores tranche change, décote, CEHR and CDHR, and is routed to fiscal_per_gain or fiscal_impot_revenu instead. That is a real anti-misuse instruction, not implied guidance.

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

All tax-retirement 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.

fiscal_tmi

Input Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources