Aides sociales françaises MCP server

Serveur MCP - Aides sociales françaises

Ce service est une API/MCP pensée pour les développeurs et les agents IA qui l'intègrent dans leurs propres logiciels — pas un simulateur grand public à usage isolé. Elle calcule le RSA, la prime d'activité et l'aide au logement (APL/ALS/ALF) pour un foyer français, à partir de quelques informations simples : salaire, loyer, statut du logement, nombre d'enfants, situation de couple.

Le calcul est fait entièrement en local, avec la bibliothèque open source openfisca-france (le moteur officiel des barèmes sociaux français). Aucun appel n'est fait à l'API publique api.fr.openfisca.org ni à un autre service externe.

⚠️ Important : ce sont des estimations, pas des décisions officielles. Le calcul repose sur des hypothèses simplificatrices (âge des adultes supposé, situation stable sur les derniers mois, etc.). Seule la CAF ou la MSA peut donner un montant définitif et exact.

Crédits

Calculs effectués avec OpenFisca, moteur socio-fiscal libre et open source sous licence AGPL-3.0. Code source : github.com/openfisca/openfisca-france.

Adresse du serveur et accès

https://mcp-aides-sociales.onrender.com/mcp

Ce service est protégé par une clé d'accès (API key) : chaque appel doit la fournir, sinon le serveur refuse de répondre. Deux paliers, 100% self-service (aucune validation manuelle) :

Palier Free — inscription immédiate, sans carte bancaire :

curl -X POST https://mcp-aides-sociales.onrender.com/signup-free \
  -H "Content-Type: application/json" \
  -d '{"email": "vous@example.com"}'

Une clé (préfixe free_...) est envoyée par email. Le quota (50 requêtes/mois) se réinitialise automatiquement au début de chaque mois. Au-delà, le serveur répond 402 Payment Required avec un message invitant à passer au palier Standard — jamais une simple erreur sèche.

Palier Standard — après paiement de l'abonnement, une clé d'accès personnelle (illimitée) est envoyée automatiquement par email, et renouvelée à chaque paiement mensuel réussi.

Installer dans Claude Desktop

1. Ouvrez le fichier de configuration de Claude Desktop :

• Sur Mac : ~/Library/Application Support/Claude/claudedesktopconfig.json
• Sur Windows : %APPDATA%\Claude\claudedesktopconfig.json

1. Ajoutez (ou complétez) la section mcpServers ainsi :

{
  "mcpServers": {
    "aides-sociales-france": {
      "url": "https://mcp-aides-sociales.onrender.com/mcp",
      "headers": {
        "X-API-Key": "VOTRE_CLE_API"
      }
    }
  }
}

1. Remplacez VOTRECLEAPI par la clé qui vous a été transmise.
2. Redémarrez Claude Desktop.

Installer dans Cursor

ou le fichier ~/.cursor/mcp.json).

1. Ouvrez les réglages MCP de Cursor (Settings → MCP → Add new MCP server,

1. Ajoutez la même configuration que ci-dessus :

Shortened. The full README is on GitHub.