Skip to main content
Glama
permisapi-mcp

permisapi-mcp

by Evan-Crx

permisapi-mcp

Serveur MCP (Model Context Protocol) pour PermisAPI.

Il permet à Claude, ChatGPT, Claude Desktop, Cursor, Windsurf ou tout client compatible MCP d'interroger en langage naturel plus de 3 millions de permis de construire en France (base Sitadel, permis autorisés depuis 2013, 101 départements, logements et locaux).

18 outils en lecture seule : recherche par critères ou par adresse, score d'opportunité marchand de biens v0.3 et son explication (les 11 signaux pondérés, commentés en français), ventes immobilières voisines (DVF, ventes de 2021 à 2025) et prix au m², zonage PLU, risques Géorisques (inondation, séisme, sites Seveso proches…), parcelle cadastrale DGFiP, bâtiments existants (terrain nu ou déjà bâti), parcelles voisines, recherche dans un polygone GeoJSON (ZAC, périmètre d'opération), statistiques de densité par commune, budget de chantier estimé et entreprises du bâtiment proches (base SIRENE, codes NAF 41, 42 et 43), enrichissement d'une liste.

Deux façons de l'utiliser

1. Serveur hébergé (recommandé, rien à installer)

Adresse : https://mcp.permisapi.fr/mcp

  • Claude et ChatGPT : ajoutez un connecteur personnalisé à cette adresse. Une page PermisAPI s'ouvre ; collez-y votre clé (ou créez-y un compte Gratuit) et cliquez sur Autoriser (OAuth avec PKCE : l'assistant reçoit un jeton, jamais votre clé). Les intitulés des menus changent d'une version à l'autre : le pas à pas à jour est sur permisapi.fr/mcp.

  • Cursor, Windsurf et autres clients acceptant un en-tête (~/.cursor/mcp.json) :

{
  "mcpServers": {
    "permisapi-hosted": {
      "url": "https://mcp.permisapi.fr/mcp",
      "headers": { "Authorization": "Bearer pk_live_VOTRE_CLE" }
    }
  }
}

Transports : Streamable HTTP (spécification MCP actuelle) sur /mcp et /mcp/, et SSE historique sur /sse + /messages/. Le serveur ne conserve ni vos questions ni les résultats : il relaie vos appels vers api.permisapi.fr. Quand la mesure d'audience est activée sur le serveur (PostHog, hébergement UE), chaque appel d'outil y est compté (nom de l'outil, durée, statut, formule).

2. En local (Claude Desktop, mode stdio)

Pour Claude Desktop, ou si vous préférez tout faire tourner sur votre machine, installez le paquet permisapi-mcp.

Related MCP server: Dilix MCP

Prérequis

  • Python 3.10 ou plus récent (exigé par le SDK MCP)

  • Une clé PermisAPI : permisapi.fr/#pricing (formule Gratuit, sans carte bancaire)

Installation

Vérifiez d'abord la version de Python :

python --version       # macOS / Linux / Windows

Si elle est >= 3.10 :

pip install permisapi-mcp

Sinon, voir Dépannage plus bas (solution uvx en une commande, sans changer le Python du système).

Configuration de Claude Desktop

Modifiez ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows) :

{
  "mcpServers": {
    "permisapi": {
      "command": "permisapi-mcp",
      "env": {
        "PERMISAPI_KEY": "pk_live_VOTRE_CLE"
      }
    }
  }
}

Redémarrez Claude Desktop. Vous pouvez alors demander :

« Liste les permis de logement autorisés à Paris ce mois-ci »

« Trouve des permis autour de la rue de Passy à Paris »

« Quel est le zonage PLU du permis 07510125V0025 ? » (formule Régional et plus)

Périmètre géographique selon la formule (src/services/plan_gating.py) :

  • Gratuit : 1 département, les nouveaux permis des 2 dernières publications Sitadel (environ 2 mois), 500 requêtes par mois.

  • Découverte : 1 département, 6 mois d'historique, 2 000 requêtes par mois.

  • Explorateur : 5 départements, 12 mois d'historique, 5 000 requêtes par mois.

  • Régional : 5 départements, historique complet et données avancées (ventes DVF, score, PLU, risques, cadastre, budget, entreprises).

  • Pro : les mêmes données avancées sur la France entière.

  • Business et Entreprise : France entière, plus la recherche par polygone, la densité par commune et l'enrichissement de liste.

