Skip to main content
Glama

FranceStack Tax & Payroll

France micro-entrepreneur (auto-entrepreneur) contributions calculator

france_micro_entrepreneur_contributions
Read-onlyIdempotent

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 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). 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). 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. Price: 0.005 USDC per successful call, paid with x402 over MCP. Missing or invalid fields are reported for free with the questions to ask the user; you never pay for an error. Returns JSON (also in structuredContent): calculateur, resultat, detail (step by step), hypotheses, bareme (version, effective date, sources), estimation_indicative, avertissement, lien_verification. Full output schema and a real example: list_france_calculators.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "activite": "<activite>",
      "chiffre_affaires": "<chiffre_affaires>",
      "periode": "<periode>",
      "annee": "<annee>",
      "date_debut_activite": "<date_debut_activite>",
      "acre": "<acre>",
      "versement_liberatoire": "<versement_liberatoire>",
      "cas_particuliers": "<cas_particuliers>"
    },
    "name": "france_micro_entrepreneur_contributions"
  }
}

Input Schema

NameRequiredDescriptionDefault
acreYestrue if the entrepreneur was granted ACRE (reduced contribution rates for business creators).
moisNoRequired if periode = mois: month number 1 to 12.
anneeYesCalendar year of the period. Supported: 2025, 2026.
periodeYesDeclaration period: mois (month), trimestre (calendar quarter) or annee (calendar year).
activiteYesActivity category: vente_marchandises_commercant (sale of goods, restaurants, lodging by a trader), vente_marchandises_artisan (resale of goods by a craftsperson), prestations_services_commercant (commercial services, BIC), prestations_services_artisan (craft services, BIC), liberale_non_reglementee (other services or non-regulated liberal profession, BNC), liberale_reglementee_cipav (regulated liberal profession under CIPAV, BNC).
trimestreNoRequired if periode = trimestre: calendar quarter 1 to 4.
cas_particuliersYesRequired. Special situations that apply, or [] if none: activite_mixte (several activity categories), location_meublee (furnished rental, holiday let, B&B), outre_mer (overseas department), alsace_moselle (craftsperson in Alsace or Moselle), double_immatriculation_cci_cma (registered with both CCI and CMA), cotisations_minimales (minimum contributions option), conjoint_collaborateur (collaborating spouse), sortie_regime_micro (turnover ceilings exceeded two years in a row), avocat_ou_artiste_auteur (lawyer or artist-author). Any listed situation is refused for free (HTTP 422).
chiffre_affairesYesTurnover excluding VAT actually collected during the period, in EUR (chiffre d’affaires encaissé).
date_debut_activiteYesBusiness start date (YYYY-MM-DD). Determines the ACRE period and the first-year chamber tax exemption.
versement_liberatoireYestrue if the entrepreneur opted for the flat-rate income tax paid with contributions (versement libératoire).
verifier_franchise_tvaNoOptional: true to also check the VAT franchise (franchise en base de TVA): must the entrepreneur charge VAT, since when, margin left before the threshold. 2026 only.
tva_activite_saisonniereNoRequired for the VAT check if the business started this year or last year: true for a seasonal activity (thresholds are then not prorated).
tva_chiffre_affaires_cumule_anneeNoRequired for the VAT check unless periode = annee: turnover excluding VAT collected since 1 January of the year up to today, including the declared period, in EUR.
tva_chiffre_affaires_annee_precedenteNoRequired for the VAT check if the business started before the year: turnover excluding VAT of the previous calendar year, in EUR.
chiffre_affaires_n_moins_2_superieur_5000NoRequired for trade and craft activities after the first calendar year: true if turnover two years before was at least EUR 5,000 (otherwise the chamber tax is not due).

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed7 schema fields changed
    • changedInput schema / properties / cas_particuliers / description
      Previous value: -"Required. Special situations that apply, or [] if none: activite_mixte (several activity categories), location_meublee (furnished rental, holiday let, B&B), outre_mer (overseas department), alsace_moselle (craftsperson in Alsace or Moselle), double_immatriculation_cci_cma (registered with both CCI and CMA), cotisations_minimales (minimum contributions option), conjoint_collaborateur (collaborating spouse), sortie_regime_micro (turnover ceilings exceeded two years in a row). Any listed situation is refused for free (HTTP 422)."New value: +"Required. Special situations that apply, or [] if none: activite_mixte (several activity categories), location_meublee (furnished rental, holiday let, B&B), outre_mer (overseas department), alsace_moselle (craftsperson in Alsace or Moselle), double_immatriculation_cci_cma (registered with both CCI and CMA), cotisations_minimales (minimum contributions option), conjoint_collaborateur (collaborating spouse), sortie_regime_micro (turnover ceilings exceeded two years in a row), avocat_ou_artiste_auteur (lawyer or artist-author). Any listed situation is refused for free (HTTP 422)."
    • changedInput schema / properties / cas_particuliers / items / enum
      Previous value: -[
      -  "activite_mixte",
      -  "location_meublee",
      -  "outre_mer",
      -  "alsace_moselle",
      -  "double_immatriculation_cci_cma",
      -  "cotisations_minimales",
      -  "conjoint_collaborateur",
      -  "sortie_regime_micro"
      -]New value: +[
      +  "activite_mixte",
      +  "location_meublee",
      +  "outre_mer",
      +  "alsace_moselle",
      +  "double_immatriculation_cci_cma",
      +  "cotisations_minimales",
      +  "conjoint_collaborateur",
      +  "sortie_regime_micro",
      +  "avocat_ou_artiste_auteur"
      +]
    • changedInput schema / properties / cas_particuliers / maxItems
      Previous value: -8New value: +9
    • addedInput schema / properties / tva_activite_saisonniere
      Added value: +{
      +  "description": "Required for the VAT check if the business started this year or last year: true for a seasonal activity (thresholds are then not prorated).",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / tva_chiffre_affaires_annee_precedente
      Added value: +{
      +  "description": "Required for the VAT check if the business started before the year: turnover excluding VAT of the previous calendar year, in EUR.",
      +  "maximum": 10000000,
      +  "minimum": 0,
      +  "type": "number"
      +}
    • addedInput schema / properties / tva_chiffre_affaires_cumule_annee
      Added value: +{
      +  "description": "Required for the VAT check unless periode = annee: turnover excluding VAT collected since 1 January of the year up to today, including the declared period, in EUR.",
      +  "maximum": 10000000,
      +  "minimum": 0,
      +  "type": "number"
      +}
    • addedInput schema / properties / verifier_franchise_tva
      Added value: +{
      +  "description": "Optional: true to also check the VAT franchise (franchise en base de TVA): must the entrepreneur charge VAT, since when, margin left before the threshold. 2026 only.",
      +  "type": "boolean"
      +}
  2. First observed

TDQS

A4.6/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare read-only, idempotent, non-destructive behavior, and the description goes well beyond that: it discloses pricing (0.005 USDC per successful call via x402), that validation errors are free with HTTP 422, that computation is deterministic with exact decimal arithmetic, and the validation methodology (2,000 cases vs modele-social). It also states what is excluded (CFE, business expenses) and fully enumerates the response keys.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

It is dense and long, but front-loaded: what it computes and the when-to-use clause come first, followed by limitations, then pricing and return shape. The cross-checking methodology sentence is somewhat promotional but supports trust in a financial calculation. Slightly tighter phrasing around the validation claims would earn a 5.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 15-parameter financial calculator with no output schema, the description supplies the return field list, the error behavior, the refusal list, and a pointer to list_france_calculators for the full schema and a real example. An agent has everything needed to decide whether to call it and how to interpret the response.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already explains every one of the 15 parameters including enum values. The description adds marginal meaning — it directs the agent to set verifier_franchise_tva = true for VAT questions and links ACRE/versement libératoire to their outcomes — but does not explain conditional parameter interplay such as tva_chiffre_affaires_cumule_annee beyond what the schema states. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific verb-and-resource pair (computing what a micro-entrepreneur pays to URSSAF) and enumerates the exact outputs: social contributions with/without ACRE, CFP, chamber tax, versement libératoire, and net income. It scopes the years covered (2025, 2026) and names the adjacent tool (list_france_calculators) for full schema, making it distinguishable from france_income_tax and france_gross_to_net_salary.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives an explicit use-when clause ('Use when a user asks how much URSSAF contributions an auto-entrepreneur owes...'), including the ACRE, net-income, and VAT questions. It also lists when NOT to use it, naming the refused situations (mixed activities, furnished rentals, overseas departments, ACRE in 2025, etc.) that return HTTP 422. Nothing about routing is left to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources