Two tools with clear, action-oriented names (select, schema) and documented input schemas. Both have tool annotations (readOnlyHint, destructiveHint, idempotentHint). However, parameter descriptions are minimal or missing: 'select' has only query description; 'schema' lacks descriptions for tableName and keyword parameters. Output schemas are not documented, LLMs cannot predict response structure. Error handling returns plain text without recovery guidance. Descriptions are adequate (100 - 150 chars) but lack WHEN/WHY context. No pagination support despite potential for large result sets.
Get database schema information to understand table structure, column details, and relationships between tables
Execute a SELECT SQL query on the MySQL database and return the results. Only SELECT queries are allowed for security reasons.
schema tool missing parameter descriptions. 'tableName' and 'keyword' have no descriptions; LLMs cannot infer when to use each or how they interact.
No output schema documentation. Responses are JSON-stringified text; LLMs cannot predict field names, types, or structure for downstream chaining.
Error responses lack recovery guidance. Errors return plain text (e.g., 'Unknown tool') without suggesting next steps or alternative tools.
No pagination or result limits documented. SELECT queries could return thousands of rows, exhausting context window. No limit parameter or documentation of max results.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 48 | 2025-06-18+ | v2 |
Parameter descriptions lack format/constraint details. 'query' parameter has no guidance on allowed SQL syntax, length limits, or injection prevention.