Tax Retirement

io.github.herve-coulonPublished by GitHub account herve-coulonv0.1.2Updated Oct 24, 2026

Calcul fiscal (IR, IFI, PER, plus-value) et retraite français — 32 régimes, sourcé et daté.

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Remote MCP server for sourced, dated French income-tax, wealth-tax, pension and retirement calculations, billed per call in USDC.

What you can do
  • Compute household income tax, marginal rate, CEHR/CDHR, social levies, PER ceilings and savings, IFI, real-estate capital gains, rental regimes, inheritance duties and niche caps
  • Estimate retirement pensions by points-based or annuity-based scheme, consolidated multi-scheme pensions, gross-to-net conversion, trimester buybacks, phased retirement and a ranked optimisation menu
  • Project wealth scenarios: SCPI cash or credit, SCPI split ownership, equity vs credit, real return, Girardin, life annuity and private equity
  • Look up dated reference values with legal sources and check reference versions and freshness
  • List available capabilities, confidence levels and prices before choosing a tool
When to use it
Useful when an assistant must produce French tax or pension figures that depend on current 2026 rules and legal sources, such as advisory, fintech or wealth-management tooling, rather than relying on the model's own arithmetic.
Requirements
Remote Streamable HTTP endpoint; no account or API key to store. Paid calls settle per call in USDC on Base via x402, so an x402-capable client or wallet is needed. A named trial key can be requested for evaluation via the X-Qotien-Trial header.
Before you install
Most tools cost money per call ($0.05 to $1.00 in USDC on Base); only two discovery tools are free. Payment goes through a third-party facilitator. Inputs are abstract figures, but results are indicative and not personalised financial advice.

Installation

In SourceWeft

  1. Open Tax Retirement in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.herve-coulon%2Ftax-retirement/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "tax-retirement": {
      "type": "http",
      "url": "https://app.qotien.fr/api/fiscal/v1/mcp"
    }
  }
}

README

Qotien — French Tax & Retirement MCP

A sourced, dated calculation API for French personal taxation and retirement, exposed over MCP. Every response carries a confidence level, its legal sources, and the fiscal year — the engine never guesses a fact.

Hosted remote server, paid per call via x402 (USDC on Base). Capabilities that return a fact are billed from the first call; two discovery tools are free. No account, no API key to store, no personal data — inputs are abstract numbers (income, parts, pension points), never stored.

Connect

MCP endpoint (Streamable HTTP / JSON-RPC 2.0)https://app.qotien.fr/api/fiscal/v1/mcp
RESTPOST https://app.qotien.fr/api/fiscal/v1/calculate
Manifest (discovery, tools + pricing)GET https://app.qotien.fr/api/fiscal/v1/manifest
Registryio.github.herve-coulon/tax-retirement

Add it to any MCP client that supports a remote Streamable HTTP server, pointing at the endpoint above. Call qotien_capacites first (free) for the machine-readable catalog of tools, confidence levels, and prices.

Why call this instead of computing it yourself

A general LLM (or a code interpreter) can do arithmetic, but it does not reliably know the current, exact French rules — the 2026 income-tax brackets and décote thresholds, the value of an Agirc-Arrco or CARMF pension point, the reversion rate of each fund, which tax-reduction rates are in force this year. It will produce a confident, wrong number. Qotien is up to date, sourced, and re-verified against primary sources at every release — the value where a tax or pension error is unacceptable (fintech, insurtech, advisory tools, wealth-management software).

Two rules the engine never breaks:

  • A figure never travels alone — every fact comes with its fiscal year, its legal sources, and a confidence level.
  • A calculation, not a guess — when a rule or input is missing, the tool returns non_calculable (an honest refusal), never an invented number and never an "average" rate.

Tools — 4 domains, 38 tools

MCP tool names are prefixed by domain (fiscal_*, retraite_*, simulateurs_*, referentiel_*); the same capabilities are reachable over REST under their bare names (tmi, per_gain, …). Each tool's tier is shown as [protocole] (free) · [barème] · [étude] · [optimiseur] (see Pricing).

Fiscal (income tax & wealth) — deterministic, confiance: fiable

  • fiscal_impot_revenu [barème] — income tax (progressive brackets, family quotient, décote)
  • fiscal_tmi [barème] — marginal tax rate
  • fiscal_cehr [barème] — exceptional contribution on high incomes (optional rfr_n1 / rfr_n2 apply the exceptional-income smoothing of art. 223 sexies II-1)
  • fiscal_prelevements_sociaux [barème] — social-levy rate by income type (17.2 % vs 18.6 %)
  • fiscal_surtaxe_pv_immobiliere [barème] — real-estate capital-gains surtax
  • fiscal_per_plafond [barème] — PER deduction ceiling (N-1 PASS for employees, N for self-employed)
  • fiscal_plus_value_immobiliere [étude] — real-estate capital gain (holding-period abatements; acquisition_gratuite for inherited or gifted property: actual costs only, no 7.5 % flat allowance; quote_part + valeur_pleine_propriete apply the €15,000 exemption per co-owned or dismembered share in full ownership; terrain for land: no 15 % works allowance)
  • fiscal_ifi [étude] — real-estate wealth tax (main residence −30 %; optional 75 % income cap, art. 979, computed on gross income: dividends before the 40 % allowance, flat-tax income included)
  • fiscal_foncier_regime [étude] — unfurnished rental: micro-foncier vs actual-expense regime (household tax Δ)
  • fiscal_lmnp_regime [étude] — furnished rental (LMNP): micro-BIC vs actual regime with depreciation (household tax Δ)
  • fiscal_succession [étude] — inheritance duties per child (art. 777) and estimated saving of an early donation
  • fiscal_cdhr [étude] — differential contribution on high incomes (20 % floor + décote)
  • fiscal_per_gain [étude] — tax saved by a PER contribution: the total Δ (brackets + CEHR/CDHR), never "contribution × marginal rate"
  • fiscal_niches_plafond [étude] — tax-reduction cap (art. 200-0 A) on reductions, with the excluded items handled (donations: 20 % limit on the total, Coluche €2,000 bracket outside it; JEI/JEIR: subscription ceilings by situation, 40 % rate for impact companies via variante: "impact", shared €50,000 cap for 2024-2028 via jei_reductions_anterieures)
  • fiscal_flat_tax_vs_bareme [étude] — PFU vs progressive-scale comparison
  • fiscal_jeanbrun [étude] — Jeanbrun rental-investment depreciation (art. 31 I-1° i/j CGI); pass loyers_annuels, charges_annuelles, interets_annuels for the real saving (social levies only cut down to a zero net rental income, excess = global-income deficit capped at €10,700), otherwise a flagged theoretical maximum (hypothese_economie)

