Skip to main content
Glama

checkers.fr — entreprises françaises

Rechercher des dirigeants

rechercher_dirigeants
Read-onlyIdempotent

Recherche les dirigeants d’entreprises (personnes physiques et sociétés mandataires) par leur nom, et renvoie pour chacun ses mandats et les entreprises concernées. Le registre ne diffuse que le mois et l’année de naissance : utilisez-les pour distinguer deux homonymes. Pour une entreprise dont on connaît le nom, préférez fiche_entreprise, qui liste déjà ses dirigeants. Coût : 0,1 crédit par personne renvoyé, rien si aucun.

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": "rechercher_dirigeants"
  }
}

Input Schema

NameRequiredDescriptionDefault
qNoPrénom et nom, dans n’importe quel ordre (« Marie Dupont »).
pageNoPage de résultats (1 par défaut). Les 400 premiers résultats au plus sont accessibles.
code_nafNoCodes NAF (APE) de l’activité, séparés par des virgules : « 62.01Z,62.02A ». Un code partiel (« 62 », « 43.2 ») couvre toutes ses sous-classes.
par_pageNoNombre de résultats renvoyés (10 par défaut). Chaque résultat est facturé : n’en demandez pas plus qu’il n’en faut.
departementNoDépartements du siège des entreprises dirigées, séparés par des virgules.
nom_dirigeantNoNom de famille (plus précis que q).
prenom_dirigeantNoPrénom (avec nom_dirigeant).
age_dirigeant_maxNoÂge maximal d’au moins un dirigeant en fonction.
age_dirigeant_minNoÂge minimal d’au moins un dirigeant en fonction.
date_de_naissance_dirigeant_maxNoNé au plus tard à cette date au format JJ-MM-AAAA ou AAAA-MM-JJ.
date_de_naissance_dirigeant_minNoNé à partir de cette date au format JJ-MM-AAAA ou AAAA-MM-JJ (seuls le mois et l’année comptent).

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.9/5.0
Behavior5/5

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

Annotations already declare readOnly/idempotent/non-destructive, so the bar is lower; the description still adds two non-obvious traits: the registry only publishes month and year of birth, and billing is 0.1 credit per returned person with nothing charged on an empty result. Those are the facts an agent needs to size requests and explain results.

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

Conciseness5/5

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

Three front-loaded sentences, each carrying distinct information (purpose/return, data limitation plus disambiguation, alternative tool plus cost). No repetition of schema content or filler.

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 an 11-parameter search tool with no output schema, the description covers what comes back (mandates and the companies concerned), the key data caveat, and the billing model. Remaining details such as the 400-result cap and per-page limits are fully documented in the schema.

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; the description goes beyond it by explaining that birth month/year (the date_de_naissance_* filters) is the mechanism for telling two homonyms apart, which the schema alone does not motivate.

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

Purpose5/5

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

States a specific verb and resource ('Recherche les dirigeants d'entreprises'), the scope (personnes physiques et sociétés mandataires), and the return shape ('ses mandats et les entreprises concernées'). It is clearly distinguishable from a company-centric lookup without needing the schema.

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

Usage Guidelines5/5

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

Explicitly routes to an alternative: 'Pour une entreprise dont on connaît le nom, préférez fiche_entreprise'. It also gives a disambiguation tactic (use month/year of birth for homonyms) and a cost-conditioned hint on why this lookup is the right one.

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