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

As anotações já informam que a operação é somente leitura, idempotente e não destrutiva, e a descrição agrega contexto útil ao revelar o escopo da instalação e o formato do retorno ('id, label'). Não há contradição com as anotações e há transparência suficiente para uma ferramenta simples.

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 é uma frase curta e objetiva, começando pelo verbo de ação e cobrindo o recurso, o escopo e o retorno. Não há ruído, repetição ou informações desnecessárias.

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 uma ferramenta simples e bem anotada, a descrição cobre propósito, escopo e retorno, mas não documenta o parâmetro opcional 'account' nem explica como os IDs retornados devem ser usados nas demais ferramentas tiny_*. Essa é uma lacuna relevante de contexto, embora o uso principal ainda seja compreensível.

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?

O input schema contém apenas 'account' como string opcional, sem descrição, e a cobertura de schema é 0%. A descrição da ferramenta não explica o papel, o formato ou o efeito desse parâmetro, e a menção a CNPJ não é claramente vinculada ao parâmetro. O agente não recebe informação suficiente para decidir como preenchê-lo.

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 usa verbo específico ('Lista'), recurso claro ('empresas (CNPJ) Tiny conectadas a este install') e ainda indica o formato do retorno ('id, label'). Distingue-se bem das ferramentas irmãs tiny_list_* pelo recurso e pelo escopo de instalação.

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?

O contexto de uso é claro: listar as empresas já conectadas à instalação corrente. Não há exclusões explícitas nem comparação com alternativas como authenticate/connect ou demais tiny_list_*, mas o escopo apresentado é suficiente para orientar na maioria dos casos.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.