Parcellaire — cadastre, DVF & DPE

Ventes immobilières (DVF) dans une zone

search_ventes_dvf

Read-onlyIdempotent

Liste les ventes immobilières (DVF) d'une zone : autour d'une adresse, d'une parcelle ou d'un point (rayon), ou dans toute une commune — idéal pour trouver des biens comparables. Une ligne par vente : date, prix, type de bien, surface bâtie, pièces, terrain, parcelles, prix au m² (quand la vente porte sur un seul logement). Retourne aussi la médiane du prix au m² des ventes filtrées. Seules les ventes géolocalisées sont couvertes (depuis 2021), hors Alsace-Moselle (Bas-Rhin, Haut-Rhin, Moselle), absente du fichier DVF. Filtrer par 'type_bien' pour des prix au m² comparables.

Input Schema

Name	Required	Description
`lat`	No	Latitude du centre (avec 'lng')
`lng`	No	Longitude du centre (avec 'lat')
`tri`	No	Tri des ventes (défaut : date décroissante ; distance pour les plus proches)
`limit`	No	Ventes par page (défaut 10, max 50)
`offset`	No	Index de départ pour la pagination (défaut 0, max 5000). Utiliser pagination.next_offset pour la page suivante.
`address`	No	Adresse postale au centre de la zone
`commune`	No	Nom de la commune, ex: 'Angers'. Pour une commune homonyme, préciser son code entre parenthèses : 'Thénac (17444)' (code INSEE), 'Thénac (17460)' (code postal) ou 'Thénac (17)' (département). Couvre toute la commune (ignore 'rayon_m').
`rayon_m`	No	Rayon autour du centre en mètres (défaut 500, max 25000)
`date_max`	No	Borne maximale inclusive au format ISO 'AAAA-MM-JJ', ex: '2026-09-30'. Omettre pour ne pas fixer de maximum.
`date_min`	No	Borne minimale inclusive au format ISO 'AAAA-MM-JJ', ex: '2026-09-15' (défaut 2021-01-01). Pour une plage, utiliser date_min et date_max séparément, pas une plage dans ce champ.
`type_bien`	No	Type de bien vendu : 'maison', 'appartement' ou 'local' (local commercial, industriel ou assimilé)
`parcelle_id`	No	IDU d'une parcelle au centre de la zone
`prix_max_eur`	No	Prix de vente maximal en euros, ex: 400000
`prix_min_eur`	No	Prix de vente minimal en euros, ex: 150000
`surface_max_m2`	No	Surface bâtie maximale en m², ex: 120
`surface_min_m2`	No	Surface bâtie minimale en m², ex: 60

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 31, 2026

changedInput schema / properties / limit / description

Previous value: -"Ventes par page (défaut 20, max 50)"New value: +"Ventes par page (défaut 10, max 50)"

Changed1 schema field changedOct 15, 2026

changedInput schema / properties / commune / description

Previous value: -"Nom de commune : toute la commune (ignore 'rayon_m')"New value: +"Nom de la commune, ex: 'Angers'. Pour une commune homonyme, préciser son code entre parenthèses : 'Thénac (17444)' (code INSEE), 'Thénac (17460)' (code postal) ou 'Thénac (17)' (département). Couvre toute la commune (ignore 'rayon_m')."

Changed2 schema fields changedOct 7, 2026

changedInput schema / properties / date_max / description

Previous value: -"Date maximale 'AAAA-MM-JJ'"New value: +"Borne maximale inclusive au format ISO 'AAAA-MM-JJ', ex: '2026-09-30'. Omettre pour ne pas fixer de maximum."

changedInput schema / properties / date_min / description

Previous value: -"Date minimale 'AAAA-MM-JJ' (défaut 2021-01-01)"New value: +"Borne minimale inclusive au format ISO 'AAAA-MM-JJ', ex: '2026-09-15' (défaut 2021-01-01). Pour une plage, utiliser date_min et date_max séparément, pas une plage dans ce champ."

Changed2 schema fields changedOct 7, 2026

changedInput schema / properties / rayon_m / anyOf

Previous value: -[
-  {
-    "anyOf": [
-      {
-        "maximum": 2000,
-        "minimum": 50,
-        "type": "integer"
-      },
-      {
-        "const": "",
-        "type": "string"
-      }
-    ]
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "anyOf": [
+      {
+        "maximum": 25000,
+        "minimum": 50,
+        "type": "integer"
+      },
+      {
+        "const": "",
+        "type": "string"
+      }
+    ]
+  },
+  {
+    "type": "null"
+  }
+]

