Services publics
Search and reverse-geocode French addresses via the BAN read-only connector.
chercher_adresse: search addresses withqand optional filters (city, address type, INSEE/postal/department codes, result limit) and get coordinates plus suggested matches.adresse_depuis_position: find nearby addresses from latitude/longitude, optionally with a search geometry and other filters.Both tools are keyless, read-only, and locally limited to 40 calls/second (source limit: 50 calls/second/IP).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Services publics Quels sont les jours fériés en 2025 en France ?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Services publics NexAura
Tu peux consulter huit API publiques françaises et internationales, sans clé. Les conditions de chaque source restent applicables. Les outils sont fabriqués avec FastMCP.from_openapi depuis des descriptions locales : aucun outil métier n'est écrit à la main.
Installer et lancer
Depuis ce dossier, avec Python 3.11 ou plus récent :
python3 -m venv .venv && .venv/bin/pip install --require-hashes -r requirements.lock && .venv/bin/pip install --no-deps --no-build-isolation .
.venv/bin/python -m nexaura_services_publics adresseRemplace adresse par le nom d’un connecteur du tableau ci-dessous. Le serveur échange par l'entrée et la sortie standard ; ses messages techniques restent sur la sortie d'erreur.
Aucune description n'est téléchargée au démarrage. Les fichiers specs/ et connecteurs/ sont inclus dans la distribution Python.
Verrou des dépendances
Version 0.1.2 : les dépendances d'exécution, directes et transitives, sont figées avec leurs empreintes SHA-256 dans requirements.lock. Le verrou inclut aussi setuptools et wheel, décrits dans requirements-build.in. Seules les roues binaires sont acceptées : aucune compilation de dépendance ne peut télécharger d'autres outils.
L'option --no-deps empêche la résolution des dépendances du paquet local ; --no-build-isolation empêche pip de télécharger des outils de construction dans un environnement séparé. Les deux sont nécessaires. Après le clonage, choisir le commit approuvé avant d'exécuter ces commandes ; ne pas installer depuis une branche mouvante. Le verrou protège les téléchargements, pas l'authenticité du dépôt ou du commit choisi.
Pour régénérer depuis ce dossier avec l'outil libre uv (version utilisée : 0.12.13) :
uv pip compile pyproject.toml requirements-build.in --universal --generate-hashes --python-version 3.11 --only-binary=:all: --emit-build-options -o requirements.lockCette commande conserve les versions déjà verrouillées. Pour les mettre à jour volontairement, ajouter --upgrade, reporter les versions directes avec == dans pyproject.toml, puis régénérer et vérifier le changement. Examiner les différences avant de publier le nouveau commit.
Le verrou est résolu avec les marqueurs de plateforme et de version Python. Les empreintes ont été comparées aux fichiers publiés sur PyPI : toutes les empreintes de chaque version sont présentes, y compris les roues compatibles CPython 3.11, 3.12 et 3.13 sur Linux x86_64 (glibc, manylinux jusqu'à 2.28) et macOS arm64 (macOS 14). Ce contrôle des fichiers ne remplace pas une exécution sur ces machines. Alpine/musl, Windows et les autres architectures ne sont pas validés.
Related MCP server: eu-company-mcp-server
Les huit connecteurs
Connecteur | Source | Outils |
| Géoplateforme / BAN |
|
| API Geo |
|
| Etalab |
|
| Éducation nationale |
|
| DILA / BODACC |
|
| Commission européenne / VIES |
|
| OpenHolidays API |
|
| Frankfurter |
|
Outils disponibles
Chaque outil se déclare en lecture seule (readOnlyHint).
adresse
Outil | Ce qu’il fait | Limite |
| Cherche une adresse avec q et renvoie ses coordonnées et les adresses proposées. | 50 appels/seconde/IP ; ce connecteur se limite à 40 appels/seconde. |
| Donne lon et lat : tu reçois les adresses proches de cette position. | 50 appels/seconde/IP ; ce connecteur se limite à 40 appels/seconde. |
Données : Licence Ouverte 2.0 (BAN, index address uniquement). Licence et source. Quota.
geo
Outil | Ce qu’il fait | Limite |
| Cherche avec nom ou codePostal : tu reçois les communes correspondantes. | 50 appels/seconde/IP ; ce connecteur se limite à 40 appels/seconde. |
| Donne un code INSEE : tu reçois les informations de cette commune. | 50 appels/seconde/IP ; ce connecteur se limite à 40 appels/seconde. |
| Consulte les départements : tu reçois leurs noms et codes. | 50 appels/seconde/IP ; ce connecteur se limite à 40 appels/seconde. |
| Consulte les régions : tu reçois leurs noms et codes. | 50 appels/seconde/IP ; ce connecteur se limite à 40 appels/seconde. |
Données : Licence Ouverte 2.0 (données administratives INSEE) ; sources géographiques sous licences Open Data. Licence et source. Quota.
jours-feries
Outil | Ce qu’il fait | Limite |
| Choisis une zone et une année : tu reçois les dates et les noms des jours fériés. | quota officiel non communiqué ; cadence locale de 1 appel/seconde. |
Données : Licence Ouverte 2.0. Licence et source. Quota.
calendrier-scolaire
Outil | Ce qu’il fait | Limite |
| Consulte les vacances du calendrier scolaire officiel pour ta zone et ton année scolaire. Dans where, écris par exemple : zones = 'Zone A' AND annee_scolaire = '2026-2027' ; tu reçois les périodes et académies, parfois répétées. | quota officiel non communiqué ; cadence locale de 1 appel/seconde. |
Données : Licence Ouverte 2.0. Licence et source. Quota.
bodacc
Outil | Ce qu’il fait | Limite |
| Donne | Quota officiel non communiqué ; 1 appel/seconde, 20 annonces au maximum par appel (20 par défaut). |
Données : Licence Ouverte / Open Licence (fr-lo), fiche DILA. Le jeu annonces-commerciales est fixé dans le chemin ; registre et dateparution sont les vrais champs vérifiés dans les métadonnées officielles. Le filtre natif exige exactement un SIREN de neuf chiffres. order_by est fixé à dateparution DESC ; offset permet la suite, entre 0 et 9980, sans pagination automatique. Aucune recherche générique sur d’autres jeux.
tva-europe
Outil | Ce qu’il fait | Limite |
| Donne | 1 appel/seconde, une requête à la fois ; une seule relance après 3 s sur |
| Consulte la disponibilité de VIES et des services nationaux. | Même limite partagée avec la vérification. |
Quota officiel chiffré non communiqué. Pour la France, le nom et l’adresse reviennent souvent vides : tu obtiens surtout « valide » ou « non valide » (isValid sur le GET). Une erreur ou une indisponibilité n’est jamais un verdict « non valide ». Les erreurs restent des réponses de la source, sans faux résultat. Le verrou couvre la réponse entière, l’attente de 3 s et la seconde tentative, pour tous les outils d’un même serveur. Aucune autre relance, même sur délai d’attente ou erreur HTTP seule.
Données : conditions VIES et droits des administrations nationales, sans licence ouverte uniforme annoncée. Description OpenAPI 3.0 écrite par NexAura d’après la documentation officielle ; la description Swagger désormais liée par cette documentation décrit la vérification en POST, pas le GET demandé ici. Aucun POST n’est exposé.
jours-feries-europe
Outil | Ce qu’il fait | Limite |
| Jours fériés du pays : | Trois ans au maximum ; quota officiel non communiqué, cadence locale de 1 appel/seconde. |
| Vacances scolaires avec les mêmes paramètres. | Même période maximale et cadence partagée. |
| Pays disponibles. | Même cadence partagée. |
| Régions pertinentes du pays | Même cadence partagée. |
Données OpenHolidays API (ODbL). Licence ODbL-1.0 des données ; FAQ : accès gratuit, usage commercial autorisé. Aucun quota chiffré annoncé sur la page d’accueil ni dans la FAQ : 1/s est une cadence locale, sans garantie de quota journalier. Attribution à conserver ; les obligations ODbL s’appliquent à la réutilisation, notamment au partage des bases dérivées.
Les quatre outils demandent languageIsoCode: FR par défaut ; tu peux choisir une autre langue ISO 639-1. Le français n’est pas disponible pour tous les pays ; les traductions dépendent de la source. Les régions renvoyées sont celles pertinentes pour les calendriers, sans promesse d’exhaustivité administrative. La couverture varie par pays et type de calendrier ; ce connecteur comprend aussi les pays hors Europe disponibles dans la source.
Description officielle OpenAPI 3.0.4 conservée intacte. Elle exige les deux dates mais n’exprime pas leur écart maximal : la documentation des erreurs confirme la limite de trois ans. Le transport vérifie les dates civiles, leur ordre et cette durée avant réseau, y compris les années bissextiles. Aucun filtre de groupe ni outil mondial par date n’est exposé.
taux-de-change
Outil | Ce qu’il fait | Limite |
| Choisis | 1 appel/seconde ; cibles obligatoires, pas de séries de dates. |
| Choisis | Même cadence partagée. |
| Consulte les devises ; | Même cadence partagée. |
Taux de référence indicatif, pas un cours de banque. Sans date, tu reçois le dernier taux disponible, qui peut dater d’un jour ouvré précédent. Frankfurter annonce l’absence de quota journalier ou mensuel, avec protection contre les abus ; le connecteur limite sa cadence à 1 appel/seconde. Les champs providers, from, to, group et expand sont exclus ; aucun outil de fournisseurs n’est exposé. Les devises cibles sont requises aussi dans le transport HTTP, pas seulement dans le schéma MCP.
Données : taux agrégés Frankfurter librement utilisables, y compris commercialement. Pas de licence de données distincte nommée ; MIT concerne le code. Les requêtes directes aux fournisseurs sont exclues de ce connecteur.
Brancher dans Hermès
Dans ta configuration Hermès, remplace chaque chemin /chemin/absolu/services-publics/.venv/bin/python par celui de ton installation. Tu peux garder les huit entrées ou seulement celles qui t'intéressent.
mcp_servers:
services-publics-adresse:
command: /chemin/absolu/services-publics/.venv/bin/python
args: ["-m", "nexaura_services_publics", "adresse"]
tools:
include: [chercher_adresse, adresse_depuis_position]
services-publics-geo:
command: /chemin/absolu/services-publics/.venv/bin/python
args: ["-m", "nexaura_services_publics", "geo"]
tools:
include: [chercher_communes, commune_par_code, departements, regions]
services-publics-jours-feries:
command: /chemin/absolu/services-publics/.venv/bin/python
args: ["-m", "nexaura_services_publics", "jours-feries"]
tools:
include: [jours_feries]
services-publics-calendrier-scolaire:
command: /chemin/absolu/services-publics/.venv/bin/python
args: ["-m", "nexaura_services_publics", "calendrier-scolaire"]
tools:
include: [vacances_scolaires]
services-publics-bodacc:
command: /chemin/absolu/services-publics/.venv/bin/python
args: ["-m", "nexaura_services_publics", "bodacc"]
tools:
include: [annonces_entreprise]
services-publics-tva-europe:
command: /chemin/absolu/services-publics/.venv/bin/python
args: ["-m", "nexaura_services_publics", "tva-europe"]
tools:
include: [verifier_tva, etat_service_tva]
services-publics-jours-feries-europe:
command: /chemin/absolu/services-publics/.venv/bin/python
args: ["-m", "nexaura_services_publics", "jours-feries-europe"]
tools:
include: [jours_feries, vacances_scolaires_europe, pays, regions_du_pays]
services-publics-taux-de-change:
command: /chemin/absolu/services-publics/.venv/bin/python
args: ["-m", "nexaura_services_publics", "taux-de-change"]
tools:
include: [taux_de_change, taux_entre_devises, devises_disponibles]Calendrier scolaire : filtre natif
L'outil officiel de consultation prend un filtre where. Il reste exposé tel quel, avec une forme limitée à une zone et une année scolaire :
{"where": "zones = 'Zone A' AND annee_scolaire = '2026-2027'", "limit": 100, "offset": 0}Utilise Zone A, Zone B, Zone C, ou le libellé exact de la zone publié par le ministère (Corse et outre-mer). L'outil ne traduit pas les noms des territoires. La présence de chaque zone et de chaque année dépend du jeu officiel : une réponse vide ne prouve pas l'absence de vacances.
Le jeu est fixé à fr-en-calendrier-scolaire dans le chemin ; tu ne peux pas consulter d'autres jeux. Les périodes peuvent se répéter par académie. La réponse conserve les enregistrements officiels sans les fusionner.
Si tu veux deux champs simples zone et annee_scolaire, il faut soit une description officielle spécialisée, soit autoriser une petite adaptation manuelle. Ici, aucun faux paramètre ni conversion maison en requête n'est ajouté.
Limites connues
Les quotas de l'Adresse et de Geo sont de 50 appels/seconde/IP ; chaque processus espace ses appels à 40/seconde, sans rafale. Les fiches data.gouv des deux calendriers donnent
rate_limiting: null: quota officiel non communiqué, cadence locale prudente de 1/seconde. Aucun quota journalier n'est connu. Plusieurs processus ou logiciels sur la même IP doivent partager ce budget de leur côté.Chaque connecteur ne contacte que sa base HTTPS fixe, en GET, sur les chemins autorisés. Pas de redirection ni de proxy hérité de l'environnement ni de vérification de mise à jour FastMCP. Seule exception aux appels sans relance : VIES, pour les deux codes documentés ci-dessus. Délai d'attente HTTP : 15 secondes par phase (comportement httpx), pas une échéance totale de l'opération ; l'attente du limiteur s'y ajoute.
Adresse reste sur l'index BAN
address. Geo demande du JSON et une géométrie de centre par défaut ; tu peux demander un contour explicitement si le paramètre officiel le permet.Au-delà de 200 000 octets décompressés, la lecture s'arrête. Tu reçois une enveloppe JSON avec
avertissement: réponse tronquéeet unextraitUTF-8. Cet extrait est du texte, pas un objet JSON partiel utilisable comme une réponse complète. L'enveloppe elle-même reste sous 200 Ko ; réduis la recherche ou consulte la page suivante.Calendrier scolaire : 100 enregistrements par défaut, pas de pagination automatique. Si
total_countdépasse le nombre renvoyé, utiliseoffset. Les autres filtres génériques de l'API sont retirés de cet outil.Aucun schéma de sortie MCP : les descriptions publiques sont imprécises. Les réponses JSON sont conservées, y compris les valeurs nulles. FastMCP enveloppe les tableaux HTTP dans
result.data["result"]côté client Python.Normalisations de syntaxe avant fabrication : codes HTTP YAML numériques convertis en chaînes ; le type non standard
anyde la description Éducation devient un schéma libre{}. Les originaux restent intacts. Geo, fourni en Swagger 2.0, a été converti avec swagger2openapi 7.0.8 ; Éducation est déjà en OpenAPI 3.0.3.Tests réels : seule la zone A 2026-2027 a été vérifiée pour le calendrier scolaire ; Corse et outre-mer ne sont pas vérifiés. Les réponses dépendent de la disponibilité et des données de chaque éditeur.
Deux avertissements de dépréciation Authlib peuvent apparaître avec les dépendances transitives actuelles ; les dépendances directes et transitives sont désormais verrouillées avec leurs empreintes.
Les URL, dates, empreintes et commandes de conversion sont dans specs/SOURCES.md. Le code est sous licence MIT, les données gardent leur propre licence.
Vérifier
Les outils de test sont séparés du verrou d'installation :
uv pip compile pyproject.toml --extra test --constraint requirements.lock --generate-hashes -o /tmp/services-publics-tests.lock
.venv/bin/pip install --require-hashes -r /tmp/services-publics-tests.lock
.venv/bin/python -m pytest -q
BANC_RESEAU=1 .venv/bin/python -m pytest -q -m reseauLe premier passage n’accède pas au réseau et saute les huit tests réels. Le second fait un appel d’outil par connecteur : adresse Ségur, Paris 75056, jours fériés métropole 2026, vacances zone A 2026-2027, BODACC SIREN 444608442, VIES FR 40444608442 (forme de réponse et booléen, aucun verdict imposé), jours fériés OpenHolidays BE du 2026-01-01 au 2026-12-31 et EUR vers CHF. Pas de pagination ; seule VIES peut faire une seconde requête dans les deux cas prévus. Les autres outils sont vérifiés avec des réponses simulées, pas par des appels réels. Les cadences et le verrou sont locaux à un serveur : plusieurs processus doivent coordonner leur budget.
Pour vérifier uniquement OpenHolidays (un seul appel GET, sans relance) :
BANC_RESEAU=1 .venv/bin/python -m pytest -q -m reseau -k europeLe cas réseau TVA porte l’identifiant vies pour que ce filtre ne contacte qu’OpenHolidays.
Vérification 0.1.2 (27 octobre 2026), copies et environnements neufs hors du dépôt, macOS arm64 : installation avec empreintes, construction locale sans réseau et pip check réussis sous Python 3.11.15 et 3.14.6. python -m pytest -q : 101 réussis, 8 ignorés, 2 avertissements Authlib, pour chacun. Les huit appels réels sont ignorés (BANC_RESEAU=0). Python 3.12/3.13 et Linux n'ont pas été exécutés ; leurs roues et empreintes ont été contrôlées.
Available Tools
2 toolsadresse_depuis_positionB
Donne lon et lat : tu reçois les adresses proches de cette position. Limite : 50 appels/seconde/IP ; ce connecteur se limite à 40 appels/seconde.
Inputs: lat, lon, city, type, +14 more.
chercher_adresseB
Cherche une adresse avec q et renvoie ses coordonnées et les adresses proposées. Limite : 50 appels/seconde/IP ; ce connecteur se limite à 40 appels/seconde.
Inputs: q, lat, lon, city, +16 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools cover complementary, non-overlapping directions: searching an address from a text query and reverse geocoding from coordinates. An agent can pick the right one unambiguously based on its input.
Both names are French and descriptive, but they mix conventions: chercher_adresse is verb-first while adresse_depuis_position is noun-first. Readable, yet no single predictable pattern.
Two tools is thin for a geocoding service, though each is a genuine primitive. It sits at the borderline where a bit more surface (e.g. batch or commune lookup) would help.
Forward and reverse geocoding covers the core of the domain with no dead ends for typical lookups. Minor gaps remain: no batch mode, no configurable result limits or filtering beyond the returned suggestions.
Maintenance
Related MCP Connectors
Independent platform exposing French official public territorial data through read-only MCP tools.
Official public & government APIs, dozens of countries: registers, statistics, open data. Keyless.
380+ live data, validation and utility APIs in one MCP server: IP, DNS, email, FX, weather and more.
One MCP endpoint over 69 public PPN APIs: search_apis to discover, execute_api to call. Free tier.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAn MCP server that enables interaction with Datagouv APIs, primarily allowing users to search for up-to-date information about companies registered in France.11-
- AlicenseAqualityDmaintenanceMCP server for EU company and business data. 9 tools: company search (GLEIF, 2M+ entities), LEI lookup, corporate structures (parent/subsidiaries), trade register search, EU VAT validation (VIES), GDP, unemployment, inflation, and business demography (Eurostat). All APIs free, no keys required.96MIT
- FlicenseNot gradedqualityDmaintenanceProvides AI agents with access to French public registries including company records, property sale prices, housing energy performance, and short-term rental rates via MCP tools.-
- AlicenseAqualityCmaintenanceEnables MCP clients to look up French companies in official open data, retrieving identity, status, legal form, address, VAT number and latest published accounts from the API Recherche d'entreprises. Also surfaces BODACC legal announcements such as insolvency proceedings, deregistrations, accounts filings and modifications, with no API key and read-only access.3MIT