Skip to main content
Glama

TOISE — intelligence foncière

Ventes immobilières individuelles (DVF, 5 ans)

toise_dvf_historique
Read-onlyIdempotent

Prix de vente et comparables : ventes récentes autour d'une adresse (rayon, type, surface), prix au m², médiane et fourchette ; ou toutes les ventes d'une commune. Mode comparables : adresse (ou lat/lon + code_insee) et type OBLIGATOIRE ; type inconnu : sans mode, code_insee, lat/lon, rayon_m. Une vente : id_mutation + code_insee. DVF 2021-2025 ; médiane dès 5 ventes.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "toise_dvf_historique"
  }
}

Input Schema

NameRequiredDescriptionDefault
latNo
lonNo
triNoMode comparables : ordre des ventes rendues…
modeNohistorique (défaut) : liste des mutations…
typeNoOBLIGATOIRE en mode comparables…
depuisNoPremière année (2021 par défaut).
limiteNo
natureNoNature de la mutation.
adresseNo
rayon_mNo
sectionNo
prix_maxNoValeur foncière maximale, €.
prix_minNoValeur foncière minimale, €.
code_inseeNo
surface_m2NoMode comparables : surface du bien à…
id_mutationNoUne vente par identifiant DVF, avec…
surface_maxNoSurface maximale, m².
surface_minNoSurface bâtie (ou de terrain) minimale, m².
adresse_confirmeeNoAdresse choisie par l’utilisateur, remplace…
confirmer_adresseNotrue = adresse retenue confirmée par…
tolerance_surface_pctNoMode comparables : écart de surface accepté…

Output Schema

NameRequiredDescriptionDefault
modeNo
liensNoLiens vers la fiche TOISE et vers des services de…
quotaNoQuota du jour après cet appel : { fonction, limite…
totalYesNombre réel de mutations correspondant aux filtres…
centreNoMode comparables : point de recherche.
ventesNo
curseurNo
filtresNo
partielNotrue : une source n’a pas répondu, des champs manquent…
renduesNo
sourcesYes
has_moreYesVrai si des mutations correspondantes ne sont pas rendues…
plafonneNo
warningsYes
millesimeNoProfondeur réelle : { debut, fin } des années lues.
par_anneeYesPar année : volume, ventes_multi_lots…
code_inseeYes
estimationNoMode estimation : { ok, valeur {surface_m2, basse, mediane…
annees_luesNo
comparablesNoMode comparables : ventes triées, avec prix_m2, distance_m…
base_medianeNoBase de la médiane publiée par cet outil : { outil…
loyer_marcheNoMode comparables, appartement/maison : loyer de marché…
quota_unitesNoUnités d’usage du jour : consommees_par_cet_appel…
statistiquesNoMode comparables : nombre, prix_m2_median, quartiles, min…
avertissementNo
cessions_etatNoMode historique : cessions immobilières de l’État dans la…
champs_absentsNoDonnées absentes du résultat partiel.
limites_sourceNoLimites de DVF : période, cessions de parts invisibles…
limite_atteinteNoPrésent quand un quota, une limite d’offre ou une fonction…
paiement_requisNoPrésent quand le résultat complet est un achat à l’acte…
periode_couverteNo{ debut, fin, annees, trous } : période réellement lue…
statut_historiqueNo{ statut: ventes_trouvees | aucune_vente_trouvee…
motif_absence_loyerNo
rendement_brut_indicatifNoMode comparables : loyer annuel ÷ prix…
annees_absentes_ou_en_erreurNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changed
    • changedInput schema / properties / id_mutation / description
      Previous value: -"Une vente par identifiant DVF, avec code_insee."New value: +"Une vente par identifiant DVF, avec…"
    • changedInput schema / properties / mode / description
      Previous value: -"historique (défaut) : liste des mutations d'une…"New value: +"historique (défaut) : liste des mutations…"
    • changedInput schema / properties / surface_m2 / description
      Previous value: -"Mode comparables : surface du bien à comparer…"New value: +"Mode comparables : surface du bien à…"
    • changedInput schema / properties / tolerance_surface_pct / description
      Previous value: -"Mode comparables : écart de surface accepté en…"New value: +"Mode comparables : écart de surface accepté…"
  2. Changed1 schema field changed
    • addedInput schema / properties / id_mutation
      Added value: +{
      +  "description": "Une vente par identifiant DVF, avec code_insee.",
      +  "type": "string"
      +}
  3. Changed5 schema fields changed
    • changedInput schema / properties / adresse_confirmee / description
      Previous value: -"Adresse confirmée par l'utilisateur…"New value: +"Adresse choisie par l’utilisateur, remplace…"
    • changedInput schema / properties / confirmer_adresse / description
      Previous value: -"true = l'utilisateur a confirmé l'adresse retenue…"New value: +"true = adresse retenue confirmée par…"
    • changedInput schema / properties / surface_m2 / description
      Previous value: -"Mode comparables : surface du bien à comparer, m²."New value: +"Mode comparables : surface du bien à comparer…"
    • changedInput schema / properties / tolerance_surface_pct / description
      Previous value: -"Mode comparables : écart de surface accepté en %…"New value: +"Mode comparables : écart de surface accepté en…"
    • addedOutput schema / properties / cessions_etat
      Added value: +{
      +  "description": "Mode historique : cessions immobilières de l’État dans la…",
      +  "type": "object"
      +}
  4. First observed

TDQS

A3.9/5.0
Behavior4/5

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

Annotations already declare readOnly, idempotent, openWorld and non-destructive, so the safety profile is covered. The description adds genuinely new behavioural facts: the dataset is limited to DVF 2021-2025 and the median is only computed from 5 or more sales, which materially affects interpretation of results. It does not mention limits/pagination behaviour or error cases when an address cannot be resolved.

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?

The text is short, front-loaded with the purpose, then moves to mode-specific requirements — no filler sentences. It is dense to the point of being telegraphic ('type inconnu : sans mode, code_insee, lat/lon, rayon_m'), which costs some readability but wastes no words.

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

Completeness4/5

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

An output schema exists, so return values need no explanation, and the annotations cover safety and idempotency. For a 21-parameter, multi-mode tool the description captures the branching logic and the data vintage, which is what an agent most needs; only the address-confirmation workflow and result-count limits remain undocumented.

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

Parameters3/5

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

With 21 parameters and only 67% schema description coverage, the description compensates for the most important ones: `mode`, `type` (mandatory in comparables mode), the adresse vs. lat/lon+code_insee alternative, `rayon_m`, and the id_mutation+code_insee pairing for a single sale. However, many parameters (depuis, limite, nature, section, prix_min/max, surface_min/max, tolerance_surface_pct, tri, and the address-confirmation pair) get no added meaning in the prose, leaving a substantial gap for such a wide schema.

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?

The description opens with a specific verb+resource pair ('Prix de vente et comparables : ventes récentes autour d'une adresse... ou toutes les ventes d'une commune') and names the outputs (prix au m², médiane, fourchette). It also distinguishes the internal modes (comparables vs. commune-wide listing) so an agent can tell the two behaviours apart, though it never contrasts itself with a named sibling tool.

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?

It gives explicit routing conditions: use `comparables` mode with adresse (or lat/lon + code_insee) and a mandatory `type`; if the type is unknown, call without `mode` using code_insee/lat/lon/rayon_m; for a single sale use id_mutation + code_insee. That is clear when-to-use guidance across its own modes, but it offers no exclusion relative to alternative tools in the catalog.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources