| ign_get_communes_by_postal_code | Retrieve French communes (municipalities) associated with a postal code. This tool queries the IGN API Carto codes-postaux module to find all communes that share a given postal code. In France, a postal code can cover multiple communes, and this tool returns all of them. Args: code_postal (string): French postal code (5 digits, e.g. "75001", "69000") response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns:
For JSON format:
[
{
"codePostal": "75001",
"codeCommune": "75101",
"nomCommune": "Paris 1er Arrondissement",
"libelleAcheminement": "PARIS"
}
] Examples: |
| ign_get_cadastre_parcelles | Search for cadastral parcels (land plots) in France. This tool queries the IGN API Carto cadastre module to find parcels by geometry intersection or administrative codes. Useful for property identification, urban planning, and administrative procedures. Args: geom (string, optional): GeoJSON geometry to intersect code_insee (string, optional): INSEE commune code (5 digits) code_dep (string, optional): Department code (2-3 digits) code_com (string, optional): Commune code within department (3 digits) section (string, optional): Cadastral section (2 characters) numero (string, optional): Parcel number source (string): Data source - 'pci' (PCI Express, recommended) or 'bdparcellaire' _limit (number): Max results (1-1000) _start (number): Pagination offset
Returns:
GeoJSON FeatureCollection with parcel geometries and properties including: numero: Parcel number feuille: Sheet number section: Cadastral section code_dep, code_com, com_abs, code_arr geometry: MultiPolygon
Examples: "Find parcels in commune 75101" -> code_insee="75101" "Get parcel AB-0001 in section AB" -> section="AB", numero="0001"
|
| ign_get_cadastre_communes | Get commune (municipality) boundaries from the cadastral database. Args: geom (string, optional): GeoJSON geometry to intersect code_insee (string, optional): INSEE commune code code_dep (string, optional): Department code _limit (number): Max results (default 500) _start (number): Pagination offset
Returns:
GeoJSON FeatureCollection with commune boundaries. |
| ign_get_rpg | Query the Registre Parcellaire Graphique (RPG) for agricultural parcel information. The RPG contains agricultural land use data declared by farmers for CAP (Common Agricultural Policy) subsidies. Two versions exist: Args: annee (number): Year of data (2010-2024) geom (string): GeoJSON geometry (required) code_cultu (string, optional): Crop culture code filter _limit (number): Max results _start (number): Pagination offset
Returns:
GeoJSON FeatureCollection with: V1: num_ilot, commune, surf_decla, code_cultu, nom_cultu V2: id_parcel, surf_parc, code_cultu, code_group, culture_d1, culture_d2
Examples: |
| ign_get_nature_areas | Query protected natural areas in France (Natura 2000, ZNIEFF, national parks, etc.). Available layers: natura2000-oiseaux: Natura 2000 bird directive sites natura2000-habitat: Natura 2000 habitat directive sites rnc: Corsican natural reserves rnn: National natural reserves rncf: Hunting and wildlife natural reserves pn: National parks pnr: Regional natural parks znieff1: ZNIEFF type 1 (remarkable ecological areas) znieff2: ZNIEFF type 2 (large natural ensembles) sic: Sites of Community Importance zps: Special Protection Areas
Args: layer (string): Nature layer to query geom (string, optional): GeoJSON geometry to intersect id_mnhn (string, optional): MNHN identifier _limit (number): Max results _start (number): Pagination offset
Returns:
GeoJSON FeatureCollection with protected area boundaries and attributes. Examples: "Find Natura 2000 sites at this location" -> layer="natura2000-habitat", geom=... "Get ZNIEFF zones near Paris" -> layer="znieff1", geom=...
|
| ign_get_gpu_urbanisme | Query the Géoportail de l'Urbanisme (GPU) for urban planning documents and zones. This tool accesses French urban planning data including local urban plans (PLU), zoning, and public utility easements. Available layers: municipality: Check if commune is under RNU (national regulation) document: Urban planning documents (PLU, PLUi, CC) zone-urba: Urban zones (U, AU, A, N) secteur-cc: Community map sectors prescription-surf/lin/pct: Surface/linear/point prescriptions info-surf/lin/pct: Informative zones assiette-sup-s/l/p: Public utility easement footprints generateur-sup-s/l/p: Public utility easement generators
Args: layer (string): GPU layer to query geom (string, optional): GeoJSON geometry to intersect partition (string, optional): Document partition ID categorie (string, optional): SUP category filter _limit (number): Max results _start (number): Pagination offset
Returns:
GeoJSON FeatureCollection with urban planning data. Examples: "Is this commune under RNU?" -> layer="municipality", geom=... "What's the zoning at this address?" -> layer="zone-urba", geom=... "Find building prescriptions here" -> layer="prescription-surf", geom=...
|
| ign_get_aoc_viticoles | Query wine appellation zones (AOC, IGP, VSIG) in France. This tool accesses wine appellation data maintained by FranceAgriMer based on INAO data. Args: geom (string): GeoJSON geometry to intersect (required) apikey (string, optional): IGN API key (required for this endpoint, get one at https://geoservices.ign.fr/) source (string): Data source - 'prd' (production) or 'qlf' (qualification). Default: 'prd'
Returns:
GeoJSON FeatureCollection with appellation zones including: Examples: "What wine appellations cover this vineyard?" -> geom={"type":"Point",...}, apikey="your-key" "Find AOC zones in Bordeaux region" -> geom={"type":"Polygon",...}, apikey="your-key"
Note: This endpoint requires an IGN API key. Get one for free at https://geoservices.ign.fr/ |
| ign_wfs_geoportail | Generic query interface for Geoportail WFS layers. This tool provides access to various WFS layers from the IGN Geoportail. It allows querying any WFS layer by intersection with a geometry. Args: source (string): WFS data source name (e.g., "BDTOPO_V3:commune", "LIMITES_ADMINISTRATIVES_EXPRESS.LATEST:commune") geom (string): GeoJSON geometry to intersect (required, in WGS84/EPSG:4326) _limit (number): Max results (1-1000) _start (number): Pagination offset
Returns:
GeoJSON FeatureCollection with features from the requested layer. Note: Only WGS84 (EPSG:4326) geometries are supported. Examples: "Get BDTOPO communes at this point" -> source="BDTOPO_V3:commune", geom={"type":"Point","coordinates":[2.35,48.85]} "Find buildings in this area" -> source="BDTOPO_V3:batiment", geom=...
|
| ign_get_administrative_limits | Query French administrative boundaries (communes, departments, regions). This tool accesses administrative limit data from the IGN Admin Express dataset. Args: type (string): Boundary type - 'commune', 'departement', or 'region' geom (string, optional): GeoJSON geometry to intersect lon (number, optional): Longitude coordinate (use with lat) lat (number, optional): Latitude coordinate (use with lon) _limit (number): Max results (1-1000) _start (number): Pagination offset
Note: Either provide geom OR (lon + lat), but not both. Returns:
GeoJSON FeatureCollection with administrative boundaries. Examples: "What commune is at this point?" -> type="commune", lon=2.35, lat=48.85 "What department is at this point?" -> type="departement", geom={"type":"Point",...} "Get regions intersecting this polygon" -> type="region", geom=...
|