permisapi-mcp
It is a read-only MCP server for querying French building permits and related real-estate/urbanism data, with plan-gated advanced analysis tools.
Search permits with filters such as department, commune, permit type, state, dates, minimum surface, SIREN, sorting/pagination, and paid-plan filters like minimum score, PLU zone/constructibility, and risk tier.
Retrieve full permit details by
num_pa, including address, applicant, dates, surfaces, cadastre, and lat/lng.Fuzzy-search addresses to locate permits when exact commune codes or postcodes are unknown.
Analyze a permit’s opportunity/context: MDB score, DVF neighboring sales, PLU zoning, Géorisques risks, cadastral parcel geometry, and existing buildings on the parcel.
Get a 360 permit view combining detail, SIRENE, DVF, score, PLU, and risks in one call.
Bulk-enrich up to 1,000 user-provided rows with nearby permits and enrichment data on Business+ plans.
Access is plan-gated: basic search/details/address search on Free; advanced data on Pro+/Régional+; bulk enrichment on Business+.
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 / WindowsSi elle est >= 3.10 :
pip install permisapi-mcpSinon, 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 |
| GET /v1/permits (12 filtres et un tri) | Toutes |
| GET /v1/permits/{num_pa} | Toutes |
| GET /v1/search?q=texte (recherche approchée) | Toutes |
| GET /v1/permits/{num_pa}/dvf (ventes DVF 2021-2025, prix médian au m²) | Régional et plus |
| GET /v1/permits/{num_pa}/score (score v0.3, 11 signaux) | Régional et plus |
| GET /v1/permits/{num_pa}/score/explain (11 signaux commentés, principaux leviers) | Régional et plus |
| GET /v1/permits/{num_pa}/plu | Régional et plus |
| GET /v1/permits/{num_pa}/risks (Géorisques) | Régional et plus |
| GET /v1/permits/{num_pa}/parcelle (cadastre DGFiP) | Régional et plus |
| GET /v1/permits/{num_pa}/batiments-existants (terrain nu ou bâti) | Régional et plus |
| GET /v1/parcelles/{id_parcelle} (identifiant cadastral de 14 caractères) | Régional et plus |
| GET /v1/permits/{num_pa}/parcelles-voisines (rayon de 10 à 2 000 m) | Régional et plus |
| 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 /v1/permits/{num_pa}/economics (budget de chantier : fourchette, scénario, lots) | Régional et plus |
| GET /v1/permits/{num_pa}/contractors (entreprises du bâtiment proches, par métier) | Régional et plus |
| POST /v1/permits/inside-polygon (polygone GeoJSON) | Business et Entreprise |
| GET /v1/stats/commune/{code}/density (parcelles, bâtiments, permis) | Business et Entreprise |
| 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, etsearch_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 --versionSi 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-mcpPuis, 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.11Windows : 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_typeetplu_constructibledesearch_permitssont 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_depotetmax_an_depotdesearch_permits_in_polygonacceptent dès 2000 (au lieu de 2010), pour les permis déposés avant 2013 et autorisés depuis ;get_commune_density_statspré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,PAouPD) sur les 12 outils qui prennent unnum_pa; unnum_paprécédé de son type (PD0330632600176) est accepté ; les réponses portenttype_autorisationetidentifiant, et la ficheautres_types. Sanstype, 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
Code source
Available Tools
11 toolsbulk_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
Scored across 11 tools
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.
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.
11 tools is well-scoped for the domain of building permit analysis, covering search, details, and various enrichment analyses without being excessive.
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
Related MCP Connectors
French land and real estate intelligence from public data: corporate owners (SIREN, group, BODACC), PLU zoning rules quoted page by page (OCR for scanned regulations), buildable capacity in 3D, DVF sales and price ranges, developer and operating appraisals, risks, transit isochrones, vacant plots, pre-emption and lapsed permits. 71 tools, every figure sourced; nothing is guessed. Free account, no credit card.
Données immobilières officielles françaises (DVF+, cadastre, DPE, risques, urbanisme) via MCP.
French public-data MCP: cross-ref health, demographics, business, geo & real-estate.
Building permits from 18 US cities (NYC, LA, Chicago, Philadelphia...), Canada, Ireland, France.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceProvides 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
- AlicenseAqualityDmaintenanceOpen-source MCP server providing real estate regulatory intelligence (zoning, permits, entitlements, deal scoring) for US properties, enabling AI agents to access 10 callable tools.125 npmMIT
- 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
- AlicenseAqualityDmaintenanceA 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.480 PyPIMIT