API for AI agents · MCP server
French micro-entrepreneur (auto-entrepreneur) contributions API
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.
- $0.005 per successful call
- Free if information is missing
- No account, no API key
What it is 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).
Real example
Input sent and real service response (the "resultat" part). The full response also contains the step-by-step detail, assumptions, scale version and sources.
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": []
}Response
{
"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",
"taux_formation_professionnelle_pourcent": "0.1",
"contribution_formation_professionnelle": "3.00",
"taux_frais_chambre_pourcent": "0.044",
"taxe_frais_chambre_consulaire": "1.32",
"cotisations_et_contributions": "640.32",
"taux_versement_liberatoire_pourcent": "0",
"versement_liberatoire": "0.00",
"total_a_payer": "640.32",
"revenu_net_avant_impot": "2359.68",
"revenu_net_apres_versement_liberatoire": null,
"tva": null
}Missing information? The questions are free
Real response if your agent only sends activite: a free HTTP 422 listing, in one round trip, every question to ask the user (in French, ready to use).
chiffre_affairesQuel chiffre d’affaires hors taxes avez-vous encaissé sur la période (en euros) ?periodeCe chiffre d’affaires correspond-il à un mois, un trimestre ou une année civile ?anneeDe quelle année civile s’agit-il ?date_debut_activiteQuelle est la date de début d’activité de votre auto-entreprise (AAAA-MM-JJ) ?acreBénéficiez-vous de l’ACRE (aide à la création ou reprise d’entreprise) accordée par l’URSSAF ?versement_liberatoireAvez-vous opté pour le versement libératoire de l’impôt sur le revenu ?cas_particuliersÊtes-vous concerné par l'une de ces situations ? Plusieurs catégories d'activité (par exemple vente et prestations de services) ; Location meublée, meublé de tourisme ou chambres d’hôtes ; Activité exercée dans un département d’outre-mer ; Artisan établi en Alsace (Bas-Rhin, Haut-Rhin) ou en Moselle ; Artisan immatriculé à la fois à la CCI et à la CMA ; Option pour le paiement de cotisations minimales ; Conjoint collaborateur déclaré ; Plafonds de chiffre d’affaires dépassés deux années civiles consécutives ; Avocat, ou artiste-auteur (seuils de TVA et régimes sociaux spécifiques). Répondez par la liste des situations concernées, ou une liste vide si aucune.
Unsupported cases (refused for free)
Rather than guess, the tool refuses these situations for free, before any payment.
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.
Full list (in French)
- Périodes en dehors des années 2025, 2026 (une année n’est servie qu’une fois ses taux publiés et intégrés).
- ACRE sur une période de 2025 (taux réduits 2025 non intégrés).
- Période qui chevauche la fin de l’ACRE (déclarer par mois ou par trimestre de part et d’autre).
- Activités mixtes (plusieurs catégories de chiffre d’affaires).
- Location meublée, meublé de tourisme, chambres d’hôtes.
- Départements d’outre-mer.
- Artisans établis en Alsace ou en Moselle (taxe pour frais de chambre de métiers spécifique) ; artisans en double immatriculation CCI/CMA.
- Option pour les cotisations minimales ; conjoint collaborateur.
- Sortie du régime après dépassement des plafonds de chiffre d’affaires deux années consécutives.
- Cotisation foncière des entreprises (CFE) et charges réelles de l’activité.
- Avocats et artistes-auteurs (régimes sociaux et seuils de TVA spécifiques).
- Franchise de TVA : années autres que 2026 ; chiffre d’affaires 2025 situé dans la zone d’incertitude entre les anciens et les nouveaux seuils (36 800 – 37 500 € pour les services, 85 000 – 91 900 € pour la vente).
Reliability and official sources
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).
- www.autoentrepreneur.urssaf.fr/portail/accueil/sinformer-sur-le-statut/lessentiel-du-statut.html
- entreprendre.service-public.gouv.fr/vosdroits/F36232
- entreprendre.service-public.gouv.fr/vosdroits/F11677
- www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000052218738
- www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000046898530
- www.autoentrepreneur.urssaf.fr/portail/accueil/sinformer-sur-le-statut/toutes-les-actualites/incident---declarations-des-auto.html
To check a result: official simulator or service.
Use the tool
MCP server
Tool france_micro_entrepreneur_contributions on https://tax.francestack.fr/mcp (Streamable HTTP).
HTTP API
POST https://tax.francestack.fr/api/calcul/micro-entrepreneur, $0.005 in USDC via x402, settled only if the calculation succeeds.
Full field schema: /api/calculs and /openapi.json. Setup: home page.
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.