Serveur MCP (Model Context Protocol)

Expose trois outils pour les clients MCP compatibles Streamable HTTP (Cursor, Windsurf, extensions Claude, etc.).

Outils disponibles

• calculate_frais_notaire — paramètres : prix, departement, type (ancien/neuf/terrain), primo, mobilier, frais_agence. Retour JSON (total, DMTO, émoluments, etc.).
• get_departement_info — paramètre : code. Infos taux, région, lien vers la page département.
• compare_departements — paramètre : codes (tableau, max 25). Comparaison des taux DMTO.

Exemples JSON (même moteur que GET /api/calculate)

Côté protocole MCP, le résultat est une chaîne JSON dans content[0].text. La structure ci-dessous correspond au corps renvoyé par l'outil.

calculate_frais_notaire — arguments

{
  "prix": 250000,
  "departement": "75",
  "type": "ancien",
  "primo": false,
  "mobilier": 0,
  "frais_agence": 0
}

calculate_frais_notaire — résultat (extrait type)

{
  "total": 19524,
  "pourcentage": 7.81,
  "dmto": 15800,
  "tauxDMTOApplique": 6.32,
  "emoluments": 2874,
  "emolumentsFormalites": 200,
  "csi": 250,
  "debours": 400,
  "economieReforme": 0,
  "departement": { "code": "75", "nom": "Paris", "slug": "paris" }
}

get_departement_info — arguments

{ "code": "75" }

get_departement_info — résultat (type)

{
  "code": "75",
  "slug": "paris",
  "nom": "Paris",
  "region": "Île-de-France",
  "prefecture": "Paris",
  "tauxStandard": 5.81,
  "tauxApplique": 6.32,
  "hausseAppliquee": true,
  "pageUrl": "https://www.mesfraisnotaire.fr/frais-notaire-departement/paris",
  "noteSpecifique": "Paris a voté la hausse à 5,00 % … (texte complet sur la page département)"
}

compare_departements — arguments

{ "codes": ["75", "69", "13"] }

compare_departements — résultat (type)

{
  "departements": [
    {
      "code": "75",
      "nom": "Paris",
      "tauxStandard": 5.81,
      "tauxApplique": 6.32,
      "hausseAppliquee": true,
      "slug": "paris"
    }
  ]
}

Connexion (exemples)

Si votre client supporte l’URL MCP directe, ajoutez https://www.mesfraisnotaire.fr/api/mcp.

Pour un client en stdio uniquement, utilisez mcp-remote :

{
  "mes-frais-notaire": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://www.mesfraisnotaire.fr/api/mcp"]
  }
}

Alternative sans MCP

L'API REST GET /api/calculate expose le même moteur de calcul en JSON simple.