Audits MCP tool definitions and marketplace listings for LLM-usability traps and platform deploy-limit violations before you ship them
Three well-named, verb-first tools with solid descriptions (100-150 chars each). All tools have input schemas with typed properties and descriptions. Audit logic is sophisticated and demonstrates deep knowledge of LLM-usability patterns. However, output schemas are not explicitly documented in the source, parameter descriptions could be more detailed (e.g., 'tool' param in audit_tool_definition lacks format guidance), and error handling is not visible in the provided code. The server itself is a meta-auditing tool, so it does not expose destructive operations, security and composition concerns are lower priority.
Audit multiple MCP tool definitions at once. Returns per-tool scores and a cross-tool analysis (naming conflicts, case inconsistencies, duplicate names, etc.).
Audit a single MCP tool definition for LLM-usability issues. Returns a detailed report with an LLM-friendliness score (0–100), categorized issues (errors, warnings, info), and specific fixes.
Check a short description (e.g. for an MCP server listing on a marketplace) against platform limits and LLM-usability best practices. Validates length, tone, and clarity.
Output schemas not documented in source code. Callers cannot predict the structure of audit reports, cross-tool analysis, or validation results.
'tool' parameter in audit_tool_definition lacks format/structure guidance. Description says 'The tool definition to audit' but does not specify required fields (name, description, inputSchema) or expected shape.
'tools' array parameter in audit_tool_batch has minimal description. No guidance on expected structure, size limits, or what happens if array is empty.
No visible error handling or recovery guidance in code. If a tool definition is malformed or marketplace description exceeds limits, the response structure and guidance are not shown.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 67 | 2026-07-28+ | v2 |
MCPIZE_SHORT_DESC_LIMIT constant (500 chars) is hardcoded but not exposed as a parameter or documented in check_marketplace_description description.