Skip to main content
Glama

sanhao-global-experts

annual-review-writer

A production-ready annual review writer system for marketing and operations leaders. Get a structured, repeatable workflow you can run today - delivered as a copy-paste prompt pack with examples.

Input Schema

NameRequiredDescriptionDefault
queryNoOptional user query to scope the analysis.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

C2.3/5.0
Behavior2/5

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

No annotations are supplied, so the description carries the full disclosure burden, and it says almost nothing about behavior: no indication of whether a model is invoked, what the response contains beyond "prompt pack with examples", or how the optional query affects output. The only behavioral hint is the delivery format (copy-paste prompt pack), which is something, but not enough for a mutation-shaped or generation tool with zero annotation coverage.

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

Conciseness3/5

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

Only two sentences, so length is fine, but both are marketing framing ("you can run today", "production-ready") that displaces the concrete information an agent needs. It is front-loaded on the pitch rather than the capability.

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

Completeness2/5

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

For a single-optional-param, no-output-schema tool the description should at minimum say what a call returns and how the result should be used; neither is present. Combined with no annotations, an agent has no way to predict the outcome of invoking it.

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

Parameters3/5

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

There is a single optional parameter and schema description coverage is 100%, so the schema already documents `query`. The description adds no scoping or syntax meaning beyond it, but per the high-coverage baseline a 3 is the appropriate ceiling.

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

Purpose2/5

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

The text reads as product-marketplace copy ("production-ready", "delivered as a copy-paste prompt pack") rather than a statement of what invoking the tool does. It restates the name (annual review writer) and adds an audience, but never says whether it drafts a review, generates a template, or returns instructions. Siblings such as perf-write-tool and year-end-report-coach are not acknowledged, so an agent cannot use the description to disambiguate.

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

Usage Guidelines2/5

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

It names a target audience (marketing and operations leaders) but gives no trigger conditions, no prerequisites, and no exclusions. With hundreds of near-neighbour siblings (perf-*, year-end-report-coach, report-writer-pro) the absence of any routing guidance is a real gap.

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.