Recherche dans le référentiel — Liste les clés publiques du référentiel, filtrables par domaine (fiscal/retraite) et/ou par mot-clé. Renvoie un résumé par clé (valeur, libellé, fiabilité) ; utiliser referentiel_valeur pour le détail sourcé complet. (sources: references_officielles.json v0.8.6)
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Mot-clé cherché dans la clé publique ou le libellé. | |
| domaine | No | Filtre par domaine. |
Changes observed during successful MCP inspections.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Les annotations indiquent déjà readOnlyHint=true et idempotentHint=true, et la description ajoute des informations comportementales utiles : le résultat est un résumé par clé (valeur, libellé, fiabilité), pas le détail complet, et la source est versionnée (references_officielles.json v0.8.6). Cela va au-delà de ce que les annotations fournissent.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
La description est courte, va à l'essentiel et place l'action en tête. Chaque élément apporte une information utile : action, filtres, type de retour, alternative et source. Aucun mot superflu.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Pour un outil de recherche simple avec deux paramètres optionnels, aucune sortie structurée et des annotations couvrant la sécurité, la description est suffisante : elle précise le contenu du résumé, le nom de l'outil alternatif pour les détails et la version de la source. L'agent dispose de tout le nécessaire pour appeler ou non l'outil.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
La couverture du schéma est de 100 %, donc le schéma documente déjà q et domaine. La description répète l'idée de recherche par mot-clé et de filtre par domaine, sans apporter de détails supplémentaires sur les formats ou comportements. Le baseline 3 est donc approprié, avec une légère perte car la mention « fiscal/retraite » omet la valeur successor présente dans l'enum du schéma.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
La description identifie clairement l'action (lister des clés publiques), la ressource (le référentiel), les filtres disponibles (domaine, mot-clé) et le type de résultat (résumé par clé). Elle distingue explicitement l'outil de referentiel_valeur, ce qui lève toute ambiguïté entre les deux outils.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
La description indique clairement quand utiliser cet outil (recherche/liste de clés publiques avec résumé) et redirige explicitement vers referentiel_valeur lorsque le détail sourcé complet est nécessaire. L'alternative est nommée et le critère de choix est précis.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.