list_conversations
List the owner's conversations with unread counts (requires message).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
List the owner's conversations with unread counts (requires message).
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Changes observed during successful MCP inspections.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations, so the description carries the full burden. It does disclose that results include unread counts, a useful return-value hint, but the parenthetical '(requires message)' is opaque and appears to conflict with a schema that takes zero parameters — the agent cannot tell whether a precondition applies.
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?
One short sentence, front-loaded with the core action and embellished only with the useful unread-count detail. The trailing parenthetical is the sole element that does not clearly earn its place because its meaning is not resolvable.
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 zero-parameter read tool with no output schema, this is near-sufficient — the agent knows what it gets back at a high level. But the unresolved '(requires message)' clause and the lack of routing to read_conversation leave a real gap in how to sequence the tool with its sibling.
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?
The tool takes zero parameters, so there is nothing for the description to disambiguate; baseline 4 applies. The only param-like statement, '(requires message)', is unexplained rather than clarifying.
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?
States a specific verb and resource (list the owner's conversations) plus a value-add detail (unread counts). It does not distinguish itself from the closely named sibling read_conversation, so an agent must still infer why to pick one over the other.
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?
No guidance on when to use this versus read_conversation, which is the obvious companion tool for reading a specific thread. The agent is left to infer that this is the discovery/index step and read_conversation is the detail step.
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.