Skip to content

v0.1.2 — TDQS tool-description rewrite

Latest

Choose a tag to compare

@dmang-dev dmang-dev released this 15 May 22:58
· 12 commits to main since this release

Tool description quality pass — every tool description rewritten to Glama's Tool Definition Quality Score (TDQS) rubric. The goal is to push every tool's score to 4.5+/5 across all six dimensions: Purpose Clarity, Usage Guidelines, Behavioral Transparency, Parameter Semantics, Conciseness, and Contextual Completeness.

What changed

Every tool description follows the same structured template:

PURPOSE: <single action sentence>.
USAGE: <when to use vs sibling tools, with explicit cross-references>.
BEHAVIOR: <side effects, error conditions, destructive notes, what's lost>.
RETURNS: <exact shape of success output>.

Every parameter now has a description that adds context beyond the JSON Schema — alignment requirements, address-space conventions, range justifications, units, interactions with other parameters.

No behavior changes. Wire protocol, tool names, parameter names, response shapes — all identical to the previous release. This is purely a documentation pass for the benefit of MCP clients (Claude, Cursor, etc.) that read tool descriptions to decide when and how to invoke each tool.

See CHANGELOG.md for the per-server specifics.