Skip to main content
Glama

TOISE — intelligence foncière

Les permis déposés sur une parcelle

toise_permis
Read-onlyIdempotent

Tous les permis d'un promoteur ou d'une société (nom ou SIREN du demandeur), ou les permis de construire autour d'une adresse dans un rayon, avec logements et surfaces. Source Sitadel. Entrée : code_insee, lat/lon + rayon_m, siren_demandeur ou demandeur ; avec_filiales pour un groupe.

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_permis"
  }
}

Input Schema

NameRequiredDescriptionDefault
latNo
lonNo
depuisNoNe garder que les dossiers déposés à partir de…
limiteNo
adresseNo
curseurNo
rayon_mNo
sectionNo
demandeurNoNom ou fragment de nom du demandeur…
code_inseeNo
avec_filialesNoAvec demandeur ou siren_demandeur : élargit au…
sans_chantierNoNe garder que les permis autorisés dont Sitadel…
numero_parcelleNo
siren_demandeurNoSIREN du demandeur, 9 chiffres : tous les…
anciennete_max_ansNoAvec sans_chantier : ancienneté maximale de…
anciennete_min_ansNoAvec sans_chantier : ancienneté minimale de…

Output Schema

NameRequiredDescriptionDefault
codeNoDEMANDEUR_AMBIGU quand la désambiguïsation est impossible…
liensNoLiens vers la fiche TOISE et vers des services de…
quotaNoQuota du jour après cet appel : { fonction, limite…
totalYesDossiers correspondants.
ambiguNoVrai si le nom correspond à plusieurs SIREN : aucun dossier…
groupeNoAvec avec_filiales : le groupe résolu…
curseurYes
lectureNoLimites de la recherche par demandeur.
partielNotrue : une source n’a pas répondu, des champs manquent…
sourcesYes
dossiersYes
has_moreYesVrai si curseur permet de lire la suite.
warningsYes
candidatsNoAvec ambigu : les SIREN distincts, leurs dénominations et…
par_sirenNoNom ambigu résolu : total par SIREN lu.
perimetreYes
retournesNoNombre de dossiers réellement rendus après dédoublonnage.
vide_motifNoPrésent quand aucun dossier : pourquoi ce vide ne prouve…
total_exactNoVrai si la lecture est complète : total égale les dossiers…
quota_unitesNoUnités d’usage du jour : consommees_par_cet_appel…
champs_absentsNoDonnées absentes du résultat partiel.
total_par_baseNoTotal brut par base Sitadel (locaux, logements).
curseur_suivantNoAncien nom de curseur, même valeur.
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…
repartition_lueNoAvec avec_filiales : dossiers lus par catégorie…
sirens_interrogesNoAvec avec_filiales : nombre de SIREN interrogés dans…

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / siren_demandeur / description
      Previous value: -"SIREN du demandeur, 9 chiffres : tous les permis…"New value: +"SIREN du demandeur, 9 chiffres : tous les…"
  2. First observed

TDQS

B3.4/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=true, idempotentHint=true, destructiveHint=false and openWorldHint=true, so the safety profile is covered. The description adds real value by disclosing the data source (Sitadel) and the payload content (logements, surfaces), but says nothing about result volume, pagination behaviour, or coverage limits of the source.

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?

Two compact sentences, front-loaded with the capability and followed by the entry modes; nothing is padded. The trailing 'Entrée :' list partly restates schema property names, which is the only slack.

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

Completeness3/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 tool the description covers the two main access paths and the return content, and an output schema exists so return-value detail is not needed. However, the pagination pair (limite/curseur), the date filter (depuis), plot-level identifiers (section/numero_parcelle) and the sans_chantier family are undocumented, and the title's 'sur une parcelle' framing is inconsistent with a description centred on promoter and address searches.

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?

Schema description coverage is only 44% across 16 parameters, so the description has to compensate and only partly does: it clarifies that demande by name/SIREN and geo/address lookup are alternative entry paths and explains avec_filiales' effect. It leaves depuis, limite, curseur, section, numero_parcelle, sans_chantier and the anciennete range filters entirely unaddressed.

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 states a concrete verb+resource: retrieving all building permits for a developer/company (by name or SIREN) or permits around an address within a radius, including housing counts and surfaces, sourced from Sitadel. It is specific about what is returned, but never distinguishes itself from plausibly overlapping siblings such as toise_dossier_adresse or toise_contraintes.

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

Usage Guidelines3/5

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

It lays out two selectable query modes (promoter/SIREN versus address + lat/lon + rayon_m) and says avec_filiales extends to a group, which implicitly guides parameter choice. It gives no explicit 'when not to use this' and never names an alternative tool, so the routing guidance is implied rather than stated.

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