Les calculs de Calculons.fr, en API pour les agents IA
Les modèles de langue se trompent souvent sur les calculs français : un plafond oublié, un barème de l'an dernier, un arrondi au mauvais endroit. Les moteurs qui font tourner ce site sont publiés comme outil appelable par un agent IA ou par n'importe quel programme : vous envoyez des paramètres, vous recevez un résultat exact, ses sources officielles et la page qui l'explique.
- 14 calculateurs du droit du travail, de la fiscalité et de l'automobile, aux règles de 2026.
- Les mêmes moteurs que le site, avec dans chaque réponse la date des règles et les liens vers Légifrance, l'URSSAF, impots.gouv ou service-public.
- 0,005 $ par calcul réussi. Un appel mal formé n'est pas facturé et rend les champs attendus, pour que l'agent se corrige seul.
Les 14 calculateurs
L'outil est publié sur l'Apify Store sous le nom « French Payroll, Tax & Legal Calculators for AI Agents ». Chaque calculateur a un identifiant ; les noms des paramètres sont en français, comme sur une fiche de paie. La liste complète des paramètres, avec leurs valeurs permises, est sur la page de l'outil.
Depuis un agent IA (MCP)
L'outil est servi par le serveur MCP d'Apify. Ajoutez ce serveur à votre agent (Claude, ChatGPT, Cursor, un agent maison…) en limitant ses outils au nôtre, avec votre jeton Apify dans l'en-tête :
URL https://mcp.apify.com?tools=calculons/french-legal-tax-calculators
En-tête Authorization: Bearer VOTRE_JETON_APIFYL'agent voit alors l'outil, sa description et ses paramètres, et l'appelle quand une question demande un calcul français. Le configurateur d'Apify écrit la configuration pour la plupart des clients MCP.
Par HTTP
Un appel synchrone rend directement les résultats. Le jeton se trouve dans la console Apify, rubrique « API & Integrations ».
curl -X POST "https://api.apify.com/v2/actors/calculons~french-legal-tax-calculators/run-sync-get-dataset-items" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"calculator": "salary-gross-to-net",
"params": {"brutMensuel": 3000, "statut": "non-cadre", "tauxPas": 0.05}}'Réponse (produite par l'outil, à l'identique) :
[
{
"calculator": "salary-gross-to-net",
"ok": true,
"params": { "brutMensuel": 3000, "statut": "non-cadre", "tauxPas": 0.05 },
"summary": "Net before income tax 2,374.79 €/month, after tax 2,251.78 €/month (gross 3,000.00 €).",
"result": {
"brutMensuel": 3000,
"brutAnnuel": 36000,
"cotisationsSalariales": 625.21,
"netImposable": 2460.27,
"csgCrdsNonDeductible": 85.48,
"netAvantImpot": 2374.79,
"prelevementSource": 123.01,
"netApresImpot": 2251.78,
"tauxCharges": 0.2084,
"details": [
{ "label": "Sécurité sociale (vieillesse)", "montant": 219 },
{ "label": "Retraite complémentaire T1", "montant": 94.5 },
{ "label": "Contribution d'équilibre général (CEG)", "montant": 25.8 },
{ "label": "CSG déductible", "montant": 200.43 },
{ "label": "CSG/CRDS non déductible", "montant": 85.48 }
]
},
"rules": {
"verifiedOn": "2026 rules",
"sources": [
"https://www.urssaf.fr/accueil/employeur/cotisations/taux-baremes.html",
"https://www.legifrance.gouv.fr/codes/article_lc/LEGIARTI000038614887",
"https://www.impots.gouv.fr/portail/particulier/le-prelevement-la-source-pour-les-particuliers"
]
},
"page": "https://calculons.fr/calculateurs/salaire-brut-net",
"disclaimer": "Indicative calculation under French law as published on the date shown in \"rules\"; not legal, tax or financial advice. Engine of calculons.fr."
}
]Le champ summary donne le résultat en une phrase, prête à être reprise par un agent ; result donne le détail chiffré ; rules les sources et la date des règles ; page l'explication en français sur ce site.
Plusieurs calculs en un appel
Jusqu'à 500 calculs par appel, un prix par calcul réussi :
{
"calculations": [
{ "calculator": "income-tax", "params": { "revenuNetImposable": 60000, "conjoint": true, "enfants": 2 } },
{ "calculator": "notary-fees", "params": { "prix": 250000, "type": "ancien" } }
]
}Un appel mal formé (non facturé)
{
"calculator": "notary-fees",
"ok": false,
"params": { "prix": 250000, "type": "maison" },
"error": "\"type\" must be one of: ancien, neuf",
"expectedParams": [
"prix: number, purchase price in euros",
"type: \"ancien\" (existing property) | \"neuf\" (new build)",
"dmtoRate?: number, departmental transfer tax rate if not the standard one, e.g. 0.0632 (default: engine standard)"
],
"example": { "prix": 250000, "type": "ancien" }
}Prix
- 0,005 $ par calcul réussi, soit 5 $ les 1 000 calculs, plus 0,00005 $ par lancement (un lot de 500 calculs ne compte qu'un lancement).
- Les appels refusés pour un paramètre manquant ou faux ne sont pas facturés.
- La facturation passe par votre compte Apify. Sans jeton, l'API répond 402 et propose aussi le paiement à l'appel par le protocole x402 (documentation d'Apify).
- Les calculateurs du site restent gratuits pour tous, sans inscription : l'API sert aux programmes et aux agents.
Sources et entretien des barèmes
- Chaque moteur applique un texte officiel (code du travail, code général des impôts, code des impositions sur les biens et services, barèmes de l'URSSAF et de l'administration fiscale), cité dans chaque réponse.
- Les barèmes sont revus à chaque échéance, surtout en janvier (SMIC, plafond de la Sécurité sociale, loi de finances) et en avril (prestations) ; l'outil est reconstruit avec les moteurs du site à chaque révision. La date des règles appliquées figure dans
rules.verifiedOn. - Les montants sont les minimums légaux : les conventions collectives plus favorables ne sont pas appliquées.
- Ce sont des estimations, pas un conseil juridique, fiscal ou financier. Pour une réponse qui engage, les simulateurs officiels et les professionnels restent la référence.
Une erreur, un calculateur qui manque ?
Signalez-le par la page contact : une erreur est vérifiée contre la source et corrigée sur le site comme dans l'outil. Les calculateurs les plus demandés rejoindront l'API.