French cadastral parcels and zoning in an area

Every French cadastral parcel in an area, with its reference, its area and the urban plan zone it lies in, as a GIS file.

Request

curl -X POST https://mcp.terra-lab.ai/v1/tools/french_parcels_in_area \
  -H "Authorization: Bearer $TERRALAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area":{"place":"Palais de l'\''Isle, Annecy","radius_m":1000},"formats":["geojson","csv"]}'

import os
import requests

response = requests.post(
    "https://mcp.terra-lab.ai/v1/tools/french_parcels_in_area",
    headers={"Authorization": f"Bearer {os.environ['TERRALAB_API_KEY']}"},
    json={
        "area": {
            "place": "Palais de l'Isle, Annecy",
            "radius_m": 1000,
        },
        "formats": ["geojson", "csv"],
    },
    timeout=120,
)
response.raise_for_status()
print(response.json()["structuredContent"])

const response = await fetch('https://mcp.terra-lab.ai/v1/tools/french_parcels_in_area', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.TERRALAB_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "area": {
      "place": "Palais de l'Isle, Annecy",
      "radius_m": 1000
    },
    "formats": [
      "geojson",
      "csv"
    ]
  }),
});
const data = await response.json();
console.log(data.structuredContent);

Parameters

A JSON object in the request body; in an MCP client, the arguments of the tool call.

Response

structuredContent holds the result, content the same result as text for a model, and isError is true when the tool refused the request or failed; then structuredContent.code, message and hint say what to change.

{
  "structuredContent": {
    "sources": [{ "name": "...", "licence": "...", "url": "..." }],
    "downloads": [{ "label": "...", "format": "...", "url": "...", "name": "..." }]
  },
  "content": [{ "type": "text", "text": "..." }],
  "isError": false
}

Every result lists its sources with their licence. File results come as downloads: each link builds its file when opened.

Errors

A missing key answers 401, an empty balance 402, too many calls 429. A call that fails or finds nothing is not counted. See Errors and rate limits.

Description for agents

The text the server gives an agent to decide when to call this tool:

Use this when the user asks for all the cadastral parcels (parcelles cadastrales) in an area of France, for example "the parcels within 1 km of Annecy old town" or "the plots and their PLU zones in this bbox": each parcel with its reference (commune, INSEE code, section, number), cadastral area and the local urban plan zone it lies in (PLU or PLUi: label, type U, AU, A or N, document). The area is a place with a radius (default 300 m, at most 1,000 m) or a bbox of at most 4 km². For the single parcel at one address or point, use french_parcel instead. Shows the parcels on a map with GeoJSON, KML, Shapefile zip or CSV downloads. France only. Never returns owners or property sales. Never use the user's current location unless they type it. Give the place as the user names it (place name, address or coordinates): this tool locates it, so find_places is not needed first. Download links build their file when opened; no file is saved. The user opens the file in QGIS or any GIS: this server cannot load it into the user's own QGIS or any app on their computer. Never pass these links to open_gis_file: list every format the user needs in formats, in this one call.