MCP server · x402 pay-per-call API

Exact French tax and payroll calculations for AI agents

Income tax, micro-entrepreneur URSSAF contributions, gross-to-net salary for CDI and CDD, full-time or part-time, working days and public holidays. Official scales, sourced and deterministic. Pay per call, no account, no API key.

Calculs fiscaux et sociaux français exacts pour agents IA : impôt sur le revenu, cotisations micro-entrepreneur, salaire brut → net en CDI ou en CDD, à temps plein ou partiel, jours ouvrés et jours fériés, indemnité de licenciement ou de rupture conventionnelle avec sa fiscalité, allocation chômage (ARE).

HTTP 422 · free POST /api/calcul/brut-net · CDD, details missing
Real response: the questions your agent asks the user
  • cdd_motifPour quel motif le CDD a-t-il été conclu ? (accroissement temporaire d’activité, remplacement d’un salarié absent, emploi saisonnier, CDD d’usage)
  • cdd_duree_moisQuelle est la durée totale du CDD, en mois (par exemple 6, ou 1.5 pour six semaines) ?
  • cdd_jours_conges_prisCombien de jours de congés payés le salarié prendra-t-il pendant le CDD (en jours ouvrés, 0 s’il n’en prend aucun) ?
  • cdd_suivi_d_un_cdiLe CDD sera-t-il immédiatement suivi d’un CDI chez le même employeur ?
  • cdd_job_vacances_jeuneS’agit-il d’un job de vacances d’un jeune (élève ou étudiant) pendant ses vacances scolaires ou universitaires ?

Each question comes with its type and allowed values. The agent asks, resends the complete request, and pays only for the successful calculation.

Built to be trusted with money questions

Language models are bad at tax arithmetic. FranceStack applies the official rules and shows its work, so your agent can answer French users with numbers it can stand behind.

  • Missing info? Free questions

    If anything is missing, your agent gets, for free, the exact questions to ask the user, in French, ready to use.

  • Exact, not generated

    Official DGFiP and URSSAF rules, no LLM at runtime, every result checked before it is sent.

  • Pay only on success

    $0.001 to $0.03 in USDC via x402, settled only if the calculation succeeds. Unsupported cases are refused for free.

  • Verifiable

    Step-by-step detail, assumptions, scale version, sources and a link to the official simulator.

Tools

Each tool is available as an MCP tool and as an HTTP endpoint, with the same validation, prices and free error handling.

Computes French personal income tax (impôt sur le revenu, IR) for a tax household: number of tax shares (parts, quotient familial), gross tax on the official DGFiP progressive scale, family-quotient cap, décote, net tax payable, average rate and marginal rate (TMI). Income years 2024, 2025. Input: household net taxable income, or declared salaries (the 10% deduction is applied).

Use it for
Use when a user asks how much French income tax a household pays, its marginal tax bracket (TMI), its number of tax shares, or the effect of marriage or children on the tax.
Why you can trust it
Deterministic code, no LLM, exact decimal arithmetic. Matches all 7,095 values of the official DGFiP tax tables (brochure pratique 2025 and 2026) to the euro, and 15 cases checked on the official impots.gouv.fr simulator.
MCP tool
france_income_tax
HTTP
POST /api/calcul/impot-revenu
Example input and real output

Input

{
  "annee_revenus": 2025,
  "situation_familiale": "marie_pacse",
  "enfants_a_charge": 2,
  "revenu_net_imposable": 54000,
  "cas_particuliers": []
}

Output (excerpt)

annee_revenus: 2025
revenu_net_imposable: 54000.00
nombre_parts: 3
quotient_familial: 18000.00
impot_avant_plafonnement: 2112.00
plafonnement_quotient_familial_applique: false
…

Details, sources and limits →

What a French micro-entrepreneur (auto-entrepreneur) pays to URSSAF for a month, quarter or year: social contributions (with or without ACRE), training contribution (CFP), chamber tax, optional flat-rate income tax (versement libératoire), net income. Years 2025, 2026. Optional: VAT franchise check (franchise en base de TVA, 2026) — must I charge VAT, since when, margin left.

Use it for
Use when a user asks how much URSSAF contributions an auto-entrepreneur owes on a given turnover, what the ACRE reduction changes, how much remains as net income, or whether they must charge VAT (set verifier_franchise_tva = true).
Why you can trust it
Deterministic code, no LLM, exact decimal arithmetic. Cross-checked on 2,000 cases against URSSAF's official engine (modele-social) and on 15 cases from the official URSSAF simulator; VAT franchise checked on the official worked examples of the tax doctrine (BOFiP).
MCP tool
france_micro_entrepreneur_contributions
HTTP
POST /api/calcul/micro-entrepreneur
Example input and real output

