Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words Sign in

Tax Retirement

by herve-coulonversion 0.1.2i★ 1iRuns in the cloudOfficial site ↗
Registry nameio.github.herve-coulon/tax-retirement

How to install

What it does

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

  • Connects Runs in the cloud
  • Account or key No key needed
  • Category Accounting, finance & tax

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity4/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness7/12Full marks for a release or code change within 30 days
Still answering8/8The cloud endpoint answered at the last check
Usage score19/100

Quality: Passed 5/5 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Tax Retirement. Follow https://mcp.popnx.com/i/herve-coulon-tax-retirement.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 5/5 checks · What you ask goes through the maker’s server (app.qotien.fr) · ✓ Commands checked Nov 20, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude · about 2 min

No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · NameTax Retirement
    Remote MCP server URL · Addresshttps://app.qotien.fr/api/fiscal/v1/mcp

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

  3. Turn it on in a chat

    +ConnectorsTax Retirement

  4. Try it

    Use Tax Retirement and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Tax Retirement or shows a Tax Retirement tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT, depending on your plan

Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only

  1. Open ChatGPT’s add-MCP page on the web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Fill in the name and address

    Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin

    Name · NameTax Retirement
    Connection · Addresshttps://app.qotien.fr/api/fiscal/v1/mcp
  3. Pick Tax Retirement in a chat

    Start a new chat and pick Tax Retirement from your plugins before typing

  4. Try it

    Use Tax Retirement and tell me what you can do for me, then show me one thing

    ✓ If ChatGPT says it is using Tax Retirement or shows a Tax Retirement tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code · about 2 min

No key, nothing to install

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  2. Paste this command and press Enter

    claude mcp add --transport http --scope user tax-retirement https://app.qotien.fr/api/fiscal/v1/mcp
  3. Type /mcp in Claude Code

    You should see Tax Retirement listed as connected

  4. Try it

    Use Tax Retirement and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Tax Retirement or shows a Tax Retirement tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 2 min

No key, nothing to install

  1. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  2. Open the AI chat in Cursor in Agent mode

  3. Try it

    Use Tax Retirement and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Tax Retirement or shows a Tax Retirement tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 2 min

No key, nothing to install

  1. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  2. Open the AI chat in VS Code in Agent mode

  3. Try it

    Use Tax Retirement and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Tax Retirement or shows a Tax Retirement tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://app.qotien.fr/api/fiscal/v1/mcp

JSON settings are under “For developers” below

Stuck? Ask people who use Tax Retirement💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

Claude Code

claude mcp add --transport http --scope user tax-retirement https://app.qotien.fr/api/fiscal/v1/mcp

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

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

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
Not on npm/PyPI
Connection
Runs in the cloud
Transport
streamable-http
Latest versioni
0.1.2
Published to registryi
Sep 17, 2026
Code last changedi
Oct 15, 2026
Last checked
Nov 20, 2026
Maker
herve-coulon
Website
qotien.fr
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

All apps, with pros and cons →

Related guides

What it can do

Tool names and descriptions exactly as the server reported them on Nov 20, 2026. The maker wrote them, not us; we show them as plain text.

  • fiscal_impot_revenu

    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,

  • fiscal_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

  • fiscal_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

  • fiscal_prelevements_sociaux

    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 ren

  • fiscal_surtaxe_pv_immobiliere

    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

  • fiscal_plus_value_immobiliere

    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 LMN

  • fiscal_per_plafond

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

  • fiscal_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. 97

  • fiscal_foncier_regime

    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 quotie

  • fiscal_lmnp_regime

    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

  • fiscal_succession

    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 a

  • fiscal_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é

  • fiscal_per_gain

    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), jamais TMI × versement. Déduit du revenu global (art. 163 quatervicies, défaut) : le versement réduit l'IR mais il est réintégré au revenu fiscal de référence

  • fiscal_niches_plafond

    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 historique

  • fiscal_flat_tax_vs_bareme

    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 % m

  • fiscal_jeanbrun

    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 (int

  • retraite_ps_pension

    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 retrai

  • retraite_estimation

    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

  • retraite_pension_regime

    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 (C

  • retraite_pension_annuites

    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é

  • retraite_pension_totale

    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 (CSG/CRDS/CASA selon le RFR ; 1 % maladie sur les seules complémentaires de

  • retraite_regimes

    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 uniq

  • retraite_optimisation

    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, retrait

  • retraite_rachat

    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 pe

  • retraite_surcote_parentale

    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 an

  • retraite_progressive

    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 (

  • referentiel_valeur

    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 po

  • referentiel_recherche

    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_officielle

  • referentiel_versions

    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)

  • simulateurs_scpi

    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éd

  • simulateurs_scpi_credit

    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

  • simulateurs_demembrement_scpi

    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 Qoti

  • simulateurs_apport_credit

    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

  • simulateurs_rentabilite_reelle

    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 l

  • simulateurs_girardin

    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É (

  • simulateurs_rente_viagere

    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 mensuel

  • simulateurs_private_equity

    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 t

  • qotien_capacites

    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)

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 20, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account herve-coulon, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 36 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • ✓ Pass

    Endpoint responds

    Responded in 230 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 38 tool descriptions and found no hidden instructions to the AI

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/herve-coulon-tax-retirement.svg)](https://mcp.popnx.com/en/servers/herve-coulon-tax-retirement)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Accounting, finance & taxi

  • More stars than 87% of the other 3462 servers in this category
  • Published to the registry more recently than 31% of the other 3462 servers in this category
  • Basic checks equal to or better than 99% of the other 3462 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Tax Retirement safe?

It passed 5 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed 36 days ago, and the latest version (0.1.2) reached the registry 2 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: SolidInvoice, Signal8, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Signal8

SEC filings, dilution, insider & institutional ownership, and political-trade data for AI agents.

by signal8aiGrowing↓ 431/wk★ 425Updated 11 days ago

Computer or cloud✓ service owner · signal8.ai

Journalit

Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.

by CursivezGrowing★ 261Updated 12 days ago

Runs in the cloud✓ service owner · journalit.co

Beancount.io

Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.

by bex-coGrowing★ 707 Stars for the whole repoUpdated last month

Runs in the cloud✓ service owner · beancount.io
Compared with similar ones
This one
Tax Retirement
SolidInvoiceSignal8JournalitBeancount.ioTapetide - Indian Stock Market MCP
Runs whereRuns in the cloud, nothing to installRuns in the cloud, nothing to installCloud or install on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installCloud or install on your computer
Needs a keyNoNoYesNoNoYes
Add with + in ClaudeNoNoNoNoNoNo
Basic checks5/54/65/54/44/45/5
LicenseMITMITMITNOASSERTIONMITMIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

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](https://x402.org) (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

{

"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) — contact@qotien.fr.

Quick start

# 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: ' \ -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”.*