Retirement — variable confidence, never a bare figure

  • retraite_ps_pension [barème] (fiable) — pension gross→net (CSG/CRDS/CASA + 1 % health on the complementary part)
  • retraite_regimes [barème] (fiable) — discovery: the computable schemes (32 covered)
  • retraite_surcote_parentale [barème] (estime) — parental surcote (+1.25 %/qtr, max 5 %)
  • retraite_pension_regime [étude] (fiable) — pension of one points-based scheme, with a plausibility guard
  • retraite_pension_annuites [étude] (fiable) — pension of an annuity-based scheme (public sector, special schemes)
  • retraite_pension_totale [étude] (fiable) — consolidated multi-scheme pension (the full career statement in one call), gross→net
  • retraite_estimation [étude] (estime/partiel/non_calculable) — approximate pension from partial data, with a range
  • retraite_rachat [étude] (fiable) — trimester buyback (VPLR): cost, net-of-tax, gain, ROI
  • retraite_progressive [étude] (estime) — phased retirement (pension fraction + part-time)
  • retraite_optimisation [optimiseur] (estime) — ranked menu of end-of-career levers (buyback, parental surcote, phased retirement, optimal age, cumul, SAM, PER) with gain/ROI/confidence

Simulateurs (wealth projections) — confiance: estime

  • simulateurs_girardin [barème] · simulateurs_rente_viagere [barème]
  • simulateurs_scpi · simulateurs_scpi_credit · simulateurs_demembrement_scpi · simulateurs_apport_credit · simulateurs_rentabilite_reelle · simulateurs_private_equity — all [étude]

Référentiel (cite a dated fact) — confiance: sourcee

  • referentiel_valeur [barème] — one reference value, with its primary source, legal basis, and verification date
  • referentiel_recherche [barème] — search the reference by domain/keyword
  • referentiel_versions [protocole] — reference version + freshness (free)

Meta

  • qotien_capacites [protocole] — the catalog of tools, confidence levels, and prices (free; call this first)

Response contract

json
{  "ok": true,  "domaine": "retraite",  "capability": "pension_regime",  "confiance": "fiable",  "result": { "...": "..." },  "sources": ["references_officielles.json", "retraite_registre.js", "..."],  "millesime_fiscal": "2026",  "avertissement": "Deterministic indicative result — not personalized advice (CIF/DDA)."}
  • confiance: fiable (deterministic, golden-tested) · estime/partiel (approximation, with a range) · sourcee (dated reference fact) · non_calculable (honest refusal instead of a made-up number).
  • A pension or a tax figure is never returned bare — confidence and sources travel with it.

Pricing — x402

Settlement in USDC on Base (eip155:8453). Prices are per successful call; a call that fails validation is not billed (settlement happens only on delivery).

TierPriceTools
protocolefreereferentiel_versions, qotien_capacites
barème$0.05most fiscal_* rate/ceiling tools, retraite_ps_pension/regimes/surcote_parentale, referentiel_valeur/recherche, simulateurs_girardin/rente_viagere
étude$0.25studies: per_gain, ifi, cdhr, niches_plafond, retirement pensions, SCPI/PE simulators…
optimiseur$1.00retraite_optimisation

An unpaid call gets HTTP 402 (x402 v2) on REST and MCP. On MCP the body carries both the x402 accepts field and a JSON-RPC -32002 error; a client that cannot pay sees a transport error (the call did not run). No anonymous free tier — to evaluate before paying, request a named trial key (header X-Qotien-Trial, issued manually). A euro-denominated commercial licence exists for application use (classic invoicing) — [email protected].

Quick start

bash
# List tools (free)curl -s -X POST https://app.qotien.fr/api/fiscal/v1/mcp \  -H 'content-type: application/json' \  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
# Catalog + prices (free)curl -s -X POST https://app.qotien.fr/api/fiscal/v1/mcp \  -H 'content-type: application/json' \  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"qotien_capacites","arguments":{}}}'
# A paid call (étude, $0.25) returns HTTP 402 with x402 payment instructions until settled.curl -s -X POST https://app.qotien.fr/api/fiscal/v1/mcp \  -H 'content-type: application/json' \  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"retraite_pension_regime","arguments":{"code_regime":"agirc_arrco","points":750.07}}}'
# Same call with a named trial key (evaluation, no payment): add the X-Qotien-Trial header.curl -s -X POST https://app.qotien.fr/api/fiscal/v1/mcp \  -H 'content-type: application/json' -H 'X-Qotien-Trial: <your-trial-key>' \  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"retraite_pension_regime","arguments":{"code_regime":"agirc_arrco","points":750.07}}}'# → Agirc-Arrco, 750.07 points × €1.4386 (2026 service value) = €1,079/year gross (€90/month);#   confiance: fiable · sources attached · referentiel v0.8.6 · millesime_fiscal 2026