changedInput schema / properties / rayon_m / description

Previous value: -"Rayon autour du centre en mètres (défaut 500, max 2000)"New value: +"Rayon autour du centre en mètres (défaut 500, max 25000)"

Changed6 schema fields changedOct 2, 2026

addedInput schema / properties / offset / description

Added value: +"Index de départ pour la pagination (défaut 0, max 5000). Utiliser pagination.next_offset pour la page suivante."

addedInput schema / properties / prix_max_eur / description

Added value: +"Prix de vente maximal en euros, ex: 400000"

addedInput schema / properties / prix_min_eur / description

Added value: +"Prix de vente minimal en euros, ex: 150000"

addedInput schema / properties / surface_max_m2 / description
```
Added value: +"Surface bâtie maximale en m², ex: 120"
```
addedInput schema / properties / surface_min_m2 / description
```
Added value: +"Surface bâtie minimale en m², ex: 60"
```

addedInput schema / properties / type_bien / description

Added value: +"Type de bien vendu : 'maison', 'appartement' ou 'local' (local commercial, industriel ou assimilé)"

Changed1 schema field changedSep 25, 2026
- addedInput schema / additionalProperties
```
Added value: +false
```

Changed1 schema field changedSep 25, 2026

changedInput schema / properties / tri / description

Previous value: -"Tri des ventes (défaut : distance autour d'un point, date pour une commune)"New value: +"Tri des ventes (défaut : date décroissante ; distance pour les plus proches)"

Changed45 schema fields changedSep 25, 2026

addedInput schema / properties / address / anyOf

