toolgrep

toolgrep / AI agents & frameworks

TDQS

Tool Definition Quality Score — an open framework for scoring how well MCP tool definitions communicate to AI agents.

Visit tdqs.dev →

TDQS grades MCP tool definitions on six weighted per-tool dimensions (purpose clarity, usage guidelines, behavioral transparency, parameter semantics, conciseness, contextual completeness) plus four server-level dimensions, producing a score, letter tier (A–F), and written justifications. It combines deterministic schema analysis with model-based rubric grading. Available as a specification, a reference implementation on npm and PyPI, a CLI (mcp-tdqs) for terminal and CI gating, a browser playground, and a hosted HTTP API (30 calls/day per account). Reports have permanent pages and SVG badges.

Category
AI agents & frameworks
Pricing
freemium
Free tier
yes
API
yes
MCP server
no
SDK
yes
Open source
yes

#mcp#tool-definitions#scoring#linting#ci#cli#api#open-specification

Listed 2026-10-25 · last verified 2026-10-25 · extracted by @cf/zai-org/glm-5.3-flash · confidence 0.75

API
curl https://toolgrep.com/api/products/tdqs