report_bug
Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| context | No | ||
| message | Yes | ||
| conversation | No | [] |
Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
| Name | Required | Description | Default |
|---|---|---|---|
| context | No | ||
| message | Yes | ||
| conversation | No | [] |
Changes observed during successful MCP inspections. Dates show when Glama detected each change.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations are present (idempotentHint: true, readOnlyHint: false) and the description does not contradict them. The description adds minimal behavioral context beyond annotations; it explains the 'why' for including the conversation array (reproduction) but does not disclose side effects, persistence semantics, or any other traits beyond what annotations imply. Consistency exists, but the added behavioral disclosure is thin.
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?
Two punchy sentences, front-loaded with the core purpose and followed by the single most actionable detail. Zero filler words, no redundancy with schema definitions, and every word contributes to clarity. Exemplary concise documentation.
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 3-parameter tool with no output schema and a fairly obvious feedback-loop behavior, the description covers the essential surface: purposes and the key usage tip for conversation. It could mention what happens after submission (e.g., is an error thrown on failure), but given low complexity and the presence of useful annotations, the documentation is sufficiently complete for an agent to correctly select and invoke this tool.
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%, placing full burden on the description. It partially compensates by explaining that 'conversation' is for reproduction, shedding light on one of three parameters. However, it does not add meaning for 'message' or 'context' parameters, nor clarify the serialized JSON format implied by the default '[]'. Meaningful but incomplete compensation for the coverage gap.
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?
Clear verb+resource construction ('Report a bug, missing feature, or send feedback') with a useful clarification that feedback and feature requests belong here. The second sentence adds practical reproduction guidance. Justification for not a 5: while it distinguishes from siblings like 'show_version' by content area, it never names alternatives or explicitly contrasts with siblings.
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 clearly signals when to use it: bug reporting, missing features, or feedback. The instruction to include the conversation array also guides how to make the report useful. Not a 5 because there are no explicit exclusions (when NOT to use) or named alternatives among the sibling tools, though for a bug-report tool these are less critical.
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.