# fiscal-engine — moteurs fiscaux francais verifiables

> Calcul d'impots francais avec tracabilite totale : chaque montant est
> justifie par une piece et un article. L'IA prepare le dossier, vous validez ;
> aucun chiffre n'est invente. Resultats auditables par un fiscaliste.

## Moteurs
- ifi : IFI 2026 (Impot sur la Fortune Immobiliere) — biens, parts de societes, passif deductible
- ir : IR (Impot sur le Revenu) — salaires, foncier, charges, quotient familial

## Installation par un agent (Claude Code ou equivalent avec shell)
1. Executer : curl -fsSL https://fiscal-engine.louisguthmann.com/install.sh | sh
2. Lancer : fiscal-engine connect — puis transmettre le lien http://127.0.0.1:...
   a l'HUMAIN, qui saisit le mot de passe dans la page locale.
   REGLE ABSOLUE : l'agent ne voit, ne demande, ne stocke JAMAIS le mot de passe.
3. La connexion validee renvoie status + la methodologie de demarrage : la suivre.

## Installation Claude Desktop (humain, sans terminal)
1. Telecharger https://fiscal-engine.louisguthmann.com/bundles/fiscal-engine.mcpb
2. Double-cliquer le fichier ; coller le mot de passe une fois (trousseau systeme).
3. Prompt de demarrage : Utilise le MCP fiscal-engine. Appelle d'abord ifi_get_started() (ou ir_get_started() pour l'impot sur le revenu) et suis exactement ce qu'il renvoie. Puis traite mon dossier a partir des pieces que je te donne.

## Utilisation (apres installation)
- Amorcage obligatoire : appeler ifi_get_started() ou ir_get_started() et suivre
  exactement ce qui est renvoye (methodologie servie par le serveur).
- Pipeline : pieces -> dossier prouve ligne par ligne -> *_validate_dossier
  (iterer jusqu'a would_block=false) -> *_liquidate_dossier ->
  *_dossier_audit_report(format='html').
- Jamais d'arithmetique cote agent ; jamais d'impot annonce sans status='completed'.

## Ressources machine
- https://fiscal-engine.louisguthmann.com/engines.json : catalogue des moteurs
- https://fiscal-engine.louisguthmann.com/version.json : versions publiees (bundle, CLI)
- https://fiscal-engine.louisguthmann.com/install.sh : installeur CLI
- https://fiscal-engine.louisguthmann.com/bundles/fiscal-engine.mcpb : bundle Claude Desktop (tous moteurs)
- Version courante du bundle : 1.0.0 ; CLI : 1.2.1

Les endpoints de calcul (/mcp, /dossier/*) exigent une authentification Basic
(utilisateur fiscaliste) ; le mot de passe est fourni par l'administrateur a
l'humain uniquement.