Pour les développeurs

API publique.

Un accès en lecture aux données publiques que nous ingérons : régions, départements, communes et parcelles cadastrales, avec les statistiques et les enrichissements affichés sur le site. REST, JSON, une clé dans un en-tête. Gratuit pour un usage non commercial. Et un serveur MCP pour les assistants IA.

11 endpoints Serveur MCP 39 sources publiques Licence Ouverte 2.0 openapi.json

Obtenir une clé

Créez un compte.

La clé s'obtient en ligne, en deux minutes, sans nous écrire :

Inscrivez-vous avec votre email et un mot de passe, ou avec Google.
Ouvrez le lien de confirmation reçu par email.
Dans votre compte, cliquez sur « Créer une clé » : elle s'affiche une seule fois, copiez-la.

Créer un compte J'ai déjà un compte

Le plan gratuit est inclus ; les plans payants se souscrivent depuis le compte, sans engagement.

Plan	Prix	Par jour	Par minute	Usage
Gratuit	Gratuit	100 requêtes	10 requêtes	Non commercial
Standard	19 € HT / mois	2 000 requêtes	60 requêtes	Commercial autorisé
Pro	79 € HT / mois	25 000 requêtes	300 requêtes	Commercial autorisé

Les limites s'appliquent par compte, toutes clés confondues. Une clé identifie une intégration, pas un visiteur : ne l'embarquez pas dans un front-end public. Chaque réponse renvoie X-Plan, X-Quota-Used et X-Quota-Remaining. Un besoin hors cadre (collectivité, recherche, volume supérieur) se règle par email : contact@lagrandecarte.fr.

curl -H "X-API-Key: VOTRE_CLE" \
  "https://lagrandecarte.fr/api/v1/communes/18033?include=stats"

Assistants IA

Serveur MCP.

Les mêmes données, directement dans Claude, ChatGPT, Cursor ou tout client compatible MCP : l’assistant géocode l’adresse, trouve la parcelle et lit ses risques, son urbanisme ou ses ventes sans que vous touchiez à l’API. Chaque outil appelle l’endpoint REST correspondant : même compte, mêmes limites, un appel d’outil vaut une requête.

https://lagrandecarte.fr/mcp

Guide de connexion pas à pas : lagrandecarte.fr/mcp.

Par l’interface

Ajoutez un connecteur personnalisé avec cette adresse dans votre assistant. Il vous renvoie sur La Grande Carte : connectez-vous (ou créez un compte), autorisez l’accès, et une clé « MCP · … » est créée automatiquement dans votre compte. La révoquer déconnecte l’assistant.

Avec une clé

Pour les clients qui acceptent un en-tête, générez une clé depuis votre compte. Claude Code :

claude mcp add --transport http lagrandecarte https://lagrandecarte.fr/mcp \
  --header "X-API-Key: VOTRE_CLE"

Configuration JSON (Cursor, Claude Desktop, VS Code…) :

{
  "mcpServers": {
    "lagrandecarte": {
      "type": "http",
      "url": "https://lagrandecarte.fr/mcp",
      "headers": {
        "X-API-Key": "VOTRE_CLE"
      }
    }
  }
}

Exemples de questions

« Qu’est-ce que tu sais sur la commune de Bosdarros ? Et la qualité de l’eau du robinet ? »
« Je visite une maison au 4 rue Porte Jaune à Bourges : risques naturels, zonage du PLU, ventes récentes autour ? »
« Compare le revenu médian, les loyers et la délinquance de Pau et de Tarbes. »
« Taux de pauvreté et espérance de vie dans les Pyrénées-Atlantiques, comparés à la Nouvelle-Aquitaine ? »

L’assistant n’envoie que les paramètres des outils (une commune, une adresse), jamais votre conversation : voir la politique de confidentialité. Une question, un problème : contact@lagrandecarte.fr.

Outil	Description
get_commune	Tout sur une commune : population, revenus, loyers, qualité de l’eau et de l’air, délinquance, climat, élus, finances… (statistiques incluses)
search_address	Trouver une commune, une adresse ou un lieu-dit ; renvoie le code INSEE et les coordonnées
get_parcel_enrichments	Le rapport complet d’une parcelle : risques, urbanisme, ventes, DPE, bruit, réseaux…
get_parcel_at_point	La parcelle cadastrale à un point
get_parcel	Une parcelle par sa référence (IDU)
get_departement	Un département et ses statistiques, éventuellement ses communes
get_region	Une région et ses statistiques, éventuellement ses départements
find_commune	La commune qui contient un point
list_communes	Les communes d’un département
list_departements	Les départements, éventuellement d’une région
list_regions	Les régions

Référence rapide

Les endpoints.

Méthode	Chemin	Description
GET	/api/v1	Index du service — le seul appel sans clé
GET	/api/v1/regions	Les 18 régions
GET	/api/v1/regions/{code}	Une région · include=geometry,stats,departements
GET	/api/v1/departements	Les 101 départements, outre-mer compris · ?region=
GET	/api/v1/departements/{code}	Un département · include=geometry,stats,communes
GET	/api/v1/communes	Les communes d'un département (?departement=) ou celle qui contient un point (?lat=&lon=)
GET	/api/v1/communes/{codeInsee}	Une commune · include=geometry,stats
GET	/api/v1/adresses?q=	Géocodage d’une adresse ou d’un lieu (Base Adresse Nationale)
GET	/api/v1/parcelles?lat=&lon=	La parcelle cadastrale à un point
GET	/api/v1/parcelles/{idu}	Une parcelle · include=geometry
GET	/api/v1/parcelles/{idu}/enrichments	Tout ce que nous savons de la parcelle

Les données sont publiées sous Licence Ouverte 2.0 : réutilisation libre, y compris commerciale, à condition de citer la source. Mentionner « La Grande Carte » avec un lien suffit.

Documentation interactive