nyambot-mcp
Nyambot-MCP is a keyless MCP server wrapping French public APIs (geo.api.gouv.fr, Base Adresse Nationale, Géorisques, ADEME) into 4 decision-ready tools for real estate and location intelligence:
resolve_commune– Converts a commune name into its INSEE code, department, region, GPS coordinates, and population. Acts as the geographic anchor for downstream tools.geocode_address– Normalizes and geocodes a free-text French address via the Base Adresse Nationale, returning coordinates, postal code, commune, and INSEE code.risques_immobilier– Returns a full natural and technological risk profile for a commune (flooding, clay shrinkage, earthquakes, radon, landslides, industrial sites/ICPE, nuclear, etc.), accepting either an INSEE code or a free-text address. Essential before any real estate purchase.dpe_logement– Retrieves Energy Performance Certificates (DPE) from the ADEME database for existing housing by postal code, optionally filtered by address, returning energy label (A–G), GHG label, surface area, consumption, and diagnostic date.
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., "@nyambot-mcp Quels sont les risques immobiliers à Lyon ?"
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.
nyambot-mcp
La couche d'intelligence qui rend la donnée publique française exploitable par votre agent IA.
La donnée publique française est ouverte — mais brute, éparpillée sur des dizaines d'APIs, et illisible en contexte. Le vrai défi n'est pas d'y accéder, c'est de la comprendre : quel jeu de données, quelle colonne, quelle interprétation pour cette situation précise. C'est là que Nyambot intervient : un système d'intelligence qui fait ce travail à la place de votre agent — il interroge, croise, contextualise, et renvoie une réponse sourcée et directement exploitable, pas des lignes de CSV à parser.
Votre IA (Claude, ChatGPT, Le Chat…) ne connaît pas la France : seule, elle reformule ce qu'elle a lu, sans date ni source. Branchée à Nyambot, elle interroge les données de l'État à la seconde où vous posez la question — et cite ses sources.
▶ L'agent Nyambot complet est en ligne — essayez-le : nyambot.ai
Exemple : votre agent enchaîne
resolve_commune→risques_immobilier→dpe_logementet restitue un verdict argumenté sur un bien en quelques secondes — là où les APIs brutes ne renverraient que des tableaux à interpréter.
🧠 Des réponses, pas des rows. 1 appel = 1 réponse métier exploitable — sans savoir quel dataset ni quelle colonne interroger.
📎 Sourcé, sans hallucination. Chaque réponse porte sa source officielle (date, référence, montant).
🆓 Gratuit, sans clé API pour ce cœur open-source — installation en une ligne via
uvx.📖 Open-source, licence MIT.
Ce package = le cœur open-source keyless (4 outils, en local). Pour la version complète — 21 outils (marché immobilier DVF réel, Légifrance, SIRENE, fiches Service-Public, aides…), réponses answer-ready et sourcées : le connecteur hébergé est en ligne →
https://mcp.nyambot.ai/mcp(OAuth 2.1). Intégration backend / serveur-à-serveur (clés machine) sur demande. Détails plus bas.
Pourquoi Nyambot — le game changer
En France, des milliards d'euros de droits ne sont pas réclamés chaque année — pas par manque d'éligibilité, mais parce que l'administration est un labyrinthe. Le problème n'a jamais été l'accès à la donnée (elle est publique) : c'est de la comprendre correctement, en contexte, sans se tromper. C'est exactement le travail que fait la couche d'intelligence de Nyambot — et c'est ce qu'un accès brut aux APIs ne vous donnera jamais.
Nyambot.ai est un agent IA qui ne se contente pas d'informer : il exécute les démarches, ancré sur la donnée officielle de l'État, chaque réponse sourcée, sans hallucination. Là où un chatbot générique invente et où les portails publics n'accompagnent pas, Nyambot agit.
Il couvre tous les cas de vie — carte d'identité, impôts, permis de conduire, carte grise, aides & allocations, déménagement, succession, création d'entreprise, immobilier… nyambot-mcp ouvre une partie de cette capacité à votre propre agent IA.
L'immobilier, déroulé en direct
Sur l'agent complet (nyambot.ai), une question comme « Cette maison à Pierrelatte à 286 000 € est-elle bien placée ? » déclenche une analyse visible étape par étape — l'agent va chercher le fichier DVF, le déroule, et le croise avec les risques et le DPE :
📊 DVF — Demandes de valeurs foncières (data.gouv.fr)
Requête : commune = Pierrelatte (26235) · type = Maison · 2023–2024
→ 38 ventes comparables · médiane du secteur ≈ 2 053 €/m²
⚠️ Géorisques : aléa retrait-gonflement des argiles (moyen)
🏷️ DPE du bien : étiquette AVerdict : à ~2 750 €/m², le bien est ~34 % au-dessus de la médiane locale (source DVF, 38 ventes comparables) — justifiable par le DPE A, mais avec une marge de négociation. Point de vigilance : zone d'aléa argiles à vérifier sur le bâti.
Va chercher la donnée officielle, la déroule, la croise, et cite ses sources — en quelques secondes. Aucun chatbot générique ne fait ça.
La v2 est en ligne. Le connecteur hébergé mcp.nyambot.ai/mcp ouvre l'accès à toute la donnée publique française vivante — démarches administratives, prix de l'immobilier au m² réel (DVF), textes de loi (Légifrance), données d'entreprises (SIRENE) — déjà indexée, citable, prête à l'emploi.
L'accès programmatique à DVF, au RAG des fiches Service-Public et aux sources sémantiques est disponible dès maintenant sur le connecteur hébergé (voir plus bas). Le connecteur gratuit ci-dessous couvre communes, géocodage, risques et DPE — en local, sans clé.
Related MCP server: geocontext
Outils disponibles
Outil | Ce qu'il fait | Source officielle |
| Nom de commune → code INSEE, département, région, coordonnées, population | geo.api.gouv.fr |
| Adresse → coordonnées, code postal, commune, code INSEE | Base Adresse Nationale |
| Risques naturels & technologiques d'une commune (inondation, argiles, séisme, radon…) | Géorisques |
| DPE des logements existants (étiquette A→G, GES, surface, conso) | ADEME |
En quoi est-ce différent du MCP officiel data.gouv ?
Le serveur MCP de data.gouv.fr et nyambot-mcp ne jouent pas au même niveau — ils sont complémentaires :
datagouv-mcp expose le catalogue open-data : on cherche des jeux de données, on liste des ressources, on requête du tabulaire brut. C'est un outil d'exploration / analyste de données.
nyambot-mcp expose des réponses métier prêtes à l'emploi : on pose une question (risques d'une commune, DPE d'un logement…) et on reçoit un résultat exploitable, sans savoir quel dataset ni quelle colonne. C'est un outil de décision.
datagouv-mcp (officiel) | nyambot-mcp | |
Niveau | Catalogue & datasets bruts | Réponses métier curées |
Sources | data.gouv.fr uniquement | Multi-sources : Géorisques, BAN, geo.api.gouv.fr, ADEME… (API natives, hors catalogue data.gouv) |
L'agent doit… | trouver le dataset, deviner les colonnes, construire la requête | …juste appeler l'outil |
Cas d'usage type | « trouve-moi des datasets sur X » | « ce bien est-il à risque ? quel est son DPE ? » |
Fiabilité | dépend du schéma deviné | pré-câblé : 1 appel = 1 réponse |
Vous pouvez brancher les deux. datagouv-mcp pour explorer n'importe quel dataset ; nyambot-mcp pour des réponses rapides sur les cas de vie à forte valeur (immobilier, droits…). Le connecteur hébergé (
mcp.nyambot.ai/mcp, en ligne) ajoute l'interprétation propriétaire : RAG des fiches Service-Public, article Légifrance exact, marché DVF réel, réponses entièrement sourcées.
Installation
Prérequis
uv installé (recommandé). Sinon, voir « Depuis les sources » plus bas.
Claude Desktop
Ajoutez ceci à votre claude_desktop_config.json :
{
"mcpServers": {
"nyambot": {
"command": "uvx",
"args": ["nyambot-mcp"]
}
}
}Puis redémarrez Claude Desktop. uvx télécharge et lance le serveur automatiquement — rien d'autre à installer.
Claude Code
Dans le .mcp.json à la racine de votre projet :
{
"mcpServers": {
"nyambot": { "command": "uvx", "args": ["nyambot-mcp"] }
}
}Ou en une commande :
claude mcp add nyambot -- uvx nyambot-mcpCursor / VS Code / Windsurf
Même bloc mcpServers que ci-dessus, dans la configuration MCP de votre éditeur.
Depuis les sources (avant publication PyPI)
{
"mcpServers": {
"nyambot": {
"command": "uvx",
"args": ["--from", "git+https://github.com/GabMJ23/nyambot-mcp", "nyambot-mcp"]
}
}
}Exemples de questions
Une fois branché, demandez à votre agent :
« Quel est le code INSEE de Combs-la-Ville ? »
« Quels sont les risques naturels à Pierrelatte avant d'acheter ? »
« Donne-moi des DPE autour du 75011. »
« J'envisage d'acheter au 8 boulevard du Port à Amiens — géocode l'adresse et liste les risques de la commune. »
Exemple de réponse réelle — risques_immobilier("Pierrelatte"), via le connecteur gratuit :
Risques recensés pour Pierrelatte (INSEE 26235) :
- Effet toxique
- Inondation
- Mouvement de terrain
- Nucléaire
- Risque industriel
- Séisme
- Transport de marchandises dangereusesVérifier que c'est branché
Claude Code :
claude mcp list(statutconnected) ou/mcpdans une session.Mode debug pour voir les appels passer :
claude --debug.
Développement
git clone https://github.com/GabMJ23/nyambot-mcp
cd nyambot-mcp
uv venv && uv pip install -e ".[dev]"
# Lancer les tests (offline, sans réseau)
pytest
# Lancer le serveur localement
nyambot-mcpCœur open-source (ce package) vs connecteur hébergé (en ligne)
nyambot-mcp est la partie gratuite et open-source : un connecteur qui appelle directement les API publiques de l'État, sans clé, en local (4 outils : communes, géocodage, risques, DPE).
Le connecteur hébergé — https://mcp.nyambot.ai/mcp, en ligne — fédère 21 outils answer-ready sur l'administration française, y compris ceux qui nécessitent des sources sémantiques et de l'infrastructure hébergée (non self-hostables) :
🏠 Marché immobilier DVF réel — médiane €/m² sur transactions réellement actées
⚖️ Légifrance — l'article de loi exact, texte à jour
💼 SIRENE / INSEE (vérification d'entreprise), Annuaire Santé (ANS), France Travail
📚 RAG des fiches Service-Public (recherche sémantique)
✍️ Génération de courriers administratifs, simulation d'aides
…et plus — le tout en réponses structurées et entièrement sourcées.
Comment y accéder :
Usage interactif (agent piloté par un humain — Claude, ChatGPT, Cursor…) : pointez votre client sur
https://mcp.nyambot.ai/mcp. Connexion OAuth 2.1 (PKCE) gérée, elle s'ouvre au 1ᵉʳ appel.Intégration backend / serveur-à-serveur : clés machine (OAuth client credentials) provisionnées sur demande — on vous fournit un
client_id+client_secret, vous obtenez un token et appelez le connecteur enBearer.
Sous le capot (la plateforme hébergée) :
Construit sur Claude (Anthropic), avec un routage multi-modèles (Haiku / Sonnet) selon la tâche.
Recherche hybride (dense + lexicale) sur un corpus souverain (fiches Service-Public, codes en vigueur, catalogue data.gouv).
Contrat answer-ready : 1 appel = 1 réponse sourcée, avec dégradation honnête (jamais d'erreur qui casse votre agent).
Stack technique (plateforme hébergée) :
Python 3.12 · FastAPI · MCP SDK (Streamable HTTP) · Anthropic SDK · PostgreSQL + pgvector (recherche vectorielle) · embeddings bge-m3 souverains · FTS Postgres (recherche lexicale) · SSE (streaming temps réel) · OAuth 2.1 (PKCE + client credentials) · Alembic (migrations) · Pydantic · httpx · déployé sur Railway (UE).
Le connecteur open-source de ce dépôt reste volontairement minimal (
Python+mcp+httpx) : toute l'infrastructure d'intelligence ci-dessus vit sur la plateforme hébergée.
Le connecteur local restera open-source et gratuit ; les capacités hébergées passent par le backend (OAuth / clé machine).
Vous voulez brancher le connecteur hébergé ou une clé machine backend ? Écrivez-moi (voir Contact ci-dessous).
Contact
Questions, retours, demande de clé API v2, ou partenariat :
Gabriel Mbenda — AI Builder & Founder, Nyambot.ai 📧 gabrielmbenda48@gmail.com
Licence
MIT © 2026 Gabriel Mbenda — un projet Nyambot.ai.
Les données proviennent des sources officielles du gouvernement français (licence Etalab ouverte). Nyambot est un service indépendant, non affilié à l'État.
mcp-name: io.github.GabMJ23/nyambot-mcp
Available Tools
4 toolsdpe_logementA
Diagnostics de Performance Énergétique (DPE) de logements existants (ADEME).
Renvoie étiquette énergie (A→G), étiquette GES, surface, consommation et date du diagnostic. Filtre par code postal, affinable par une adresse.
Args: code_postal: code postal sur 5 chiffres (ex. « 75011 »). adresse: optionnel — texte d'adresse pour affiner (ex. « 48 rue de Montreuil »).
Inputs: code_postal (required), adresse. Returns: result
geocode_addressA
Géocode une adresse française via la Base Adresse Nationale (BAN).
Renvoie l'adresse normalisée, les coordonnées, le code postal, la commune et le code INSEE — utile pour cibler ensuite risques/DPE à l'adresse exacte.
Args: adresse: adresse libre (ex. « 8 boulevard du Port, Amiens »).
Inputs: adresse (required). Returns: result
resolve_communeA
Résout une commune française par son nom.
Renvoie code INSEE, département, région, coordonnées et population. À utiliser en PREMIER, comme ancre géographique, avant les autres outils (le code INSEE sert ensuite à interroger les risques, par exemple).
Args: nom: nom de la commune (ex. « Lyon », « Combs-la-Ville »).
Inputs: nom (required). Returns: result
risques_immobilierA
Risques naturels & technologiques d'une commune (Géorisques / Gaspar).
Couvre inondation, retrait-gonflement des argiles, séisme, radon, mouvements de terrain, sites industriels (ICPE)… À consulter AVANT un achat immobilier.
Accepte un code INSEE (5 chiffres) OU une adresse libre — dans ce dernier cas l'adresse est géocodée automatiquement pour retrouver la commune.
Args: adresse_ou_code_insee: ex. « 69123 » ou « 12 rue de la Paris, Pierrelatte ».
Inputs: adresse_ou_code_insee (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a distinct aspect of French real estate: DPE for energy performance, geocoding for address coordinates, commune resolution for geographic anchor, and risks for natural/technological hazards. No overlap in functionality.
Tool names mix French and English inconsistently (e.g., 'dpe_logement' vs 'geocode_address'), and follow different patterns (noun_noun for French, verb_noun for English). This lacks a unified naming convention.
With 4 tools covering the essential use cases for French real estate research—geocoding, commune lookup, DPE, and risks—the count is well-scoped and not excessive.
The tool set covers the main pre-purchase investigation steps: locate, identify commune, check DPE, assess risks. Missing maybe property tax or school info, but core workflow is complete.
Related MCP Connectors
MCP server for real-estate agents: listings, CRM, German market data and AI media tools.
Données immobilières officielles françaises (DVF+, cadastre, DPE, risques, urbanisme) via MCP.
MCP server for Japan geodata: cadastral lot numbers (chiban) and reverse geocoding, for AI agents.
Independent platform exposing French official public territorial data through read-only MCP tools.
Related MCP Servers
- AlicenseAqualityAmaintenanceAn MCP server that connects AI chatbots directly to data.gouv.fr, France’s national open data platform. It allows users to search, explore, and analyze thousands of public datasets simply by asking questions in natural language.101,636MIT
- AlicenseNot gradedqualityFmaintenanceAn experimental MCP server providing spatial context for LLMs by interfacing with French Geoplateforme services. It enables tasks such as geocoding, altitude lookups, and querying administrative, cadastral, or urban planning data.5 npm4MIT
- AlicenseAqualityAmaintenanceFrance Data MCP lets AI agents query, cross-reference and automatically enrich multiple French public registries through a unified MCP interface. France Data MCP provides a French territorial intelligence layer designed for multi-source reasoning and agentic orchestration.37245 npm4MIT
- AlicenseNot gradedqualityBmaintenanceA hosted MCP server for French address data quality, geocoding, and routing, allowing LLMs to verify, normalize, search addresses, and compute routes using official open data sources.3MIT