Pour les formules à départements (Gratuit, Découverte, Explorateur, Régional), chaque nouveau département interrogé s'ajoute à votre périmètre jusqu'à la limite de la formule ; le choix est ensuite définitif pour cette formule. Les exemples ci-dessus portent sur Paris (75).

Configuration de Cursor, Windsurf et autres clients

Guide complet : permisapi.fr/mcp

Outils disponibles (18)

Outil

Route

Formules

search_permits

GET /v1/permits (12 filtres et un tri)

Toutes

get_permit_details

GET /v1/permits/{num_pa}

Toutes

fuzzy_search_addresses

GET /v1/search?q=texte (recherche approchée)

Toutes

find_dvf_neighbors

GET /v1/permits/{num_pa}/dvf (ventes DVF 2021-2025, prix médian au m²)

Régional et plus

get_mdb_score

GET /v1/permits/{num_pa}/score (score v0.3, 11 signaux)

Régional et plus

get_score_explanation

GET /v1/permits/{num_pa}/score/explain (11 signaux commentés, principaux leviers)

Régional et plus

get_plu_zoning

GET /v1/permits/{num_pa}/plu

Régional et plus

get_risks

GET /v1/permits/{num_pa}/risks (Géorisques)

Régional et plus

get_parcelle_geometry

GET /v1/permits/{num_pa}/parcelle (cadastre DGFiP)

Régional et plus

get_existing_buildings

GET /v1/permits/{num_pa}/batiments-existants (terrain nu ou bâti)

Régional et plus

get_parcelle_by_id

GET /v1/parcelles/{id_parcelle} (identifiant cadastral de 14 caractères)

Régional et plus

get_neighbor_parcels

GET /v1/permits/{num_pa}/parcelles-voisines (rayon de 10 à 2 000 m)

Régional et plus

get_permit_full_view

GET /v1/permits/{num_pa}/360 (vue complète en un appel)

Régional et plus (détail seul en Gratuit, Découverte et Explorateur)

get_economics

GET /v1/permits/{num_pa}/economics (budget de chantier : fourchette, scénario, lots)

Régional et plus

get_contractors

GET /v1/permits/{num_pa}/contractors (entreprises du bâtiment proches, par métier)

Régional et plus

search_permits_in_polygon

POST /v1/permits/inside-polygon (polygone GeoJSON)

Business et Entreprise

get_commune_density_stats

GET /v1/stats/commune/{code}/density (parcelles, bâtiments, permis)

Business et Entreprise

bulk_enrich_list

POST /v1/permits/bulk-enrich (liste de 1 000 lignes au plus)

Business et Entreprise

« Régional et plus » = Régional, Pro, Business et Entreprise. Les autres formules reçoivent une erreur 402.

