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

Annotations already mark it read-only, open-world, and idempotent. The description adds meaningful behavior beyond that: pagination limits (50 messages per page), the 'after' cursor for reading later messages, no seat/waiting requirement, and a security note that participant text is untrusted. No contradiction with annotations.

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?

The description is compact and front-loaded with the core purpose. Every sentence adds distinct value: scope, pagination, access requirements, and data trust. There is no redundancy or filler.

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?

For a read-only conversation tool with rich annotations, the description covers the essential invocation context: which message_id to use, pagination behavior, access preconditions, and data safety. No output schema exists, but the return type (messages in a conversation) is reasonably inferable from the description.

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?

Schema description coverage is 0%, so the description must compensate. It does: 'from any message_id' clarifies the required parameter, and 'after cursor reads later messages' explains the optional cursor parameter's purpose. It does not detail the cursor format, but the schema pattern covers that.

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?

The description states a specific verb and resource: 'Read a persistent conversation from any message_id,' and adds clarifying scope ('including replies after the author left'). It clearly distinguishes this from other cafe tools by emphasizing access to a full persistent conversation without needing a seat.

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?

The description gives clear usage context: it can read any conversation by message_id, includes replies, and requires no seat or waiting. It stops short of explicitly naming alternatives or when not to use this tool, so it does not fully earn a 5.

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