Input

{
  "activite": "prestations_services_commercant",
  "chiffre_affaires": 3000,
  "periode": "mois",
  "annee": 2026,
  "mois": 3,
  "date_debut_activite": "2022-01-10",
  "acre": false,
  "versement_liberatoire": false,
  "chiffre_affaires_n_moins_2_superieur_5000": true,
  "cas_particuliers": []
}

Output (excerpt)

periode_debut: 2026-03-01
periode_fin: 2026-03-31
chiffre_affaires_declare: 3000.00
taux_cotisations_pourcent: 21.2
acre_appliquee: false
cotisations_sociales: 636.00
…

Details, sources and limits →

French private-sector gross-to-net salary (salaire brut → net), mainland France, 2026 rules, CDI or CDD, full-time or part-time (temps partiel): employee contributions, net pay, net taxable pay, optional tax withholding (prélèvement à la source), RGDU reduction, employer cost. For a CDD: end-of-contract bonus (prime de précarité), paid-leave indemnity, CPF-CDD, monthly average and contract total.

Use it for
Use when a user asks for the net salary from a gross salary in France (CDI or CDD, full-time or part-time), the total cost of an employee for the employer, the end-of-contract bonus of a fixed-term contract, or the amount of employer and employee social contributions.
Why you can trust it
Deterministic code, no LLM: uses URSSAF's official payroll engine (modele-social). Official 2026 rates re-applied by hand in tests, official RGDU formula and example, and 30 cases checked on the official URSSAF salary simulator (15 full-time CDI, 15 CDD and part-time).
MCP tool
france_gross_to_net_salary
HTTP
POST /api/calcul/brut-net
Example input and real output

Input

{
  "salaire_brut": 3000,
  "periode": "mois",
  "annee": 2026,
  "mois": 3,
  "type_contrat": "CDI",
  "statut_cadre": false,
  "effectif": "de_20_a_49",
  "mutuelle_part_salariale": 30,
  "mutuelle_part_patronale": 30,
  "taux_versement_mobilite_pourcent": 1.75,
  "cas_particuliers": []
}

Output (excerpt)

periode: mois
type_contrat: CDI
temps_partiel_heures_par_semaine: null
smic_reference: 1823.03
salaire_brut: 3000.00
cotisations_salariales: 658.12
…

Details, sources and limits →

French public holidays (jours fériés) and working days for mainland France and Alsace-Moselle, 2000-2027: list a year's holidays, count calendar, working (jours ouvrés) and business days (jours ouvrables) between two dates, or add N working days to a date. Labour Code rules (L3133-1, L3134-13), Easter-based dates, holidays worked by the company and extra days off taken into account.

Use it for
Use when a user needs the French public holidays of a year, the number of working days (jours ouvrés or ouvrables) in a period, for example for payroll, paid leave or a fixed-term contract, or the date reached after N working days.
Why you can trust it
Deterministic code, no LLM. Every holiday date 2000-2027 for mainland France and Alsace-Moselle matches the official government calendar (calendrier.api.gouv.fr) and the service-public.fr tables; counts are cross-checked by an independent day-by-day enumeration.
MCP tool
france_working_days
HTTP
POST /api/calcul/jours-ouvres
Example input and real output

Input

{
  "operation": "compter_jours",
  "zone": "metropole",
  "date_debut": "2026-05-01",
  "date_fin": "2026-05-31"
}

Output (excerpt)

operation: compter_jours
zone: metropole
date_debut: 2026-05-01
date_fin: 2026-05-31
jours_calendaires: 31
jours_ouvrables: 22
…

Details, sources and limits →

French severance pay for a CDI, 2026: statutory dismissal indemnity (indemnité de licenciement) or minimum rupture conventionnelle amount, then the tax and social split of the amount paid: tax-exempt part, contribution base, CSG/CRDS, net, 40% employer levy.

Use it for
Use when a user is dismissed, negotiates a rupture conventionnelle, or an employer budgets a departure in France: minimum amount due, how much is tax-free, how much CSG/CRDS is withheld, and the employer cost.
Why you can trust it
Deterministic code, no LLM. Seniority and statutory amounts match the Labour Ministry simulator (code.travail.gouv.fr) on 15 recorded cases, including its exact month counting; the tax and social split reproduces every worked example of the official social security doctrine (BOSS) and service-public.fr; 2026 parameters (PASS 48,060 EUR, 40% levy from the 2026 social security financing act) are sourced.
MCP tool
france_severance_pay
HTTP
POST /api/calcul/indemnite-rupture
Example input and real output

