fr_directors
Directors declared at the French registry (RNE), for one company or a
LIST — sirens=[…] (max 100) returns {entreprises, count, obtenues, en_echec, erreurs, not_found, synthese}, one entry per SIREN in input
order.
⚠️ An empty dirigeants has THREE meanings, told apart by registre:
the SIREN is unknown (error: "not_found"), the legal form is not
registered so it declares nobody (hors_registre — association,
commune: the emptiness says nothing about the company), or the company
is registered with nobody on file (attendu). Never read an empty list
as "no director" without reading registre. personnes_physiques
counts the NAMED natural persons — a company whose only director is
another company scores 0.
⚠️ count counts the records OBTAINED, not the lines returned —
en_echec and erreurs name what is missing, at the top level.
⚠️ An error other than not_found is an upstream failure, not a fact
about the company — and it is RETRYABLE.
A batch of 50 where 21 calls failed returns count: 29, en_echec: 21
and names those 21 SIRENs in erreurs — at the top level, like
not_found, because a hundred-line list is not re-read to find them.
Reading count and not_found alone used to say "50 records, none
missing" while 21 companies silently dropped out of the deliverable.
The batch paces itself and retries the upstream quota (429, honouring
Retry-After), so what reaches you has already been given a second
chance; a SIREN still in erreurs says the upstream is busy, never that
the company has no director. Ask for those SIRENs again, later or in a
smaller batch.
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": "fr_directors"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| _org | No | Org (id) de CET APPEL. `oto_list_orgs()`. | |
| siren | No | SIREN number (9 digits) — single-company mode. | |
| _group | No | Équipe (id) de CET APPEL, sous son org parente. | |
| sirens | No | list of SIREN numbers (max 100) — batch mode. Give one OR the other, not both. | |
| _run_id | No | OBLIGATOIRE à chaque appel dès `run_start` ou `data_claim_next` : sans lui, l'écriture sur une ligne réservée est refusée. Hérité seulement si le serveur tient un run actif — n'y compte pas. | |
| _project | No | Projet (id) de CET APPEL — jeton PRIMAIRE. `oto_project(op='list')`. | |
| _instance | No | Instance de connecteur PRÉCISE (un credential exact). `oto_instance(op='list')`. |