Home › Pour les agents
Ce site publie une porte machine : un agent peut lire le jeu sans deviner la page.
Porte machine8/9
Ce n'est pas un label : chaque ligne pointe le fichier qui la prouve, et la seule qui manque est écrite aussi.
- servimanifeste versionné
- servischéma des champs, avec taux de remplissage
- serviéchantillon réel, lu dans un fragment servi
- servioutils déclarés et servis
- servitéléchargement de masse gratuit
- serviserveur MCP appelable
- servillms.txt
- servipage 404 propre
- absentjournal des visites d'agent sur CE site
Exemple de bout en bout
Le numéro 1200300001520, pris dans l'échantillon réel du registre. Un agent branché au serveur MCP envoie :
POST https://mcp-registres.cloudflare33-7aa.workers.dev/mcp
{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"resolve_code","arguments":{"registre":"codice-ape","code":"1200300001520"}}}et reçoit cette fiche :
| codice | 1200300001520 |
|---|---|
| data_deposito | 2020-02-26 |
| comune | Angera |
| istat | 12003 |
| classe | F |
| ep_gl_nren | 191.77 |
| ep_gl_ren | 0 |
| emissioni_co2 | 36.49 |
| superficie | 111.9 |
| epoca_costruzione | 1968 |
| zona_climatica | E |
| destinazione | E.1(1) |
| motivo | Passaggio di proprietà |
| vettore | Gas naturale |
| impianto | Generatore a combustione |
| anno_impianto | 2017 |
| potenza_kw | 26 |
| classe_raggiungibile | — |
| ep_raggiungibile | — |
| interventi | Fabbricato - involucro opaco:20 |
| edificio_simile_nuovo | B (57,85) |
| nzeb | — |
Sans le serveur : FNV-1a 32 bits de 1200300001520, modulo 2999, donne 0 — la fiche est dans /d/0.json, sur la ligne qui commence par ce numéro.
Exemple calculé à la génération du site sur une ligne réelle — aucune valeur n'est écrite à la main.
Les fichiers
| Outils | /api/v1/tools.json |
|---|---|
| Manifeste | /api/v1/manifest.json |
| Extrait | /api/v1/echantillon.json |
Outils servis
describe_datasetget_sampleresolve_codeget_schemarequest_datasetexport_dataset
Réservés
Ces chemins existent et répondent statut: reserve. ⚠️ Ils disent ce qu'on n'a pas plutôt que de rendre un 404.
changes_since— réservé
⚠️ Les pages HTML et les outils qui les lisent sont gratuits et le restent. Seule la couche fabriquée — réconciliation, croisement, historique — peut être tarifée.
Le niveau de service, et sa limite
Le règlement (UE) 2023/138 oblige les États à publier certains jeux — dits à haute valeur — gratuitement, en format machine, avec API et téléchargement de masse. Nous appliquons ce niveau de service à tout ce que nous publions, y compris à ce que la loi n’oblige pas.
⚠️ Ce registre n’est pas présenté comme un jeu à haute valeur au sens du droit. C’est un niveau de service que nous nous imposons, pas une garantie réglementaire — et le téléchargement de masse reste gratuit chez la source officielle, nommée sur ce site.
Un seul serveur MCP pour tout le portefeuille
Les outils de ce registre sont appelables par le protocole MCP, sous son nom, depuis un point d’entrée unique : https://mcp-registres.cloudflare33-7aa.workers.dev/mcp. Un client ajoute un connecteur et obtient tous les registres publiés, pas seulement celui-ci.
⚠️ Sans ce serveur, le résolveur de ce registre serait muet pour l’extérieur : un agent devrait réimplémenter notre fonction de hachage pour savoir quel fragment lire. ⛔ Et un serveur MCP distant s’ajoute à la main dans le client : il rend ce registre appelable, il ne le rend pas trouvable. Mode d’emploi.
Ce registre figure au catalogue registres.pages.dev.