An x402-capable client (or the x402-fetch / @x402/* libraries) handles the 402 → sign → settle → retry loop automatically.

Protocol

MCP 2025-06-18. Methods: initialize, tools/list, tools/call, ping. Transport: JSON-RPC 2.0 over HTTP POST; the endpoint also serves a keepalive SSE stream on GET (Accept: text/event-stream) for clients that open the server→client channel. Payment: x402 v2 (EIP-3009 transferWithAuthorization, USDC on Base); verification and settlement go through the Coinbase CDP x402 facilitator (api.cdp.coinbase.com), called server-side by app.qotien.fr.

License

Code in this repository: MIT (see LICENSE). Reference data returned by the API: CC BY 4.0 — cite “Qotien — qotien.fr”.

Disclaimer

Results are deterministic indicative computations based on the French tax & social-security reference for the stated fiscal year. They are the raw output of a calculation engine and do not constitute personalized financial advice within the meaning of French CIF/DDA regulation.


Part of Qotien — the reference for French personal-finance data: aggregated, sourced, dated, re-verified every year. Human-readable (qotien.fr/sources) and machine-readable (this MCP). Reference data under CC BY 4.0 — cite “Qotien — qotien.fr”.

Source: README.md at commit fb26619

Tools

38

fiscal_impot_revenu

Impôt sur le revenu (barème 2026)

Impôt sur le revenu (barème 2026) — Impôt sur le revenu brut d'un foyer (barème progressif, quotient familial plafonné, décote). Revenus 2025. IR au barème SEUL, hors CEHR et hors CDHR : pour un foyer à hauts revenus, ajouter fiscal_cehr puis fiscal_cdhr (complément différentiel, déjà net de l'IR et de la CEHR — à additionner, pas à substituer). Pour l'économie d'impôt d'un versement PER → fiscal_per_gain. (sources: CGI art. 197 ; BOFiP BOI-IR-LIQ-20 ; LFI 2026 (barème + décote + plafond QF))

Parameterspartssituationparent_isoledemi_parts_195_aberesidence_alterneerevenu_net_imposablerequireddemi_parts_invalidite

fiscal_tmi

Taux marginal d'imposition (TMI)

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)

Parameterspartssituationparent_isoledemi_parts_195_aberesidence_alterneerevenu_net_imposablerequireddemi_parts_invalidite

fiscal_cehr

Contribution exceptionnelle sur les hauts revenus (CEHR)

Contribution exceptionnelle sur les hauts revenus (CEHR) — CEHR due sur le revenu fiscal de référence (art. 223 sexies CGI). Distincte de la CDHR. S'ajoute à l'IR au barème (fiscal_impot_revenu) ; la CDHR (fiscal_cdhr) peut s'y ajouter en complément. (sources: CGI art. 223 sexies ; BOFiP BOI-IR-CHR)

Parametersrfr_n1rfr_n2situationrevenu_fiscal_referencerequired

fiscal_prelevements_sociaux

Taux de prélèvements sociaux par nature de revenu

Taux de prélèvements sociaux par nature de revenu — Taux de PS applicable (17,2 % dérogatoire ou 18,6 % droit commun post-LFSS 2026) selon la nature du revenu du capital. Renvoie une FRACTION 0-1 (unit RATE, ex. 0,172) + un champ "pourcentage" (17,2) — à distinguer de tmi qui renvoie des points de pourcentage (unit PERCENT, 0-100). Revenus du CAPITAL uniquement ; pour une pension de retraite (CSG/CRDS/CASA) → retraite_ps_pension. (sources: LFSS 2026 art. 12 (loi 2025-1403) ; CSS art. L.136-1 s.)

Parameterstype_revenurequired

fiscal_surtaxe_pv_immobiliere

Surtaxe sur les plus-values immobilières

Surtaxe sur les plus-values immobilières — Surtaxe SEULE : taxe additionnelle sur une plus-value immobilière nette imposable (déjà calculée, après abattements pour durée de détention) supérieure à 50 000 € (barème par tranches). Pour l'impôt total d'une cession (IR + PS + surtaxe, abattements compris), utiliser fiscal_plus_value_immobiliere, qui inclut DÉJÀ cette surtaxe — ne pas additionner les deux. (sources: CGI art. 1609 nonies G)

Parametersplus_valuerequired

fiscal_plus_value_immobiliere

Plus-value immobilière (IR + PS + surtaxe)

Plus-value immobilière (IR + PS + surtaxe) — Impôt total sur la plus-value de cession d'un bien immobilier hors résidence principale : IR 19 % + PS 17,2 % + surtaxe, APRÈS abattements pour durée de détention (exonération IR à 22 ans, PS à 30 ans). Réintègre les amortissements LMNP au réel dans le prix majoré (réforme 2025). Rend l'impôt total, chaque composante et le net vendeur. Exonérations gérées : résidence principale et cession < 15 000 €. Point d'entrée pour une cession complète : la surtaxe est DÉJÀ incluse — ne pas y ajouter fiscal_surtaxe_pv_immobiliere (réservé au calcul de la surtaxe seule sur une plus-value nette déjà connue). (sources: CGI art. 150 U à 150 VH ; CGI art. 200 B (taux IR 19 %) ; CGI art. 1609 nonies G (surtaxe) ; LFSS 2026 (PS 17,2 % maintenu sur PV immobilière))

Parametersterraintravauxlmnp_reelquote_partprix_cessionrequiredfrais_cessionannees_detentionrequiredprix_acquisitionrequiredfrais_acquisitionacquisition_gratuiteresidence_principaleamortissements_deduits+1 more

fiscal_per_plafond

Plafond de déduction PER de l'année

Plafond de déduction PER de l'année — Plafond de versement PER déductible du revenu de l'année. Salarié (art. 163 quatervicies CGI) : 10 % des revenus pro et du PASS de l'année N-1 (versements 2026 → PASS 2025 = 47 100 €, plancher 4 710 €, max 37 680 €). TNS/BNC (art. 154 bis) : 10 % du bénéfice + 15 % de la fraction entre 1 et 8 PASS de l'année N (PASS 2026 = 48 060 €, plancher 4 806 €). Version « express » : un seul revenu, HORS reliquats et HORS mutualisation entre conjoints. C'est un PLAFOND de déduction, PAS une économie d'impôt : pour le gain d'un versement → fiscal_per_gain. Ne jamais multiplier ce plafond (ou un versement) par fiscal_tmi. (sources: CGI art. 163 quatervicies (salariés) ; CGI art. 154 bis (TNS/BNC) ; PASS 2026 — arrêté 22/12/2025 (JO 23/12/2025))

Parameterstnsrevenu_professionnelrequired

fiscal_ifi

Impôt sur la fortune immobilière (IFI)

Impôt sur la fortune immobilière (IFI) — IFI dû à partir du patrimoine immobilier taxable : limitation des dettes (art. 974, patrimoine > 5 M€), barème progressif (art. 977, seuil d'assujettissement 1,3 M€ mais barème dès 800 k€), décote (base 1,3–1,4 M€). Le plafonnement art. 979 (IFI + IR + PS ≤ 75 % des revenus) est appliqué SEULEMENT si revenu_foyer et autres_impots_annuels sont fournis — sinon l'IFI est rendu avant plafonnement et plafonnement_979 vaut "non_calcule" (montant non définitif). Version stateless : la base et les dettes sont des entrées (aucune lecture de dossier). (sources: CGI art. 964 (seuil 1,3 M€) ; CGI art. 977 (barème + décote) ; CGI art. 974 (limitation des dettes) ; CGI art. 979 (plafonnement 75 %))

Parametersdettesrevenu_foyerresidence_principaleautres_impots_annuelspatrimoine_immobilier_taxablerequired

fiscal_foncier_regime

Location nue : micro-foncier ou régime réel

Location nue : micro-foncier ou régime réel — Arbitrage du régime des revenus fonciers d'une location NUE : micro-foncier (abattement 30 %, loyers ≤ 15 000 €) vs régime réel (charges, intérêts, déficit imputable plafonné). Gain = Δ d'impôt TOTAL du foyer (IR au barème avec quotient familial + prélèvements sociaux 17,2 %), pas loyers × TMI. Même calcul que l'étude patrimoniale (cOptiFoncier). Au-delà de 15 000 € de loyers, le réel est obligatoire : pas d'arbitrage. Pour une location MEUBLÉE, utiliser fiscal_lmnp_regime. (sources: CGI art. 32 (micro-foncier) ; CGI art. 28 à 31 (régime réel) ; CGI art. 156-I-3° (déficit foncier) ; LFSS 2026 art. 12 (PS 17,2 % foncier))

Parameterspartsloyersrequiredchargesinteretssituationparent_isoledemi_parts_195_aberesidence_alterneedemi_parts_invaliditerevenu_net_imposable_horsrequired

fiscal_lmnp_regime

Location meublée (LMNP) : micro-BIC ou régime réel

Location meublée (LMNP) : micro-BIC ou régime réel — Arbitrage du régime d'une location MEUBLÉE non professionnelle : micro-BIC (abattement 50 %, 30 % en tourisme non classé) vs régime réel avec amortissement du bien (bâti hors terrain 20 %, sur 30 ans, plafonné art. 39 C). Gain = Δ d'impôt TOTAL du foyer (IR au barème + prélèvements sociaux 18,6 %). Renvoie aussi le verdict sur l'horizon de revente (réintégration des amortissements dans la plus-value, loi Le Meur). Même calcul que l'étude patrimoniale (cOptiLMNP). Sans valeur de bien, le réel n'est pas chiffré. Pour une location NUE, utiliser fiscal_foncier_regime. (sources: CGI art. 50-0 (micro-BIC) ; CGI art. 39 C (amortissement) ; CGI art. 150 VB III (réintégration, LF 2025 art. 84) ; LFSS 2026 art. 12 (PS 18,6 %))

Parameterspartsregimechargesinteretsrecettesrequiredsituationvaleur_bienparent_isoledemi_parts_195_aberesidence_alterneetourisme_non_classedemi_parts_invalidite+1 more

fiscal_succession

Droits de succession en ligne directe et économie de donation

Droits de succession en ligne directe et économie de donation — Droits de succession dus par les enfants (barème art. 777 appliqué PAR ENFANT après l'abattement de 100 000 € art. 779 I) et droits évités par une donation de 100 000 € par parent et par enfant faite plus de 15 ans avant la succession (art. 784 : pas de rappel) — tranche marginale sur 100 000 €. parents = 2 : deux successions, chacune sur la moitié de l'actif (biens communs du couple), soit 100 000 € d'abattement par parent et par enfant. Même calcul que l'étude patrimoniale (cTR). Hors assurance-vie (art. 990 I / 757 B). (sources: CGI art. 777 (barème ligne directe) ; CGI art. 779 I (abattement 100 000 €) ; CGI art. 784 (rappel fiscal 15 ans))

Parametersactifrequiredparentsnb_enfantsrequired

fiscal_cdhr

Contribution différentielle sur les hauts revenus (CDHR)

Contribution différentielle sur les hauts revenus (CDHR) — CDHR due (art. 224 CGI) : imposition minimale de 20 % du RFR ajusté − imposition effective (IR au barème + PFU 12,8 % sur les revenus financiers + CEHR + majorations 12 500 €/couple et 1 500 €/personne à charge), après décote art. 224 V. DISTINCTE de la CEHR (art. 223 sexies). Version stateless. Montant ADDITIONNEL, dû en plus de l'IR (fiscal_impot_revenu) et de la CEHR (fiscal_cehr), déjà déduits dans son calcul : l'additionner, ne pas le substituer. (sources: CGI art. 224 (CDHR) ; CGI art. 223 sexies (CEHR) ; FAQ CDHR impots.gouv.fr)

Parameterspartssituationrfr_ajusteparent_isoleimpot_referencedemi_parts_195_aberesidence_alterneenb_personnes_chargedemi_parts_invaliditerevenus_financiers_pfurevenu_fiscal_referencerequired

fiscal_per_gain

Gain d'impôt d'un versement PER

Gain d'impôt d'un versement PER — Économie d'impôt TOTALE d'un versement PER déductible = Δ(IR au barème + CEHR + CDHR). Le versement réduit le RFR ; pour un foyer plafonné par la CDHR le gain marginal réel est ≈ 20 % (PAS la TMI) → recalcul complet, jamais TMI × versement. Version stateless. Pour le montant maximal déductible (plafond) → fiscal_per_plafond. (sources: CGI art. 163 quatervicies (déductibilité PER) ; CGI art. 197 (barème/décote) ; CGI art. 223 sexies (CEHR) ; CGI art. 224 (CDHR))

Parameterspartssituationversementrequiredparent_isoledemi_parts_195_aberesidence_alterneenb_personnes_chargedemi_parts_invaliditerevenus_financiers_pfurevenu_fiscal_referencerequired

fiscal_niches_plafond

Plafonnement global des niches fiscales

Plafonnement global des niches fiscales — Réduction d'IR effective et plafonnement global des avantages fiscaux (art. 200-0 A CGI) : plafond 10 000 € (18 000 € si SOFICA / Girardin / Pinel Outre-Mer). Certaines niches sont HORS plafond (dons Coluche, Malraux, Monuments historiques, déficit foncier, PER). La liste des niches est fournie en entrée. (sources: CGI art. 200-0 A (plafonnement global) ; CGI art. 200 (dons))

Parametersnichesrequiredsalairessituationrevenu_imposablejei_reductions_anterieures

fiscal_flat_tax_vs_bareme

PFU (flat tax) vs barème progressif

PFU (flat tax) vs barème progressif — Compare l'imposition d'un revenu du capital au PFU (12,8 % IR + PS) vs à l'option barème (case 2OP : abattement 40 % dividendes, CSG 6,8 % déductible, IR marginal), et dit quelle option est la plus favorable. Taux PS 2026 par nature (18,6 % mobilier, 17,2 % AV/immo). Version stateless. (sources: CGI art. 200 A (PFU + option 2OP) ; CGI art. 158-3-2° (abattement 40 %) ; CGI art. 154 quinquies (CSG déductible) ; LFSS 2026 art. 12 (PS par nature))

Parameterspartsmontantrequiredsituationav_encourstype_revenurequiredav_primes_avant_2017revenu_net_imposablerequired

fiscal_jeanbrun

Dispositif Jeanbrun (amortissement bailleur, LF 2026)

Dispositif Jeanbrun (amortissement bailleur, LF 2026) — Nouveau dispositif d'amortissement du bailleur privé (LF 2026 art. 47, successeur de Pinel), fenêtre 21/02/2026 → 31/12/2028. Amortit 80 % du prix du logement au taux du couple logement (neuf / ancien rénové) × location (intermédiaire / social / très social), plafonné par an et par foyer, déductible du revenu foncier (IR à la TMI ; PS 17,2 % seulement jusqu'à annuler le revenu foncier net). Calcule l'amortissement annuel retenu et l'économie d'impôt (an, 9 ans = engagement minimal, 20 ans) ; l'amortissement n'a pas de durée maximale légale et court jusqu'à un cumul de 80 % du prix ; à la revente, les amortissements sont réintégrés à la plus-value (CGI 150 VB III). La TMI est fournie ou dérivée du revenu net imposable. ⚠️ BOFiP dédié attendu S2 2026 (calcul fondé sur le texte de loi). Version stateless. (sources: LF 2026 art. 47 (loi n° 2026-103 du 19/02/2026) ; CGI (amortissement bailleur — dispositif Jeanbrun) ; BOFiP dédié attendu S2 2026)

Parameterspartssituationprix_logementrequiredtype_locationtype_logementloyers_annuelstmi_pourcentageinterets_annuelscharges_annuellesrevenu_net_imposable

retraite_ps_pension

Prélèvements sociaux sur une pension (brut → net)

Prélèvements sociaux sur une pension (brut → net) — CSG (taux 0/3,8/6,6/8,3 % selon le RFR et les parts) + CRDS + CASA + 1 % maladie sur la part de pension complémentaire. Rend la pension nette, la tranche CSG et le taux effectif. Barème 2026 (seuils RFR 2024). Pensions de retraite uniquement ; pour un revenu du capital → fiscal_prelevements_sociaux. (sources: CSS art. L136-8 (CSG pensions) ; CSS art. L131-2 (1 % maladie retraite complémentaire) ; Barème CSG des pensions 2026 (seuils RFR 2024, circulaire CNAV 22/12/2025))

Parametersrfrpartsmontant_complementairepension_annuelle_bruterequired

retraite_estimation

Estimation de pension (données partielles)

Estimation de pension (données partielles) — Pension approchée à partir du statut, du revenu, de l'âge et de l'âge de départ : carrière reconstituée, SAM plafonné au PASS, décote. Rend un point central, une fourchette et un niveau de confiance. Ce N'est PAS un calcul certain — il remplace un relevé de carrière (RIS) manquant, pas l'inverse. Si le relevé de carrière ou de caisse est connu, préférer le calcul exact : régime en points → retraite_pension_regime ; fonction publique, régimes spéciaux, IEG → retraite_pension_annuites ; plusieurs régimes → retraite_pension_totale. (sources: CNAV — taux plein 50 %, SAM 25 meilleures années plafonné au PASS ; Agirc-Arrco — barème de points 2026 ; PASS 2026 = 48 060 € ; Fonction publique — 75 % du traitement indiciaire)

Parametersagerequiredstatutrequiredage_departtrimestres_acquisannee_debut_carriererevenu_net_imposablerequiredtraitement_indiciaire

retraite_pension_regime

Pension d'un régime en points (Agirc-Arrco, complémentaires, bases CNAVPL)

Pension d'un régime en points (Agirc-Arrco, complémentaires, bases CNAVPL) — Pension brute d'UN régime calculé en points (points × valeur de service 2026 × coefficient). Couvre Agirc-Arrco, Ircantec, RCI, RAFP, les 10 bases CNAVPL libérales et les complémentaires/ASV de caisse (CARMF, CIPAV, CARPIMKO, CARCDSF, CAVEC…). Contrôle de vraisemblance intégré (anti-erreur de sous-régime). À utiliser UNIQUEMENT pour un régime en POINTS. Ailleurs : fonction publique (SRE/CNRACL), régimes spéciaux (SNCF, RATP, Banque de France, CRPCEN, Opéra, Comédie-Française, FSPOEIE) et IEG → retraite_pension_annuites ; régime général CNAV (annuités sur SAM) → retraite_estimation, ou montant du relevé fourni à retraite_pension_totale. Plusieurs régimes d'une même carrière → retraite_pension_totale (un seul appel ; ne pas sommer soi-même). (sources: references_officielles.json v0.8.6 (valeurs de service 2026) ; retraite_registre.js (routage 47 caisses, source unique) ; retraite_engine.js (formules golden-testées, exemples officiels))

Parameterspointsrequiredage_legalage_departcode_regimerequiredtrimestres_acquistrimestres_requistrimestres_manquants

retraite_pension_annuites

Pension d'un régime en ANNUITÉS (fonction publique, régimes spéciaux, IEG-CNIEG)

Pension d'un régime en ANNUITÉS (fonction publique, régimes spéciaux, IEG-CNIEG) — Pension brute d'UN régime en annuités : traitement/salaire de référence × 75 % × (trimestres liquidables ÷ requis) × coefficient de décote. Couvre la fonction publique (SRE/CNRACL), les régimes spéciaux FP-like (SNCF, RATP, Banque de France, CRPCEN, Opéra, Comédie-Française, FSPOEIE) et l'IEG (CNIEG — EDF/GDF/Engie/Enedis/RTE/GRDF). À utiliser UNIQUEMENT pour ces régimes en ANNUITÉS. Ailleurs : régime EN POINTS (Agirc-Arrco, Ircantec, RAFP, complémentaires, bases CNAVPL) → retraite_pension_regime ; régime général CNAV (hors de cette liste) → retraite_estimation, ou montant du relevé fourni à retraite_pension_totale. Pour un total multi-régimes, passer ce montant à retraite_pension_totale via pensions_fournies. (sources: references_officielles.json v0.8.6 ; retraite_registre.js (routage, source unique) ; retraite_engine.js (formules golden-testées ; fonction publique = exemple officiel SRE))

Parametersage_legalage_departcode_regimerequiredsalaire_referencerequiredtrimestres_requistrimestres_liquidables

retraite_pension_totale

Pension totale consolidée (multi-régimes, le détail du RIS)

Pension totale consolidée (multi-régimes, le détail du RIS) — Somme les régimes EN POINTS d'un relevé (base CNAVPL + tous les complémentaires/ASV), splitte base/complémentaire, applique la couche brut→net (1 % maladie sur la seule part complémentaire). Les régimes qui ne sont pas en points se fournissent via pensions_fournies : fonction publique, régimes spéciaux et IEG → montant calculé par retraite_pension_annuites ; régime général CNAV → montant du RIS, ou à défaut retraite_estimation. Chaque jambe est vraisemblance-vérifiée ; la confiance globale suit la jambe la plus faible. Point d'ENTRÉE pour une carrière multi-régimes : un seul appel fait la somme — ne pas y ajouter ensuite les résultats de retraite_pension_regime pour les mêmes régimes. (sources: retraite_registre.js (routage 47 caisses) ; retraite_engine.js (formules golden-testées) ; CSS art. L136-8/L131-2 (prélèvements sociaux + 1 % maladie complémentaire))

Parametersrfrpartsregimesrequiredinclure_netpensions_fournies

retraite_regimes

Liste des régimes de retraite calculables par points

Liste des régimes de retraite calculables par points — Découverte : renvoie les régimes en points calculables via retraite_pension_regime (code, libellé, machine, étage, valeur de service 2026, taux de réversion). Filtrable par famille. (sources: retraite_registre.js (source unique des 47 caisses) ; references_officielles.json v0.8.6)

Parametersfamille

retraite_optimisation

Optimisation de fin de carrière (menu classé des leviers)

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))

Parametersagerequiredrfrsamtmipartsstatutage_legalnb_enfantsmda_parentaledate_naissancetrim_manquantsquotite_travail+5 more

retraite_rachat

Rachat de trimestres (VPLR — coût, gain, ROI)

Rachat de trimestres (VPLR — coût, gain, ROI) — Coût et rentabilité d'un rachat de trimestres (versement pour la retraite, art. L351-14-1). Barème 2026 (Circulaire CNAV 2026-04) selon âge/option/revenu, 2 options (taux seul / taux et durée), coût net d'IR (déductible), gain de pension et ROI en années. Gère le rachat d'études (abattement ≤ 40 ans) et de stage (12 % PMSS). Plafond légal 12 trimestres tous motifs. (sources: CSS art. L351-14-1, D351-14 à D351-18 ; Circulaire CNAV 2026-04 (barème VPLR) ; Service-Public F15675 ; Service-Public F19666 (gain décote))

Parametersagerequiredrfrsamtmimotifpartsn_trimrequiredoptiontrim_acquistrim_requisrevenu_moyentrim_manquants+1 more

retraite_surcote_parentale

Surcote parentale (+1,25 %/trim, max 5 %)

Surcote parentale (+1,25 %/trim, max 5 %) — Majoration de pension pour les parents au taux plein un an avant l'âge légal (art. L351-1-2-1). 1,25 % par trimestre travaillé dans la fenêtre [âge légal − 1 an ; âge légal), plafonné à 4 trimestres (5 %). Conditions : âge légal ≥ 63 ans, durée requise atteinte, ≥ 1 trimestre de majoration enfant (MDA). Gère le gel LFSS 2026. (sources: CSS art. L351-1-2-1, D351-1-4 ; CSS art. L351-4/L351-4-1/L351-5 (MDA) ; Service-Public F16336)

Parametersagerfrpartsage_legalnb_enfantsmda_parentaledate_naissancetrimestres_acquistrimestres_requispension_brute_annuelletrimestres_cotises_fenetre

retraite_progressive

Retraite progressive (fraction de pension + temps partiel)

Retraite progressive (fraction de pension + temps partiel) — Fraction de pension perçue en travaillant à temps partiel en fin de carrière (art. L161-22-1-5). Depuis le 01/09/2025, accessible dès 60 ans (décret 2025-681) avec 150 trimestres. Fraction = 100 % − quotité travaillée (salarié 40-80 %, fonction publique 50-90 %, TNS : baisse de revenus 20-60 %). Continue d'acquérir des droits. (sources: CSS art. L161-22-1-5, D161-2-24 (décret 2025-681), R351-39, R351-41 ; Service-Public F12842)

Parametersagerequiredrfrpartsstatutdate_effettrimestresrequireddate_naissancequotite_travailrequireddiminution_revenuspension_brute_annuelle

referentiel_valeur

Valeur du référentiel (sourcée + datée)

Valeur du référentiel (sourcée + datée) — La valeur 2026 d'une constante fiscale ou retraite par sa clé publique stable, avec sa source primaire, sa référence légale, sa date de vérification et son niveau de fiabilité. Jamais un chiffre nu. Clé inconnue → referentiel_recherche pour lister les clés disponibles. (sources: references_officielles.json v0.8.6)

Parametersclerequired

referentiel_recherche

Recherche dans le référentiel

Recherche dans le référentiel — Liste les clés publiques du référentiel, filtrables par domaine (fiscal/retraite) et/ou par mot-clé. Renvoie un résumé par clé (valeur, libellé, fiabilité) ; utiliser referentiel_valeur pour le détail sourcé complet. (sources: references_officielles.json v0.8.6)

Parametersqdomaine

referentiel_versions

Versions et fraîcheur du référentiel

Versions et fraîcheur du référentiel — Millésime courant, historique des versions, cadence et prochaine revue globale, niveaux de fiabilité — pour savoir de quand datent les valeurs et quand elles seront re-vérifiées. (sources: references_officielles.json v0.8.6)

Takes no parameters.

simulateurs_scpi

SCPI au comptant — projection à terme

SCPI au comptant — projection à terme — Projette un investissement en SCPI au comptant : valeur brute/nette de revente à terme, revenus distribués, TRI. Hypothèses de rendement, de revalorisation et de fiscalité fournies par l'appelant — résultat ESTIMÉ, non garanti. Achat à crédit → simulateurs_scpi_credit ; nue-propriété ou usufruit → simulateurs_demembrement_scpi. (sources: Méthode financière standard (actualisation de flux, TRI) ; Hypothèses de marché fournies par l'appelant)

Parametersfiscaliteduree_anneesfrais_sortierendement_brutrevalorisationversement_initialrequiredversement_mensuelreinvest_dividendes

simulateurs_scpi_credit

SCPI à crédit — effort d'épargne et TRI

SCPI à crédit — effort d'épargne et TRI — Projette une SCPI financée à crédit : mensualité, effort d'épargne, fonds propres et TRI à terme (intérêts + assurance déductibles). Résultat ESTIMÉ (hypothèses de rendement/revalorisation/taux). Achat au comptant → simulateurs_scpi ; nue-propriété ou usufruit → simulateurs_demembrement_scpi. (sources: Méthode financière standard (tableau d'amortissement, TRI de flux) ; Hypothèses de marché fournies par l'appelant)

Parametersapporttaux_credittaux_revenuduree_anneesmontant_creditrequiredtaux_assurancetaux_impositiontaux_revalorisation

simulateurs_demembrement_scpi

Démembrement de SCPI (nue-propriété / usufruit)

Démembrement de SCPI (nue-propriété / usufruit) — Projette un investissement en nue-propriété de SCPI (récupération de la pleine propriété au terme, aucun revenu pendant le démembrement) et l'usufruit correspondant (revenus nets d'IR, amortissement). IR branché sur le cIR de Qotien. Résultat ESTIMÉ. Pleine propriété au comptant → simulateurs_scpi ; à crédit → simulateurs_scpi_credit. (sources: Méthode financière standard (démembrement, actualisation) ; CGI (revenus fonciers de l'usufruitier) via cIR ; Hypothèses de marché fournies par l'appelant)

Parameterscledureeimpotmontantrequiredrendementvaleur_partrevalorisation

simulateurs_apport_credit

Arbitrage apport vs crédit (3 stratégies)

Arbitrage apport vs crédit (3 stratégies) — Compare trois stratégies de financement d'un projet immobilier : tout apporter, apport minimal + placement d'un bien secondaire, apport minimal + placement financier. Rend l'effort mensuel et le patrimoine/flux de trésorerie à terme de chaque stratégie. Résultat ESTIMÉ. (sources: Méthode financière standard (mensualités, capitalisation) ; Hypothèses de rendement/durée fournies par l'appelant)

Parametersapportrequiredprojetrequireduniquefinanciersecondaire

simulateurs_rentabilite_reelle

Rentabilité réelle d'un placement (vrai TRI)

Rentabilité réelle d'un placement (vrai TRI) — Calcule la rentabilité d'un placement à versements programmés en distinguant le VRAI TRI pondéré par le timing des flux (triReelPondere) du simple CAGR (rendement annualisé géométrique, qui ignore le timing). La valeur renvoyée est le vrai TRI. Résultat ESTIMÉ. (sources: Méthode financière standard (TRI/XIRR vs CAGR) ; Hypothèses fournies par l'appelant)

Parametersduree_moisfrais_entreefrais_gestionvaleur_actuellerequiredversement_initialrequiredversement_mensuel

simulateurs_girardin

Girardin industriel — réduction d'impôt one-shot

Girardin industriel — réduction d'impôt one-shot — Estime la réduction d'impôt d'un investissement Girardin industriel : impôt de référence (via le cIR de Qotien), montant remboursé (one-shot > impôt) et montant maximal investissable pour rester sous le plafond. Résultat ESTIMÉ (dépend du taux de rétrocession fourni). (sources: CGI art. 199 undecies B (Girardin industriel) via cIR ; Taux de rétrocession fourni par l'appelant)

Parameterspartsrendementtaux_assurancemontant_investirequiredsouscrit_assurancerevenu_net_imposablerequired

simulateurs_rente_viagere

Rente viagère à titre onéreux (nette d'impôt)

Rente viagère à titre onéreux (nette d'impôt) — Estime la rente viagère servie contre l'aliénation d'un capital : rente brute (via l'espérance de vie), part imposable selon l'âge d'entrée en jouissance (art. 158-6 CGI), surcoût d'IR (via le cIR de Qotien) et rente nette mensuelle. Espérance de vie bornée 60–80 ans. Résultat ESTIMÉ. (sources: CGI art. 158-6 (abattement rente viagère à titre onéreux) via cIR ; Table d'espérance de vie (INSEE, bornée 60–80 ans))

Parametersagerequiredsexepartsmontantrequiredfrais_arreragetaux_actualisationrevenu_net_imposable

simulateurs_private_equity

Private Equity — échéancier appels/distributions (courbe en J)

Private Equity — échéancier appels/distributions (courbe en J) — Projette un fonds de Private Equity sur un échéancier type (8 appels de capital puis 10 distributions) : total appelé, total distribué, DPI/TVPI et TRI daté des flux (XIRR). Résultat ESTIMÉ (échéancier et montants théoriques). (sources: Méthode financière standard (courbe en J, XIRR) ; Échéancier type fourni par défaut)

Parametersmultipledate_debutmontant_initialrequired

qotien_capacites

Capacités de Qotien (carte de planification)

Capacités de Qotien (carte de planification) — Ce que le moteur sait faire et avec quelle fiabilité, par domaine — à appeler AVANT de choisir un outil, pour planifier et savoir quand hédger. Ne calcule rien. (sources: /api/fiscal/v1/manifest ; references_officielles.json v0.8.6)

Takes no parameters.

Version history

3
  1. v0.1.2LatestSep 17, 2026
  2. v0.1.1Sep 16, 2026
  3. v0.1.0Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts