Expose l'InvestScore et les données immobilières françaises de BData X (DPE, valeur DVF, risques Géorisques, contexte socio-économique INSEE) comme outils MCP, utilisables directement dans Claude Desktop, Cursor, Cline, etc.

Chaque appel est payé automatiquement en USDC sur Base (protocole x402) depuis ton wallet — pas de compte, pas de carte, machine-to-machine.

Outils exposés

Outil	Paramètres	Prix	Renvoie
`investscore`	`adresse`, `loyerM2Mois?`	0,01 USDC	RendementScore (cash-flow) + SécuritéScore (risque + liquidité)
`dpe`	`adresse` ou `cp`	0,001 USDC	DPE + valeur DVF + risques + INSEE

Installation

1. Récupérer les dépendances

Dans un terminal, place-toi dans ce dossier et lance :

cd mcp-bdatax
npm install

2. Avoir un wallet Base avec un peu d'USDC

Le serveur paie chaque requête via x402. Il te faut :

un wallet sur le réseau Base (mainnet),
quelques USDC dessus (même 1 USDC = 100 appels InvestScore),
la clé privée de ce wallet.

⚠️ Utilise un wallet dédié avec un petit solde, jamais ton wallet principal. La clé privée donne un contrôle total sur le wallet.

3. Configurer le client MCP

Claude Desktop — édite le fichier de config :

Windows : %APPDATA%\Claude\claude_desktop_config.json
macOS : ~/Library/Application Support/Claude/claude_desktop_config.json

Ajoute (adapte le chemin absolu vers index.js et ta clé) :

{
  "mcpServers": {
    "bdatax-immo": {
      "command": "node",
      "args": ["C:\\Users\\User\\Documents\\dpe-x402\\mcp-bdatax\\index.js"],
      "env": {
        "BDATAX_WALLET_KEY": "0xTA_CLE_PRIVEE_ICI"
      }
    }
  }
}

Cursor — dans Settings → MCP, ajoute un serveur avec la même commande/args/env, ou édite ~/.cursor/mcp.json au même format.

Puis redémarre le client. L'outil bdatax-immo doit apparaître dans la liste des outils MCP.

Utilisation

Une fois installé, tu (ou n'importe quel utilisateur) demandes en langage naturel :

« Analyse l'investissement locatif au 12 rue de la Paix 75002 Paris »

Claude appellera l'outil investscore, le paiement partira automatiquement, et tu recevras les deux scores avec le détail.

Autres exemples :

« Quel est le DPE du 203 rue Saint-Honoré 75001 Paris ? » → outil dpe
« Compare le potentiel locatif de ces 3 adresses : … » → plusieurs appels investscore

Variables d'environnement

Variable	Rôle	Défaut
`BDATAX_WALLET_KEY`	Clé privée du wallet Base qui paie (requis)	—
`BDATAX_API_BASE`	URL de l'API	`https://dpe.bdatax.com`

Notes

Le serveur écrit ses logs sur stderr (stdout est réservé au protocole MCP).
Sans BDATAX_WALLET_KEY, les outils répondent un message expliquant qu'un wallet est requis (aucun crash).
Plafond de sécurité : 1 USDC maximum par appel.

BData X · Portfolio APIs · Machine Economy — https://bdatax.com