Skip to main content
Glama

TOISE — intelligence foncière

Les filiales et sociétés liées d'un groupe

toise_groupe
Read-onlyIdempotent

Quelles sont les filiales et sociétés liées d'un groupe (« Vinci », « Bouygues », « Emerige ») ; patrimoine foncier d'un groupe et de ses filiales. Lien de DIRIGEANCE (SIREN), pas de détention ; homonymes à confirmer. avec_patrimoine pour le foncier. Vue complète d'un propriétaire en un appel : toise_owner_intelligence.

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

Input Schema

NameRequiredDescriptionDefault
nomNoNom du groupe ou de la société tête de…
sirenNo
limiteNo
profondeurNo1 = sociétés dirigées directement par le…
avec_patrimoineNoVrai : ajoute patrimoine_groupe, le…

Output Schema

NameRequiredDescriptionDefault
liensNoLiens vers la fiche TOISE et vers des services de…
quotaNoQuota du jour après cet appel : { fonction, limite…
ambiguNoVrai si le nom correspond à plusieurs sociétés : voir…
comptesNoliens_confirmes, niveau_1, niveau_2, actives, radiees…
curseurNo
lectureNoCe que les données ouvertes ne disent pas : pas de…
partielNotrue : une source n’a pas répondu, des champs manquent…
societeNoLa société tête de groupe résolue : siren, denomination…
sourcesNo
tronqueNoVrai si des sociétés à lien confirmé ne sont pas listées…
filialesNo
has_moreNoVrai si des sociétés à lien confirmé ne sont pas listées…
warningsNo
candidatsNo
perimetreNoPérimètre lu : profondeur demandée, niveaux, dénombrement…
couvertureNoSociétés lues, recherche tronquée, échecs éventuels.
registre_ukNoSi une maison mère GLEIF est au Royaume-Uni : Companies…
quota_unitesNoUnités d’usage du jour : consommees_par_cet_appel…
avertissementNo
champs_absentsNoDonnées absentes du résultat partiel.
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…
sirens_confirmesNoTous les SIREN à lien confirmé, même non listés.
maisons_meres_leiNoLEI de la société et ses maisons mères déclarées au GLEIF…
patrimoine_groupeNoSeulement avec avec_patrimoine : total_locaux…
homonymes_a_confirmerNoDénomination proche du groupe, aucun lien prouvé : à…
dirigeants_personnes_moralesNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • changedInput schema / properties / avec_patrimoine / description
      Previous value: -"Vrai : ajoute patrimoine_groupe, le patrimoine…"New value: +"Vrai : ajoute patrimoine_groupe, le…"
    • changedInput schema / properties / nom / description
      Previous value: -"Nom du groupe ou de la société tête de groupe…"New value: +"Nom du groupe ou de la société tête de…"
    • changedInput schema / properties / profondeur / description
      Previous value: -"1 = sociétés dirigées directement par le groupe…"New value: +"1 = sociétés dirigées directement par le…"
  2. Changed1 schema field changed
    • addedOutput schema / properties / registre_uk
      Added value: +{
      +  "description": "Si une maison mère GLEIF est au Royaume-Uni : Companies…",
      +  "type": [
      +    "object",
      +    "null"
      +  ]
      +}
  3. First observed

TDQS

A3.5/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 safety is covered. The description adds genuinely useful semantic caveats beyond that: the link is a DIRIGEANCE (SIREN) relation, not an ownership relation, and homonyms must be confirmed. Those are exactly the data-quality warnings that keep an agent from over-trusting results.

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?

It is short and front-loads the core purpose, but the style is fragmented — parenthetical examples, a semicolon-separated caveat, and a trailing tool reference with no connective structure. Nothing is wasted, yet the telegraphic phrasing costs readability for an agent parsing it once.

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?

An output schema exists, so return values need not be explained, and the annotations cover the safety profile. What remains thin is the operational detail: homonym disambiguation is flagged but not resolved (is there a confirmation flow?), and default behavior for limite/profondeur is left to the schema. Adequate but not complete for a multi-parameter lookup tool.

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 coverage is 60%, with nom, profondeur and avec_patrimoine documented in the schema. The description reinforces avec_patrimoine ('ajoute patrimoine_groupe' / 'pour le foncier') but says nothing about limite or siren, leaving a portion of the parameters to the schema alone. Baseline 3 is appropriate given partial coverage.

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 names a specific verb-and-resource: retrieving subsidiaries and related companies of a group (with examples like « Vinci », « Bouygues ») and, optionally, the group's real-estate holdings. It distinguishes itself reasonably from siblings by pointing at toise_owner_intelligence for the full owner view, though the phrasing is telegraphic rather than a clean statement of scope.

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 gives one explicit routing hint — 'avec_patrimoine pour le foncier' and 'Vue complète d'un propriétaire en un appel : toise_owner_intelligence' — which tells the agent when to use an alternative. But there is no explicit guidance on when not to use it, no prerequisites, and how it differs from the many other toise_* tools is only implied.

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