Skip to main content
Glama

TOISE — intelligence foncière

Entreprises autour d’un commerce (zone de chalandise)

toise_zone_chalandise
Read-onlyIdempotent

Combien d'habitants et quelle concurrence à 10 minutes de ce point : zone de chalandise en voiture, à pied ou en rayon, population, revenus, entreprises. Modes de transport (15/30/45 min), rayon, isodistance, trace, admin. Entreprises Sirene, habitants INSEE, revenus Filosofi, salariés URSSAF, trafic, transports. Plusieurs adresses : toise_comparer_zones (un seul appel).

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "mode": "<mode>"
    },
    "name": "toise_zone_chalandise"
  }
}

Input Schema

NameRequiredDescriptionDefault
kmNoRayon en km, de 1 à 30 (rayon, isodistance).
latNo
lonNo
modeYesvoiture, velo, poids_lourd : jusqu’à 45 min…
besoinNoBesoin métier du commerce…
ca_minNoChiffre d’affaires minimal en euros.
detailNoDéfaut false : sortie résumée…
limiteNo
profilNoProfil de cible NAF (restaurant, boulangerie…)…
traficNoAjouter le trafic routier…
adresseNo
curseurNo
minutesNoDurée du trajet, de 5 à 45 (voiture) ou 30…
decalageNo
secteursNoSections NAF à garder (lettres A à U), ex.…
transportsNoAjouter les arrêts de transport en commun dans…
demographieNoAjouter les habitants de la zone et leurs…
zone_traceeNoMode trace : GeoJSON Polygon [longitude…
effectif_minNoCode INSEE de la tranche d’effectif minimale de…
codes_postauxNoAjouter les codes postaux des communes que la…
proprietairesNoAjouter les propriétaires PERSONNES MORALES des…
naf_concurrentsNoCodes NAF (rév. 2) des concurrents, pour la…
zones_emboiteesNoTrois valeurs croissantes (ex. [5,10,15])…
ca_inconnu_excluNoAvec ca_min : exclure aussi les sociétés dont…
adresse_confirmeeNoAdresse choisie par l’utilisateur, remplace…
confirmer_adresseNotrue = adresse retenue confirmée par…
zone_administrativeNoMode admin : { type…

Output Schema

NameRequiredDescriptionDefault
okYes
liensNoLiens vers la fiche TOISE et vers des services de…
quotaNoQuota du jour après cet appel : { fonction, limite…
actifsNoSalariés privés URSSAF au 31/12/2025 des communes touchées…
besoinNoBesoin métier retenu : cle, intitule, fonctions à viser…
departNo
totauxYesSociétés, établissements, hors zone, non géolocalisés…
traficNoTrafic routier (TMJA, sources ouvertes) : tronçons de la…
completNoVrai si l’annuaire a été lu en entier…
curseurNo
partielNotrue : une source n’a pas répondu, des champs manquent…
repriseNoVrai si cet appel reprend une lecture déjà décomptée.
sourcesNo
criteresNoEffectif minimal…
cyclableNoBNAC autour du départ : km_500m, km_1km, km protégés, piste…
decalageNo
has_moreYesVrai si la liste a d’autres éléments : rappeler avec…
lecturesNo
segmentsNoRépartition par taille, secteur, palier et commune.
societesYes
tourismeNoDATAtourisme dans la zone : comptage…
warningsYesAvertissements (paramètres ignorés, données partielles).
emboiteesNoZones emboîtées : niveaux (primaire, secondaire, tertiaire)…
incompletYesVrai si la lecture de l’annuaire n’est pas terminée…
perimetreYesIntitulé, mode, paliers, communes touchées, surface de la…
navetteursNoINSEE MOBPRO des communes touchées (majorant)…
transportsNoArrêts de transport en commun (transport.data.gouv.fr)…
demographieNoHabitants de la zone estimés à l’IRIS…
detail_omisNoBlocs omis du résumé…
street_viewNoLien sortant vers Google Street View au point de départ…
flux_pietonsNoFlux piéton RECONSTRUIT (estimation, non mesurée) au point…
profil_cibleNoProfil NAF proposé (directs, indirects, prescripteurs)…
quota_unitesNoUnités d’usage du jour : consommees_par_cet_appel…
codes_postauxNoCodes postaux des communes touchées (ok, nombre, liste).
proprietairesNoPropriétaires personnes morales agrégés par SIREN…
champs_absentsNoDonnées absentes du résultat partiel.
liste_tronqueeNoVrai si la page ne contient pas toutes les sociétés de la…
sources_detailNo
total_societesNoSociétés de toute la zone (avant pagination).
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…
densite_concurrentsNoConcurrents (NAF choisis) dans la zone, au moins N si la…

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • addedOutput schema / properties / cyclable
      Added value: +{
      +  "description": "BNAC autour du départ : km_500m, km_1km, km protégés, piste…",
      +  "type": "object"
      +}
    • addedOutput schema / properties / flux_pietons
      Added value: +{
      +  "description": "Flux piéton RECONSTRUIT (estimation, non mesurée) au point…",
      +  "type": [
      +    "object",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / navetteurs
      Added value: +{
      +  "description": "INSEE MOBPRO des communes touchées (majorant)…",
      +  "type": "object"
      +}
  2. Changed1 schema field changed
    • addedOutput schema / properties / tourisme
      Added value: +{
      +  "description": "DATAtourisme dans la zone : comptage…",
      +  "type": "object"
      +}
  3. Changed1 schema field changed
    • changedInput schema / properties / mode / enum
      Previous value: -[
      -  "voiture",
      -  "a_pied",
      -  "velo",
      -  "poids_lourd",
      -  "rayon",
      -  "isodistance",
      -  "trace",
      -  "admin"
      -]New value: +[
      +  "voiture",
      +  "a_pied",
      +  "velo",
      +  "poids_lourd",
      +  "rayon",
      +  "isodistance",
      +  "trace",
      +  "admin",
      +  "transports_commun"
      +]
  4. Changed7 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 / ca_inconnu_exclu / description
      Previous value: -"Avec ca_min : exclure aussi les sociétés dont le…"New value: +"Avec ca_min : exclure aussi les sociétés dont…"
    • 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 / demographie / description
      Previous value: -"Ajouter les habitants de la zone et leurs revenus…"New value: +"Ajouter les habitants de la zone et leurs…"
    • changedInput schema / properties / transports / description
      Previous value: -"Ajouter les arrêts de transport en commun dans la…"New value: +"Ajouter les arrêts de transport en commun dans…"
    • changedInput schema / properties / zones_emboitees / description
      Previous value: -"Trois valeurs croissantes (ex. [5,10,15]) : zones…"New value: +"Trois valeurs croissantes (ex. [5,10,15])…"
    • addedOutput schema / properties / actifs
      Added value: +{
      +  "description": "Salariés privés URSSAF au 31/12/2025 des communes touchées…",
      +  "type": [
      +    "object",
      +    "null"
      +  ]
      +}
  5. First observed

TDQS

B3.3/5.0
Behavior3/5

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

Annotations already declare the operation read-only, idempotent and non-destructive, so safety is covered. The description adds the data sources underlying the answer (Sirene, INSEE Filosofi, URSSAF, traffic, transit), which is useful context, but says nothing about compute cost, latency, or limits on iterations — relevant for a heavy geospatial query with 27 inputs.

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

Conciseness3/5

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

The core question is front-loaded and the whole thing is only three sentences, but they are telegraphic noun lists that partly repeat themselves (population/incomes/businesses stated twice). It reads as keyword dumping rather than structured prose, which costs clarity without saving much length.

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?

Return values are covered by an output schema and safety by annotations, so the description need not repeat them. For a 27-parameter tool with nested objects and four enums, though, the description leaves the agent to infer the interaction between mode, geometry parameters and the many optional enrichment flags.

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 78% schema coverage the schema already documents most parameters, and the description's mode taxonomy (car/walk/radius, isodistance, trace, admin) and 15/30/45-minute framing map onto mode and minutes. However, many flags (ca_min, effectif_min, zones_emboitees, curseur, decalage, adresse_confirmee) get no explanation in the description, so it does not fully compensate.

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 opening sentence states a concrete question answered (how many residents, what competition within 10 minutes of a point) and enumerates the supported geometries and metrics, so the resource is unmistakable. It also explicitly contrasts itself with toise_comparer_zones, though it does not distinguish itself from other analysis siblings such as toise_etude_marche.

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?

There is one genuine routing rule: for several addresses, use toise_comparer_zones in a single call. Beyond that, the description only implies usage through the mode list and never says when this tool is preferable to adjacent market-study tools, nor which mode to pick for a given question.

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