Conselho Federal de Odontologia: Cadastro, consulta em fonte oficial. Hospedado pela plataforma, sem credenciais da plataforma, pague por consulta com crédito pré-pago. Consulta informação de fontes e órgãos oficiais brasileiros (a mesma disponível ao cidadão), não é dado sigiloso. O cliente é o controlador dos dados e responde pela finalidade legítima (LGPD).
| Name | Required | Description | Default |
|---|---|---|---|
| uf | No | ||
| nome | No | ||
| inscricao | No |
Changes observed during successful MCP inspections.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Além das anotações que já indicam readOnlyHint, idempotentHint e destructiveHint falsos, a descrição agrega informações comportamentais relevantes: é pago por consulta, não requer credenciais da plataforma, fornece dados públicos oficiais e impõe responsabilidade LGPD ao cliente. Não contradiz as anotações.
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?
A descrição é compacta, com frase inicial direta sobre a definição principal e frases seguintes agregando valor operacional e legal. Nenhuma frase é redundante ou desnecessária.
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?
Para um tool de consulta simples com 3 parâmetros opcionais, anotações de segurança e sem fluxo complexo, a descrição cobre o essencial: fonte, forma de acesso, pagamento, dados devolvidos, status público e responsabilidade legal. Falta apenas explicar o que retorna e como os parâmetros devem ser combinados, mas não compromete criticamente o contexto geral.
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?
A cobertura de descrição pelo schema é 0% e os parâmetros (uf, nome, inscricao) não têm descrição individual nem na descrição. O texto não explica formatos esperados, combinações obrigatórias ou como os parâmetros relacionam-se à consulta. Como a cobertura é baixa, a descrição deveria compensar, mas não compensa.
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?
A descrição deixa claro que a ferramenta consulta dados cadastrais no Conselho Federal de Odontologia em fonte oficial, com verbo específico ('consulta') e recurso bem delimitado ('Cadastro'). Também diferencia de outras ferramentas utilitárias (authenticate, connect, report_bug, etc.), não havendo ambiguidade sobre sua finalidade.
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?
A descrição orienta claramente sobre o contexto de uso: consulta a fonte oficial, sem credenciais da plataforma, com pagamento pré-pago por consulta. Não há exclusões explícitas nem menção a ferramentas alternativas, mas o contexto de uso é suficientemente claro.
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.