# MCP finance personnelle : simuler son patrimoine avec une IA {#doc-mcp-finance-personnelle}

> **Patriboum** est un serveur **MCP de finance personnelle** : il transforme
> votre assistant IA (Claude, Cursor, ZCode, Windsurf, VS Code, Gemini CLI) en
> ingénieur patrimonial doté d'un vrai moteur de calcul — fiscalité française
> appliquée année par année, 15 enveloppes (PEA, CTO, assurance-vie, PER, SCPI,
> immobilier, livrets…), Monte Carlo et visualisation en direct. Gratuit, sans
> inscription : une URL, `https://patriboum.com/mcp`.

## Qu'est-ce qu'un serveur MCP de finance personnelle ? {#definition}

MCP signifie **Model Context Protocol** : c'est le standard ouvert, publié par
Anthropic fin 2024, qui permet à une IA de se connecter à des outils externes.
Votre assistant ne se contente plus de parler — il *agit* : lire des données,
appeler des calculs, construire des objets.

Un **serveur MCP de finance personnelle**, c'est donc une IA à laquelle on
branché un moteur financier réel. Vous décrivez votre situation en français —
« j'ai 30 000 € sur un Livret A, 20 000 € en assurance-vie et je peux épargner
400 € par mois » — et l'agent construit votre bilan, simule votre patrimoine
sur 20 ou 30 ans, applique l'impôt à chaque étape et vous montre le résultat.
Sans tableur, sans formation, sans rendez-vous.

## Pourquoi la finance personnelle a besoin d'un moteur de calcul {#pourquoi}

Les grands modèles de langage sont excellents pour *expliquer* le PFU, le
fonctionnement d'un PEA ou les abattements de l'assurance-vie. Mais demandez-leur
de projeter un patrimoine sur 25 ans avec des versements mensuels, un prêt
immobilier, des SCPI et un krach boursier en année 8 : ils inventent. Les
multiplications glissent, les plafonds s'oublient, l'impôt est estimé « à la
louche » — et l'erreur se compose d'année en année.

Patriboum inverse la répartition des rôles :

- **l'IA comprend, structure et explique** : elle traduit votre situation en
  graphe patrimonial (comptes, flux d'épargne, scénarios) ;
- **le moteur calcule** : chaque année simulée passe par la vraie fiscalité —
  PFU 30,1 % sur un compte-titres, exonération d'IR du PEA après 5 ans,
  abattements et seuil des 150 k€ de primes en assurance-vie, PER déductible,
  plafonds des livrets réglementés, plus-values immobilières ;
- **le résultat est visualisé en direct** : l'IA partage un simple lien, et le
  bilan s'affiche dans le navigateur, rafraîchi pendant qu'elle travaille.

C'est la différence entre une IA qui *devine* et une IA qui *calcule*.

## Installer le MCP de finance personnelle en 2 minutes {#installation}

Aucun logiciel à installer, aucun compte à créer. Ajoutez le serveur distant
dans la configuration MCP de votre client :

```json
{
  "mcpServers": {
    "patriboum": {
      "url": "https://patriboum.com/mcp"
    }
  }
}
```

En ligne de commande (Claude Code) :

```bash
claude mcp add --transport http patriboum https://patriboum.com/mcp
```

Le guide détaillé client par client — Claude Desktop, Claude Code, Cursor,
ZCode, Windsurf, VS Code, Gemini CLI — est sur la page
[Installation](/installation).

## Ce que le serveur sait faire {#capacites}

Le serveur expose **25 tools** couvrant tout le cycle de conseil :

- **Bilan et construction** : création de sessions, ajout de comptes (PEA,
  PEA-PME, CTO, assurance-vie, PER, SCPI, immobilier locatif, résidence
  principale, livrets, crypto…), de holders, de stratégies d'épargne mensuelle
  (DCA) et de scénarios de comparaison ;
- **Simulation déterministe** : capital, revenus, impôts et frais année par
  année, détaillés par compte ;
- **Monte Carlo** : jusqu'à 10 000 trajectoires tirées de vraies années
  boursières (bootstrap historique), médiane et fourchettes p10/p90 —
  3 000 scénarios par défaut ;
- **Stress tests** : krach actions −35 % en année 8 puis décennie perdue, à
  rejouer dans n'importe quelle simulation ;
- **Analyse** : patrimoine net après impôt latent, répartition par liquidité,
  allocation par classe d'actifs, lecture en euros constants (inflation) ;
- **Capacité d'emprunt** : critères HCSF (taux d'effort 35 %, durée 25 ans,
  différé VEFA) pour un projet immobilier ;
- **Optimisation** : répartition optimale d'une épargne mensuelle entre
  enveloppes (recuit simulé).

## Un exemple de conversation {#exemple}

> **Vous** : « J'ai 35 ans, 25 k€ sur un Livret A, un PEA à 12 k€ et je peux
> mettre 500 € par mois. Simule sur 25 ans avec la vraie fiscalité, et montre
> ce que ça donne avec un krach en année 10. »

L'IA crée une session, construit le bilan (Livret A, PEA, versements mensuels),
lance la simulation — puis un Monte Carlo de 3 000 trajectoires avec le krach
programmé — et vous répond : capital médian net d'impôt latent, fourchette
p10–p90, loyers fiscaux manqués, mois d'autonomie de votre épargne liquide.
Et elle vous partage le lien où tout se visualise, courbes comprises.

## Pour qui ? {#pour-qui}

- **Épargnants** : comparez Livret A ou PEA, mesurez l'effet réel de l'impôt,
  testez votre plan de retraite — en parlant, sans tableur ;
- **Conseillers et ingénieurs patrimoniaux** : construisez le bilan du
  rendez-vous en direct, hypothèses explicites et résultats auditables ;
- **Développeurs et curieux d'IA** : un MCP français complet, sans clé d'API,
  pour expérimenter ce que devient la finance personnelle augmentée.

## Limites et avertissement {#limites}

Patriboum est un outil de **simulation à vocation pédagogique**. Les
projections reposent sur des hypothèses que vous choisissez : elles ne
constituent pas un conseil en investissement. Le serveur est public et
rate-limité, les sessions sont accessibles par leur UUID — ne saisissez pas de
données sensibles. Détails sur la page [Mentions légales](/mentions-legales).

## Aller plus loin {#aller-plus-loin}

- [Installer Patriboum](/installation) — les 7 clients supportés, pas à pas ;
- [Documentation complète du MCP](/docs) — référence des 25 tools et des types
  de nœuds ;
- [API HTTP](/api-http) — les mêmes opérations en REST, sans client MCP ;
- [Simulateurs en ligne](/simulateurs) — 34 simulateurs gratuits sans IA, du
  premier versement au FIRE.
