Skip to main content
Glama

nyambot-mcp

PyPI Python MCP License: MIT

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_logement et 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 A

Verdict : à ~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

resolve_commune

Nom de commune → code INSEE, département, région, coordonnées, population

geo.api.gouv.fr

geocode_address

Adresse → coordonnées, code postal, commune, code INSEE

Base Adresse Nationale

risques_immobilier

Risques naturels & technologiques d'une commune (inondation, argiles, séisme, radon…)

Géorisques

dpe_logement

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-mcp

Cursor / 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 dangereuses

Vérifier que c'est branché

  • Claude Code : claude mcp list (statut connected) ou /mcp dans 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-mcp

Cœ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 en Bearer.

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 tools
dpe_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

    A4.1/5.0

    Scored across 4 tools

    Disambiguation5/5

    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.

    Naming Consistency3/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      A
      quality
      A
      maintenance
      An 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.
      10
      1,636
      MIT
    • A
      license
      Not graded
      quality
      F
      maintenance
      An 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 npm
      4
      MIT
    • A
      license
      A
      quality
      A
      maintenance
      France 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.
      37
      245 npm
      4
      MIT

    Appeared in Searches