2026-10-11 18:03 UTC

TDQS’s maintainer claims the released scoring specification can quantify MCP tool-definition quality and guide schema improvements, potentially standardizing how agent tool discoverability and selection are assessed.

state: expiredheat: lowuncertainty: highknownscott: mediummcp tool-discovery agent-harnessespunkpeyeTDQSGlama

What is this?

TDQS (Tool Definition Quality Score) is an open-source framework published by Glama and attributed to maintainer punkpeye for evaluating MCP tool definitions across six dimensions: purpose clarity, usage guidelines, behavioral transparency, semantics, conciseness, and completeness. This targets MCP’s model-controlled, dynamically discoverable tools, where definition quality may affect an agent’s ability to select and invoke the right tool. Glama claims the score can guide schema improvements and provide a standardized assessment, but the supplied snippets do not establish independent validation, adoption, or a demonstrated link between TDQS scores and agent task success.

Why it matters to Scott

The radar already tracks this problem on `radar:mcp-server-agent-usability`, with TDQS supplying a specific static scoring proposal rather than establishing a new result. It bears directly on Scott’s MCP connector and could serve as the inspection rung of his Progressive Evaluation Ladder, but its value remains unproven until scores are correlated with retained agent paths, tool-selection accuracy, and task success as required by Reflexive Agent Design.
ip:framework.reflexive-agent-designip:concept.progressive-evaluation-ladderdev:project.mcp-ip-wikiradar:mcp-server-agent-usabilityradar:oqoqo-agent-interface-evalsradar:concept.agent-evaluation
queries asked of Scott's wikis
  • tool schema quality and agent tool selection
  • MCP tool discoverability evaluation
  • agent harness tool-definition linting
  • tool descriptions versus execution success
  • automated schema improvement loops
  • standards for agent-facing tool interfaces

Measured heat

no measured readings yet — the hourly heat pass fills this in

How the heat travelled

no chain yet — the hourly chain pass fills this in

Evidence (1) — ⭐ canonical anchor

sourceobjectauthorscorecomments
🟧 hn ⭐Show HN: MCP Tool Definition Quality Score (TDQS) Specpunkpeye81

Interpretation history

Decision trace