English Français العربية

Marcel

Official registry Other

Calcul fiscal et retraite français, déterministe et sourcé. Aucun conseil.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http marcel 'https://marcel-retraite.fr/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "marcel": {
            "type": "http",
            "url": "https://marcel-retraite.fr/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Marcel — serveur MCP
  2. Connexion
  3. Proxy local (stdio)
  4. Local proxy (stdio)
  5. Outils (11, tous en lecture seule)
  6. Limite d'appels
  7. Documentation
  8. Licence

Marcel — serveur MCP

Calcul fiscal et retraite français, déterministe et sourcé. Chaque résultat porte les règles appliquées (articles du CGI, du CSS), leur version et un traceId. Marcel mesure : il ne donne aucun conseil en investissement ni conseil fiscal.

French tax and retirement calculations for AI assistants. Deterministic, sourced, versioned. No financial advice.

Connexion

Serveur distant, sans clé, transport Streamable HTTP :

https://marcel-retraite.fr/mcp

Exemple de configuration (clients acceptant une URL distante) :

{
  "mcpServers": {
    "marcel": { "url": "https://marcel-retraite.fr/mcp" }
  }
}

Server card : https://marcel-retraite.fr/.well-known/mcp/server-card.json

Proxy local (stdio)

Ce dépôt est un proxy léger, sans calcul et sans secret. Au démarrage, un serveur MCP stdio se connecte en Streamable HTTP à l'endpoint distant (par défaut https://marcel-retraite.fr/mcp, remplaçable avec MARCEL_MCP_URL) et relaie tools/list et tools/call. Les prompts et les ressources sont relayés seulement si le serveur distant les expose. Les résultats sont informatifs, pas un conseil.

npx

Depuis GitHub, sans clone :

npx -y github:marcel-retraite/marcel-mcp

Exemple pour un client qui lance un processus :

{
  "mcpServers": {
    "marcel": {
      "command": "npx",
      "args": ["-y", "github:marcel-retraite/marcel-mcp"],
      "env": { "MARCEL_MCP_URL": "https://marcel-retraite.fr/mcp" }
    }
  }
}

Depuis une copie locale du dépôt :

npm install
npm run build
npx .

npm install lance aussi la compilation. node dist/index.js démarre le même serveur. La sortie standard est réservée au protocole MCP.

Docker
docker build -t marcel-mcp .
docker run -i --rm marcel-mcp

-i garde stdin ouvert. Pour viser un autre endpoint :

docker run -i --rm -e MARCEL_MCP_URL=https://marcel-retraite.fr/mcp marcel-mcp

Local proxy (stdio)

This repository is a thin proxy: no calculation logic and no secrets. On startup, a stdio MCP server connects with Streamable HTTP to the remote endpoint (default https://marcel-retraite.fr/mcp, override with MARCEL_MCP_URL) and forwards tools/list and tools/call. Prompts and resources are forwarded only when the remote server exposes them. Results are informative, not advice.

npx

From GitHub, without cloning:

npx -y github:marcel-retraite/marcel-mcp

Example for a client that spawns a process:

{
  "mcpServers": {
    "marcel": {
      "command": "npx",
      "args": ["-y", "github:marcel-retraite/marcel-mcp"],
      "env": { "MARCEL_MCP_URL": "https://marcel-retraite.fr/mcp" }
    }
  }
}

From a local checkout:

npm install
npm run build
npx .

npm install also builds. node dist/index.js starts the same server. Standard output is reserved for the MCP protocol.

Docker
docker build -t marcel-mcp .
docker run -i --rm marcel-mcp

-i keeps stdin open. To target another endpoint:

docker run -i --rm -e MARCEL_MCP_URL=https://marcel-retraite.fr/mcp marcel-mcp

Outils (11, tous en lecture seule)

OutilCe qu'il calcule
marcel_estimate_pensionPension de retraite brute ; net du foyer seulement si un RFR d'avis d'impôt est fourni
simulate_avFiscalité d'un contrat d'assurance-vie : rachat, avance, transmission (CGI 125-0 A, 990 I, 757 B)
simulate_peaFiscalité d'une sortie de PEA (CGI 157)
simulate_ctoFiscalité d'un compte-titres ordinaire personnel, une année (CGI 200 A, 158, 150-0 A et D)
simulate_per_sortieFiscalité d'une sortie de PER, en capital ou en rente
simulate_ifiIFI : assiette, barème, plafonnement (CGI 964 à 979)
simulate_dutreilTransmission d'entreprise : chemins avec et sans pacte Dutreil (CGI 787 B, 790)
acheter_louerAcheter ou louer sa résidence principale : écart de patrimoine dans le temps
simulate_cumulCumul emploi-retraite d'un salarié du régime général, règles avant et à partir de 2027
compare_resultsÉcart entre deux scénarios déjà calculés par Marcel
validate_resultsCohérence de plusieurs résultats Marcel entre eux

Règles en vigueur : LFSS 2026 (PFU 31,4 %, prélèvements sociaux 18,6 % ; assurance-vie à 17,2 %).

Limite d'appels

20 requêtes par minute et par adresse IP. Au-delà : HTTP 429, en-tête Retry-After, erreur JSON-RPC -32029. Détail : https://marcel-retraite.fr/developer#limites

Documentation

Licence

MIT pour le contenu de ce dépôt. Le service distant est fourni par Marcel ; ses résultats sont indicatifs et non contractuels.

Frequently asked questions

What is Marcel?

Calcul fiscal et retraite français, déterministe et sourcé. Aucun conseil.

How do I install Marcel?

It runs as a remote server. In Claude Code: claude mcp add --transport http marcel 'https://marcel-retraite.fr/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Marcel need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Marcel open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Marcel?

It is published by marcel-retraite. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.