Added value: +[
+  {
+    "anyOf": [
+      {
+        "minLength": 3,
+        "type": "string"
+      },
+      {
+        "const": "",
+        "type": "string"
+      }
+    ]
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / address / minLength
```
Removed value: -3
```
removedInput schema / properties / address / type
```
Removed value: -"string"
```

addedInput schema / properties / commune / anyOf

Added value: +[
+  {
+    "anyOf": [
+      {
+        "type": "string"
+      },
+      {
+        "const": "",
+        "type": "string"
+      }
+    ]
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / commune / type
```
Removed value: -"string"
```

addedInput schema / properties / date_max / anyOf

Added value: +[
+  {
+    "anyOf": [
+      {
+        "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+        "type": "string"
+      },
+      {
+        "const": "",
+        "type": "string"
+      }
+    ]
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / date_max / pattern
```
Removed value: -"^\\d{4}-\\d{2}-\\d{2}$"
```
removedInput schema / properties / date_max / type
```
Removed value: -"string"
```

addedInput schema / properties / date_min / anyOf

Added value: +[
+  {
+    "anyOf": [
+      {
+        "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+        "type": "string"
+      },
+      {
+        "const": "",
+        "type": "string"
+      }
+    ]
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / date_min / pattern
```
Removed value: -"^\\d{4}-\\d{2}-\\d{2}$"
```
removedInput schema / properties / date_min / type
```
Removed value: -"string"
```

addedInput schema / properties / lat / anyOf

Added value: +[
+  {
+    "anyOf": [
+      {
+        "type": "number"
+      },
+      {
+        "const": "",
+        "type": "string"
+      }
+    ]
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / lat / type
```
Removed value: -"number"
```

addedInput schema / properties / limit / anyOf

Added value: +[
+  {
+    "anyOf": [
+      {
+        "maximum": 50,
+        "minimum": 1,
+        "type": "integer"
+      },
+      {
+        "const": "",
+        "type": "string"
+      }
+    ]
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / limit / maximum
```
Removed value: -50
```
removedInput schema / properties / limit / minimum
```
Removed value: -1
```
removedInput schema / properties / limit / type
```
Removed value: -"integer"
```

addedInput schema / properties / lng / anyOf

Added value: +[
+  {
+    "anyOf": [
+      {
+        "type": "number"
+      },
+      {
+        "const": "",
+        "type": "string"
+      }
+    ]
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / lng / type
```
Removed value: -"number"
```

addedInput schema / properties / offset / anyOf

Added value: +[
+  {
+    "anyOf": [
+      {
+        "maximum": 5000,
+        "minimum": 0,
+        "type": "integer"
+      },
+      {
+        "const": "",
+        "type": "string"
+      }
+    ]
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / offset / maximum
```
Removed value: -5000
```
removedInput schema / properties / offset / minimum
```
Removed value: -0
```
removedInput schema / properties / offset / type
```
Removed value: -"integer"
```

addedInput schema / properties / parcelle_id / anyOf

Added value: +[
+  {
+    "anyOf": [
+      {
+        "maxLength": 14,
+        "minLength": 14,
+        "type": "string"
+      },
+      {
+        "const": "",
+        "type": "string"
+      }
+    ]
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / parcelle_id / maxLength
```
Removed value: -14
```
removedInput schema / properties / parcelle_id / minLength
```
Removed value: -14
```
removedInput schema / properties / parcelle_id / type
```
Removed value: -"string"
```

addedInput schema / properties / prix_max_eur / anyOf

Added value: +[
+  {
+    "anyOf": [
+      {
+        "type": "number"
+      },
+      {
+        "const": "",
+        "type": "string"
+      }
+    ]
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / prix_max_eur / type
```
Removed value: -"number"
```

addedInput schema / properties / prix_min_eur / anyOf

Added value: +[
+  {
+    "anyOf": [
+      {
+        "type": "number"
+      },
+      {
+        "const": "",
+        "type": "string"
+      }
+    ]
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / prix_min_eur / type
```
Removed value: -"number"
```

addedInput schema / properties / rayon_m / anyOf

Added value: +[
+  {
+    "anyOf": [
+      {
+        "maximum": 2000,
+        "minimum": 50,
+        "type": "integer"
+      },
+      {
+        "const": "",
+        "type": "string"
+      }
+    ]
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / rayon_m / maximum
```
Removed value: -2000
```
removedInput schema / properties / rayon_m / minimum
```
Removed value: -50
```
removedInput schema / properties / rayon_m / type
```
Removed value: -"integer"
```

addedInput schema / properties / surface_max_m2 / anyOf

Added value: +[
+  {
+    "anyOf": [
+      {
+        "type": "number"
+      },
+      {
+        "const": "",
+        "type": "string"
+      }
+    ]
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / surface_max_m2 / type
```
Removed value: -"number"
```

addedInput schema / properties / surface_min_m2 / anyOf

Added value: +[
+  {
+    "anyOf": [
+      {
+        "type": "number"
+      },
+      {
+        "const": "",
+        "type": "string"
+      }
+    ]
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / surface_min_m2 / type
```
Removed value: -"number"
```

addedInput schema / properties / tri / anyOf

Added value: +[
+  {
+    "anyOf": [
+      {
+        "enum": [
+          "date",
+          "distance"
+        ],
+        "type": "string"
+      },
+      {
+        "const": "",
+        "type": "string"
+      }
+    ]
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / tri / enum

Removed value: -[
-  "date",
-  "distance"
-]

removedInput schema / properties / tri / type
```
Removed value: -"string"
```

addedInput schema / properties / type_bien / anyOf

Added value: +[
+  {
+    "anyOf": [
+      {
+        "enum": [
+          "maison",
+          "appartement",
+          "local"
+        ],
+        "type": "string"
+      },
+      {
+        "const": "",
+        "type": "string"
+      }
+    ]
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / type_bien / enum

Removed value: -[
-  "maison",
-  "appartement",
-  "local"
-]

removedInput schema / properties / type_bien / type
```
Removed value: -"string"
```

First observedSep 25, 2026

TDQS

A4.3/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover the safe-read profile (readOnly, idempotent, non-destructive), and the description adds substantial behavioral context: the per-row output fields, the returned median price per m², and the coverage limitations (geolocated sales only since 2021, Alsace-Moselle excluded). These data-scope caveats are exactly the kind of insight annotations cannot convey.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose and scope are front-loaded in the first sentence, and the remaining sentences on output shape, median, and coverage limits each carry information. It is dense but not padded, though slightly long.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 16-parameter, zero-required search tool with no output schema, the description supplies the geographic modes, the returned fields and median, and the temporal/geographic coverage constraints. Nothing essential to calling it correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description adds real meaning: it maps the geographic modes to parameters and advises filtering by 'type_bien' to obtain comparable price-per-m² figures. That combination guidance goes beyond the individual field descriptions.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb ('Liste') and resource ('ventes immobilières DVF') and enumerates the geographic modes (address, parcel, point with radius, commune), so the agent knows exactly what the tool returns. It does not explicitly distinguish itself from siblings like estimate_property_price or get_commune_stats, keeping it at a 4.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Frames the use case ('idéal pour trouver des biens comparables') and clarifies each spatial mode of use, giving clear context for selection. It names no alternative tool and states no when-not-to-use conditions, so it stops short of a 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Parcellaire — cadastre, DVF & DPE tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?