Evan-Crx/permisapi-mcp

Serveur **MCP** (Model Context Protocol, Anthropic) pour PermisAPI.
Permet à **Claude Desktop**, **Claude.ai web**, **ChatGPT custom GPT**, **Cursor**,
**Windsurf** ou tout client MCP-compatible de consulter **1,2 M+ permis de
construire de France** (Sitadel 2014-2026, résidentiel + non-résidentiel, depuis
2014) en langage naturel.
18 outils disponibles : recherche par adresse, **score d'opportunité Marchand
de Biens v0.3 et son explication transparente** (les 11 signaux pondérés
détaillés en français avec interprétation contextualisée), prix au m² des
ventes voisines sur 12 ans, zonage urbanisme PLU, risques (inondation,
sismique, ICPE), parcelle cadastre DGFiP (par identifiant Etalab ou par
géométrie), **bâtiments existants** (terrain nu vs déjà bâti), **parcelles
voisines d'un permis** (pattern d'activité local marchand de biens),
**recherche par polygone GeoJSON custom** (ZAC, périmètre opération),
statistiques densité commune, **budget chantier estimé** (fourchette EUR
+ scénario neuf / rénovation / démolition basé surfaces Sitadel + barème
Capeb / FFB + INSEE ICP-BT), **entreprises BTP locales par lot** (SIRENE
NAF 41/42/43, 1 086 952 actifs en BDD géolocalisés WGS84) et enrichissement
de liste client.
Deux modes au choix
Mode 1 : SSE hosted (recommandé, zéro installation)
Connecte directement Claude.ai web ou ChatGPT à https://mcp.permisapi.fr/mcp
avec ta clé PermisAPI en Bearer token. Pas de Python à installer, pas de
config locale, ça marche depuis n'importe quel browser.
**Claude.ai web** (Settings > Integrations > Add MCP server) :
**Cursor / Windsurf** (~/.cursor/mcp.json) :
Mode supporté : Streamable HTTP (spec actuelle MCP) sur /mcp ET SSE legacy sur
/sse + /messages/ (backward compat). Aucune donnée n'est stockée côté
serveur MCP, c'est un proxy authentifié vers api.permisapi.fr.
Mode 2 : stdio local (Claude Desktop classique)
Pour Claude Desktop ou si tu préfères tout en local, install Python et le
package permisapi-mcp :
Pré-requis
- **Python 3.10 ou plus récent** (requis par le MCP SDK Anthropic, non négociable)
- Une clé PermisAPI : https://permisapi.fr/#pricing (gratuite pour commencer)
Installation
Vérifier d'abord la version Python :
Si >= 3.10 :
Si *« Liste les permis de logement déposés à Paris ce mois avec un score MDB > 70 »*
>
> *« Trouve-moi des opportunités MDB autour de la rue de Passy à Paris »*
>
> *« Quel est le zonage PLU du permis 0930662500027 ? »*
**Note sur le périmètre géographique** :
- **Free** : 1 département au choix (Paris par défaut). Modifiable via le dashboard.
- **Explorer** : 5 départements au choix (Paris/Lyon/Marseille/Bordeaux/Toulouse par défaut).
- **Pro / Business / Enterprise** : France entière, aucune restriction géographique.
Les exemples ci-dessus ciblent Paris (75) pour qu'ils fonctionnent immédiatement sur tous les plans. Si vous êtes sur Explorer avec ses départements par défaut, vous pouvez aussi demander "à Lyon", "à Bordeaux", etc.
Configuration Cursor / Windsurf / autres clients
Voir le guide complet : https://permisapi.fr/mcp
Tools disponibles (18)
| Tool | Endpoint | Plan |
|---|---|:---:|
| search_permits | GET /v1/permits (13 filtres) | Free |
| get_permit_details | GET /v1/permits/{num_pa} | Free |
| fuzzy_search_addresses | GET /v1/search?q=text (pg_trgm fuzzy) | Free |