Input

{
  "type_rupture": "rupture_conventionnelle",
  "date_entree": "2026-03-01",
  "date_fin_contrat": "2026-08-31",
  "absences_non_comptees": [],
  "salaires_mensuels_bruts": [
    2000,
    2000,
    2000,
    2000,
    2000,
    2000
  ],
  "primes_annuelles_3_derniers_mois": 0,
  "alternance_temps_plein_partiel": false,
  "indemnite_conventionnelle_branche": "aucune",
  "remuneration_brute_annee_precedente": 0,
  "droit_pension_retraite": false,
  "indemnite_versee": 600
}

Output (excerpt)

type_rupture: rupture_conventionnelle
anciennete_mois: 6
anciennete_texte: 6 mois
salaire_reference: 2000.00
nombre_mois_salaires: 6
indemnite_legale: 250.00
…

Details, sources and limits →

French unemployment benefit (allocation chômage, ARE) after a dismissal, mutual termination (rupture conventionnelle) or end of fixed-term contract, for contracts ending Sep-Dec 2026: eligibility, daily reference wage, gross and net daily and monthly amounts, duration (new 2026 caps after rupture conventionnelle), 30% reduction after month 6, waiting periods and first paid day.

Use it for
Use when a user losing a job in France asks how much unemployment benefit they will receive, for how long, and from when, or an employer or adviser compares exit options.
Why you can trust it
Deterministic code, no LLM. Rules from the Unédic regulation consolidated on 1 Sep 2026 and circular 2026-06; amounts, durations, rounding and start dates match the official France Travail simulator on 15 recorded cases (one documented gap: the simulator still uses the old cap after rupture conventionnelle).
MCP tool
france_unemployment_benefit
HTTP
POST /api/calcul/allocation-chomage
Example input and real output

Input

{
  "motif_fin_contrat": "licenciement",
  "date_naissance": "1985-03-15",
  "date_fin_contrat": "2026-10-31",
  "periodes_emploi": [
    {
      "debut": "2024-11-01",
      "fin": "2026-10-31",
      "salaire_brut": 72000
    }
  ],
  "heures_hebdomadaires": 35,
  "primo_entrant": false,
  "indemnite_conges_payes": 0,
  "indemnites_supra_legales": 0,
  "delai_attente_deja_applique": false,
  "alsace_moselle": false,
  "situations_particulieres": []
}

Output (excerpt)

droit_ouvert: true
age_fin_contrat: 41
periode_reference_debut: 2024-11-01
jours_travailles: 523
jours_calendaires: 730
salaire_reference: 72000.00
…

Details, sources and limits →

How a call works

From request to result, and you never pay for an error.

  1. Your agent sends the request

    Over MCP or HTTP, with whatever it knows about the user's situation.

  2. Free check before any payment

    Missing or invalid fields come back free with the questions to ask. A complete request gets the x402 price: $0.001 to $0.03 in USDC on Base.

  3. Pay and receive the result

    The agent signs the payment, gets the calculation with its detail and sources, and is charged only if it succeeds.

Connect

Use the MCP server from any MCP client, or call the HTTP API with any x402 client.

MCP server (Streamable HTTP)

Endpoint https://tax.francestack.fr/mcp. The tools above plus the free list_france_calculators. Payment uses x402 over MCP, handled automatically by x402-enabled clients such as @x402/mcp.

{
  "mcpServers": {
    "francestack-tax": {
      "type": "http",
      "url": "https://tax.francestack.fr/mcp"
    }
  }
}

HTTP API

POST a JSON body. Without payment you get 402 Payment Required with the x402 terms; pay and resend with the PAYMENT-SIGNATURE header.

curl -i -X POST https://tax.francestack.fr/api/calcul/impot-revenu \
  -H "Content-Type: application/json" \
  -d '{
    "annee_revenus": 2025,
    "situation_familiale": "marie_pacse",
    "enfants_a_charge": 2,
    "revenu_net_imposable": 54000,
    "cas_particuliers": []
  }'

For agents and developers

Everything is machine-readable and free to fetch.

Indicative estimate, not legally binding: check with the official simulator or service. Estimation indicative non contractuelle. Vérifier avec le simulateur ou le service officiel.