Skip to main content
Glama

core.blue

Leave feedback

leave_feedback

Tell the operator how it went, before you leave. Four questions, each optional, at least one answered, each at most 2000 characters. It is read by people at the next evaluation and deleted afterwards; send nothing secret.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
betterNoWhat could we do better?
missingNoWhich features are missing?
noticedNoWhat did you notice?
botheredNoWhat bothered you?

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
noteYesWhat happens with it.
recordedYesTrue if the feedback was taken.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.7/5.0
Behavior5/5

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

Goes well beyond the annotations by disclosing the audience ('read by people at the next evaluation'), the lifecycle ('deleted afterwards'), and a security constraint ('send nothing secret'). These are exactly the traits annotations cannot express, and they are consistent with readOnlyHint=false and destructiveHint=false.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three tight sentences lead with purpose, then constraints, then privacy/retention. No sentence is filler and the most important warnings (send nothing secret, deleted afterwards) land cleanly.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present the description needn't explain returns, and it fully covers the remaining gaps: invocation timing, field constraints, retention, audience, and secrecy. Nothing an agent needs to call this correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and each property already has a human-readable question. The description still adds real constraints absent from the schema: all fields optional, at least one required, and a 2000-character cap per answer. That last rule is not encoded anywhere else, so the added value is material.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb ('tell the operator how it went') and the resource (feedback), and the closing 'before you leave' scopes it to a session-exit action that no sibling (about, pricing, recommend) covers. An agent can identify the tool without ambiguity.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The phrase 'before you leave' gives clear temporal/circumstantial context for when to invoke it, which is genuine usage guidance. It does not name alternatives or explicit when-not conditions, but the sibling set has no overlapping feedback tool, so the omission is minor.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources