# FranceStack Tax & Payroll > Deterministic French tax and payroll calculations for AI agents: income tax (impôt sur le revenu), micro-entrepreneur (auto-entrepreneur) URSSAF contributions, gross-to-net salary and employer cost for CDI or CDD, full-time or part-time, working days and public holidays (jours ouvrés, jours fériés), severance pay with its tax and social treatment (indemnité de licenciement, rupture conventionnelle), unemployment benefit amount, duration and start date (allocation chômage ARE). Official scales, sourced and verified; no LLM at runtime. Missing information is answered for free with the exact questions to ask the user; unsupported cases are refused for free; you pay per successful call with x402 (USDC). How to call (no account, no API key): 1. POST https://tax.francestack.fr/api/calcul/ with a JSON body (schemas below). You do not need every field upfront: send what you know, and missing fields return a FREE HTTP 422 "champs_manquants" listing every question to ask the user (in French, ready to use, with type and allowed values), in one round trip. Example: a CDD without its details returns the questions on the contract reason, length, leave taken, CDI follow-up and student holiday job. 2. Unsupported situations return a free HTTP 422 "cas_non_supporte" or "bareme_non_disponible": nothing to pay. 3. A complete, supported request returns HTTP 402 with x402 payment instructions (PAYMENT-REQUIRED header). Pay with any x402 client (USDC on Base) and resend the same request with PAYMENT-SIGNATURE. 4. HTTP 200 returns the result, a step-by-step detail, the assumptions, the official scale version with sources, and a link to the official simulator. Payment is settled only on success. MCP: the same tools are available as an MCP server at https://tax.francestack.fr/mcp (Streamable HTTP, stateless). Tool names: france_income_tax, france_micro_entrepreneur_contributions, france_gross_to_net_salary, france_working_days, france_severance_pay, france_unemployment_benefit, plus the free list_france_calculators. Payment uses x402 over MCP (the tool returns the payment requirements; call it again with the payment in _meta["x402/payment"]; @x402/mcp clients do it automatically). Errors are free. ## Tools - [France income tax calculator (impôt sur le revenu)](https://tax.francestack.fr/api/calcul/impot-revenu): POST, 0.005 USDC. 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). 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. - [France micro-entrepreneur (auto-entrepreneur) contributions calculator](https://tax.francestack.fr/api/calcul/micro-entrepreneur): POST, 0.005 USDC. 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. 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). - [France gross-to-net salary and employer cost calculator (salaire brut net)](https://tax.francestack.fr/api/calcul/brut-net): POST, 0.005 USDC. 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. 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). - [France working days and public holidays (jours ouvrés, jours fériés)](https://tax.francestack.fr/api/calcul/jours-ouvres): POST, 0.001 USDC. 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. 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. - [France severance pay: dismissal and mutual termination (indemnité de licenciement, rupture conventionnelle)](https://tax.francestack.fr/api/calcul/indemnite-rupture): POST, 0.02 USDC. 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. 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. - [France unemployment benefit (allocation chômage ARE)](https://tax.francestack.fr/api/calcul/allocation-chomage): POST, 0.03 USDC. 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. 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). ## Docs - [Full catalogue: JSON schemas, examples, limits, scales](https://tax.francestack.fr/api/calculs): free, JSON - [OpenAPI 3.1](https://tax.francestack.fr/openapi.json): paid operations with x-payment-info - [x402 discovery](https://tax.francestack.fr/.well-known/x402): list of paid resources - [MCP server](https://tax.francestack.fr/mcp): Streamable HTTP endpoint, same tools, x402 over MCP ## Web pages - [France income tax calculator (impôt sur le revenu)](https://tax.francestack.fr/en/french-income-tax): human-readable page with example, limits and official sources; French version: https://tax.francestack.fr/fr/calcul-impot-sur-le-revenu - [France micro-entrepreneur (auto-entrepreneur) contributions calculator](https://tax.francestack.fr/en/micro-entrepreneur-contributions): human-readable page with example, limits and official sources; French version: https://tax.francestack.fr/fr/cotisations-micro-entrepreneur - [France gross-to-net salary and employer cost calculator (salaire brut net)](https://tax.francestack.fr/en/gross-to-net-salary): human-readable page with example, limits and official sources; French version: https://tax.francestack.fr/fr/salaire-brut-net - [France working days and public holidays (jours ouvrés, jours fériés)](https://tax.francestack.fr/en/working-days-public-holidays): human-readable page with example, limits and official sources; French version: https://tax.francestack.fr/fr/jours-ouvres-jours-feries - [France severance pay: dismissal and mutual termination (indemnité de licenciement, rupture conventionnelle)](https://tax.francestack.fr/en/severance-pay): human-readable page with example, limits and official sources; French version: https://tax.francestack.fr/fr/indemnite-licenciement-rupture-conventionnelle - [France unemployment benefit (allocation chômage ARE)](https://tax.francestack.fr/en/unemployment-benefit): human-readable page with example, limits and official sources; French version: https://tax.francestack.fr/fr/allocation-chomage-are ## Optional - [Not supported by impot-revenu](https://tax.francestack.fr/api/calculs): Not supported (refused for free with HTTP 422): non-residents, overseas departments, alternating-custody children, extra half-shares (disability, veterans, box L), exceptional income taxed with the quotient system, tax credits and reductions, incomes above the high-income contribution thresholds (CEHR/CDHR). - [Not supported by micro-entrepreneur](https://tax.francestack.fr/api/calculs): Not supported (refused for free with HTTP 422): mixed activities, furnished rentals and holiday lets, overseas departments, Alsace-Moselle craftspeople, lawyers and artist-authors, periods straddling the end of ACRE, ACRE in 2025, minimum-contribution option, exit from the micro regime, VAT check for years other than 2026. CFE and business expenses are not included. - [Not supported by brut-net](https://tax.francestack.fr/api/calculs): Not supported (refused for free with HTTP 422): temporary agency work (intérim), CDD à objet défini, fixed-term contracts ended early, overtime, incomplete months, fixed-days (forfait jours), apprentices and interns, company officers (SAS president), Alsace-Moselle, overseas departments, salaries below the minimum wage (SMIC, prorated for part-time), years other than those listed. - [Not supported by jours-ouvres](https://tax.francestack.fr/api/calculs): Not supported (refused for free with HTTP 422): overseas departments and territories (outre-mer), years outside the covered range, periods over 10 years, legal or court deadlines (procedural deadline rules differ). - [Not supported by indemnite-rupture](https://tax.francestack.fr/api/calculs): Not supported (refused for free with HTTP 422): end of fixed-term or temp contracts, serious misconduct (faute grave, answered for free: no statutory indemnity), occupational unfitness, redundancy plans (PSE) and redeployment leave, retirement, mixed full-time/part-time careers, collective agreement formulas (the agent supplies the branch amount), contracts ending outside 2026, amounts above 10 PASS. - [Not supported by allocation-chomage](https://tax.francestack.fr/api/calculs): Refused for free (HTTP 422): resignation, temp agency or entertainment workers, overseas, rights still running, pension recipients, kept jobs, sick leave with reduced pay, contracts ending outside Sep-Dec 2026, and edge cases where official sources disagree (stated in the refusal). Disclaimer: Estimation indicative non contractuelle. Vérifier avec le simulateur ou le service officiel.