Sécurité

  • En mode local, la clé reste sur votre machine (variable d'environnement) ; en mode hébergé, l'assistant ne reçoit qu'un jeton. Dans les deux cas, le modèle ne voit jamais la clé, seulement les arguments des outils.

  • Validation stricte des entrées (num_pa, identifiants cadastraux, codes INSEE, bornes numériques).

  • 16 outils en consultation (GET) et 2 en POST (bulk_enrich_list, qui croise une liste que vous fournissez, et search_permits_in_polygon, qui reçoit un polygone). Tous sont en lecture seule : ils ne modifient ni votre compte ni les données.

Dépannage

pip install permisapi-mcp répond « package introuvable » ou « no matching distribution »

Cause la plus fréquente : votre Python est antérieur à 3.10, minimum exigé par le SDK MCP.

Vérifiez :

python --version       # ou python3 --version

Si elle est < 3.10, deux solutions au choix.

Solution A (recommandée, 30 secondes) : uvx avec une version de Python imposée

uvx installe et lance le serveur dans un Python isolé, à la version voulue, sans toucher à votre installation.

# 1. Installer uv (une seule fois)
curl -LsSf https://astral.sh/uv/install.sh | sh         # macOS / Linux
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"  # Windows PowerShell

# 2. Lancer le serveur
uvx --python 3.11 permisapi-mcp

Puis, dans la configuration de Claude Desktop, remplacez "command": "permisapi-mcp" par :

{
  "mcpServers": {
    "permisapi": {
      "command": "uvx",
      "args": ["--python", "3.11", "permisapi-mcp"],
      "env": { "PERMISAPI_KEY": "pk_live_VOTRE_CLE" }
    }
  }
}

Solution B : mettre à jour le Python du système

  • macOS : brew install python@3.11

  • Windows : télécharger https://www.python.org/downloads/ et cocher « Add to PATH »

  • Linux : sudo apt install python3.11 (ou l'équivalent de votre distribution)

Puis pip3.11 install permisapi-mcp.

Guide complet et autres questions : permisapi.fr/mcp

Journal des versions

  • 0.6.1 (13/11/2026) : les filtres plu_zone_type et plu_constructible de search_permits sont documentés avec leur portée (le zonage est calculé pour les permis géolocalisés autorisés depuis 48 mois), le résumé et les consignes du serveur disent « plus de 3 millions de permis autorisés depuis 2013 » ; min_an_depot et max_an_depot de search_permits_in_polygon acceptent dès 2000 (au lieu de 2010), pour les permis déposés avant 2013 et autorisés depuis ; get_commune_density_stats présente la série par année d'autorisation (count_by_year_autorisation).

  • 0.6.0 (12/11/2026, bascule de la clé type et numéro, C24) : argument facultatif type (PC, DP, PA ou PD) sur les 12 outils qui prennent un num_pa ; un num_pa précédé de son type (PD0330632600176) est accepté ; les réponses portent type_autorisation et identifiant, et la fiche autres_types. Sans type, rien ne change. Version mineure : ajouts seulement, aucun appel existant ne change de réponse.

  • Versions précédentes : historique du dépôt (git log -- mcp/).

Licence

MIT pour le code. Données publiques : SDES (Sitadel), DGFiP (DVF, cadastre), Géorisques, IGN (Géoportail de l'Urbanisme), INSEE (SIRENE).

Support

evan@permisapi.fr

Code source

github.com/Evan-Crx/permisapi-mcp

Available Tools

11 tools
bulk_enrich_listA

Croisez une liste fournie par l'utilisateur (max 1000 lignes) avec les permis de France pour recuperer en 1 appel : permis a proximite + score d'opportunité + risques + zonage + parcelle cadastre. Plan Business+ uniquement, coût = 1 unité quota par ligne. Use case : enrichir une liste prospects/patrimoine. 3 modes par ligne : (lat+lng) ou (adresse) ou (commune+section+numero). Le champ 'ref' identifié chaque ligne dans la response.

Inputs: rows (required), radius_m, max_matches.

find_dvf_neighborsC

Pour un permis, retourne les top transactions immobilieres DVF voisines (5 ans glissants). Permet d'estimer la valeur fonciere du quartier. Plan Pro+ uniquement.

Inputs: num_pa (required), limit, type_local, min_year.

fuzzy_search_addressesA

Recherche fuzzy par texte libre sur les adresses (rue, ville, lieudit). Utilise pg_trgm côté DB : insensible aux accents et à la casse, tolérant aux typos. Idéal pour trouver un permis quand on connaît l'adresse approximative mais pas le code postal ou commune INSEE précis. Tous plans (avec respect du scope géo). Coût 1 unité quota. Exemple : 'rue victor hugo paris', 'cours de l ile bordeaux'.

Inputs: q (required), dep_code, limit.

get_existing_buildingsA

Liste les bâtiments cadastraux déjà construits sur la parcelle du permit. Use case CRITIQUE marchand de biens : distinguer parcelle nue (vraie construction neuve, value-add max) vs parcelle bâtie (extension/rénovation, value-add moindre). Retourne nb_batiments total + décompte par type (bâti dur / bâti léger / autre) + flag parcelle_nue boolean + détails individuels (id Etalab, type label FR, centroïde, dates création/MAJ cadastre). Source : cadastre.data.gouv.fr via Etalab (DGFiP). Plan Pro+ uniquement. Coût 1 unité quota. 404 si le permit n'a pas de polygone cadastre disponible (rare, ~15% des permits).

Inputs: num_pa (required).

get_mdb_scoreA

Calcule le Score Opportunité Marchand de Biens v0.1 pour un permis (note 0-100 + tier low/medium/high/premium + breakdown de 7 signaux ponderes). Plan Pro+ uniquement.

Inputs: num_pa (required).

get_parcelle_geometryA

Géométrie précise de la parcelle cadastre DGFiP du permis (via Etalab open data). Retourne un GeoJSON Polygon WGS84 + surface mesurée en m2 + identifiant Etalab. Permet de visualiser le polygon exact de la parcelle sur une carte (vs juste le point lat/lng adresse). Plan Pro+ uniquement. 404 si la commune n'est pas encore en cache (rare, hors couverture Etalab DOM très récents).

Inputs: num_pa (required).

get_permit_detailsB

Recupere tous les détails d'un permis a partir de son identifiant Sitadel (num_pa) : adresse complète, demandeur, dates, surface, parcelle cadastre, lat/lng. Plan Free OK.

Inputs: num_pa (required).

get_permit_full_viewA

Vue 360 complète d'un permis en 1 seul appel : détail + sirene + dvf + score MDB + zonage PLU + risques. Le moyen le plus efficace pour analyser un permis quand tu veux tout d'un coup au lieu d'appeler 6 outils séparés. Coût : 6 unités de quota Pro+ (1 par sous-feature, identique à 6 calls séparés). Pour Free / Explorer, retourne uniquement le détail (coût 1 unité). En cas d'échec d'une sous-feature (ex: PLU timeout), le champ vaut null et l'erreur est listée dans fetch_errors. Latence typique 5-7s.

Inputs: num_pa (required).

get_plu_zoningA

Retourne le zonage urbanisme PLU au point géocodé du permis (UA/UB urbain, AU a urbaniser, A agricole, N naturelle) avec verdict booleen constructible et raison juridique. Source Geoportail de l'Urbanisme. Plan Pro+ uniquement.

Inputs: num_pa (required).

get_risksC

Risques naturels et technologiques (inondation, seisme, argile, ICPE proches) connus sur la commune du permis. Score agrege 0-100 + tier. Source Géorisques BRGM. Plan Pro+ uniquement.

Inputs: num_pa (required).

search_permitsB

Recherche des permis de construire de France avec filtres combinables : département, commune, type de permis, état, dates, surface min, SIREN demandeur. Retourne une page de permits avec leurs infos de base. Plan Free OK.

Inputs: dep_code, comm_code, permit_type, etat_pa, +10 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 11 tools

    Disambiguation5/5

    Each tool targets a distinct aspect of permit data: search, details, full view, geometry, buildings, DVF, zoning, risks, merchant score, bulk enrichment, and address lookup. No overlap in functionality.

    Naming Consistency4/5

    Tools follow a consistent verb_noun pattern in snake_case, mostly using 'get_' or 'search_', with one 'find_' and one 'fuzzy_search_' as minor deviations. Overall predictable and descriptive.

    Tool Count5/5

    11 tools is well-scoped for the domain of building permit analysis, covering search, details, and various enrichment analyses without being excessive.

    Completeness5/5

    The tool set provides comprehensive coverage for permit analysis: search, details, full view, parcel geometry, existing buildings, DVF, zoning, risks, merchant score, bulk enrichment, and address fuzzy search. No obvious gaps for a read-only API.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Provides access to San Francisco public permitting, business, and property data through the Socrata SODA API. Users can search permit details, aggregate statistics, and look up property assessments using natural language.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Open-source MCP server providing real estate regulatory intelligence (zoning, permits, entitlements, deal scoring) for US properties, enabling AI agents to access 10 callable tools.
      12
      5 npm
      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
    • A
      license
      A
      quality
      D
      maintenance
      A French administration MCP server that enables AI agents to access official public data including communes, geocoding, property risks, and energy performance certificates (DPE) for real estate evaluation.
      4
      80 PyPI
      MIT