Skip to main content
Glama

checkers.fr — entreprises françaises

Rechercher des annonces BODACC

rechercher_annonces_bodacc
Read-onlyIdempotent

Recherche les annonces du BODACC (Bulletin officiel des annonces civiles et commerciales) : créations, immatriculations, modifications, ventes et cessions de fonds, radiations, dépôts de comptes, procédures collectives (sauvegarde, redressement, liquidation). Filtrez par type, période, entreprise (siren), territoire ou activité : « les liquidations judiciaires publiées ce mois-ci dans la restauration en Gironde », « les ventes de fonds de commerce à Lyon depuis janvier ». Coût : 0,1 crédit par annonce 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_annonces_bodacc"
  }
}

Input Schema

NameRequiredDescriptionDefault
qNoMots à chercher dans le texte de l’annonce.
pageNoPage de résultats (1 par défaut). Les 400 premiers résultats au plus sont accessibles.
sirenNoSIREN de l’entreprise, 9 chiffres.
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.
code_postalNoCodes postaux du siège, séparés par des virgules. Pour une ville, donnez tous ses codes postaux (Lyon : 69001 à 69009) ou, pour une grande zone, le département.
departementNoDépartements du siège, séparés par des virgules : « 75,92,2A,974 ».
type_publicationNoTypes d’annonce, séparés par des virgules : Création, Immatriculation, Modification, Vente, Radiation, Procédure collective, Dépôt des comptes.
categorie_juridiqueNoCodes INSEE de forme juridique, séparés par des virgules (préfixe accepté) : « 5710 » SAS, « 5499 » SARL, « 55 » toutes les SA, « 6540 » SCI, « 1 » entrepreneurs individuels.
date_publication_maxNoPubliée au plus tard à cette date au format JJ-MM-AAAA ou AAAA-MM-JJ.
date_publication_minNoPubliée à partir de cette date au format JJ-MM-AAAA ou AAAA-MM-JJ.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.1/5.0
Behavior3/5

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

Annotations already declare readOnlyHint, idempotentHint, destructiveHint=false and openWorldHint=false, so the safety profile is fully covered by structured data. The description's genuinely additive element is the pricing model (0,1 crédit par annonce renvoyée, rien si aucun résultat), which the agent needs to size per_page responsibly. Beyond cost, it adds little: result format, sort order and the 400-result access ceiling are left to the schema.

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?

Front-loaded with the resource and covered publication types, then examples, then cost — a sensible information order with no filler. The type enumeration partly duplicates the type_publication enum values and the costing note partly reflects the per_page description, so a small amount of redundancy remains.

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

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For an 11-parameter, all-optional search tool with full schema descriptions and no output schema, the description gives enough to call it correctly: what is searchable, how filters combine, and what it costs. Missing only minor operational context already handled by the schema, such as the 400-result access limit and default page size.

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 baseline is 3; the description earns an extra point by mapping natural-language requests onto concrete filter combinations (« les liquidations judiciaires publiées ce mois-ci dans la restauration en Gironde » → type_publication + date_publication_min + code_naf + departement). It still adds no per-parameter syntax detail beyond what the schema already documents.

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 (Recherche) and resource (annonces du BODACC) and immediately enumerates the covered publication types — créations, immatriculations, ventes et cessions de fonds, radiations, dépôts de comptes, procédures collectives — so the agent knows exactly what corpus is searched. The sibling names (dirigeants, documents, entreprises, comptes_annuels) read as clearly different resources, so confusion risk is low even without explicit naming.

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

Usage Guidelines4/5

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

Usage is conveyed through two concrete natural-language query examples that show how filters combine (type + période + territoire + activité), which tells the agent when this tool is the right pick. It does not name an alternative tool or state any exclusion, so there is no explicit when-not guidance.

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