Référence MCP / Ressources de référence

Ressources de référence

Le serveur MCP Normi expose 5 ressources en lecture seule. Un client les charge une fois par session au lieu de redemander ces règles au modèle ou de les redécouvrir par un appel d'outil payant.

Gratuites et sans données personnelles
Lire une ressource ne consomme aucun crédit : seuls les appels d'outils (tools/call) sont décomptés. Aucune ressource ne contient de donnée propre à votre compte. Les réponses portent une indication de cache d'une heure.

Couverture et fraîcheur des données

normi://reference/datasets

Les jeux de données servis (DVF, DPE, BDNB, SIRENE, Filosofi, ANIL), leur couverture et leur rythme de publication. data_as_of est la date de la dernière vente DVF, lue en base : comptez vos fenêtres à partir d'elle, pas d'aujourd'hui.

Orthographe des communes et arrondissements

normi://reference/communes

Comment DVF stocke les noms de communes (majuscules, sans accents, tirets conservés), et les arrondissements de Paris, Lyon et Marseille avec leur nom stocké, leur code INSEE et leur code postal.

Indicateurs qualité

normi://reference/data-quality

Ce que signifient is_bulk_sale, is_price_outlier et is_vefa, les règles qui les posent, et ce que retire exclude_bulk_sales.

Échelle DPE

normi://reference/dpe-scale

Les seuils A à G (énergie primaire et émissions de gaz à effet de serre), la définition d'une passoire thermique et le calendrier d'interdiction de location.

Coût en crédits par outil

normi://reference/tool-costs

Le nombre de crédits de chaque outil, pour qu'un agent budgète ses appels avant de les lancer.

Lire une ressource

Dans Claude Desktop ou Claude Code, les ressources se joignent à la conversation depuis le menu du serveur Normi. Un client MCP les liste avec resources/list et les lit avec resources/read :

// Requête JSON-RPC (POST /mcp)
{ "jsonrpc": "2.0", "id": 1, "method": "resources/read",
  "params": { "uri": "normi://reference/datasets" } }

// Extrait de la réponse (contents[0].text, application/json)
{
  "dvf": {
    "name": "Demandes de valeurs foncières (DGFiP)",
    "first_year": 2014,
    "data_as_of": "2025-12-31",
    "cadence": "Published once a year. …"
  },
  "dpe": { "cadence": "Refreshed monthly" }
}