ag-grid-cli is a STDIO-only CLI tool, not an MCP server. The bundled code shows 9 tools with schemas and descriptions present, but several critical gaps limit quality. Tool names lack consistent verb-noun patterns (e.g., 'detect-version' vs 'set-version' vs 'list-versions'). Descriptions are present but brief (avg ~60 chars, below the 194-char baseline). Parameter descriptions exist but lack detail on constraints, formats, and dependencies. Output schemas are not documented. Error handling is minimal, no recovery guidance or categorization. The tool set is domain-specific (AG Grid documentation) but composition is weak: tools like 'search-docs', 'articles', 'definitions', and 'examples' overlap significantly and could be unified. No tool annotations (readOnlyHint/destructiveHint). Security: 'set-version' is a write operation but lacks dry-run confirmation or permission checks.
List or retrieve AG Grid articles for the detected or configured project version
List or retrieve AG Grid API definitions for the detected or configured project version
Detect AG Grid version and framework from package.json
List or retrieve AG Grid code examples for the detected or configured project version
List AG Grid versions currently exposed by the official search API
Generate a quick start prompt for AG Grid project setup
Search AG Grid docs for the detected or configured project version
Tool names lack consistent verb-noun pattern. 'detect-version', 'set-version', 'list-versions' use hyphens; 'search-docs', 'articles', 'definitions' are inconsistent. LLMs struggle with mixed naming conventions.
Output schemas not documented. Tools return results but LLMs cannot predict field names, types, or structure. Breaks downstream tool chaining and forces exploratory calls.
Overlapping tool responsibilities. 'search-docs', 'articles', 'definitions', 'examples' all retrieve documentation but with different interfaces. Should consolidate into a single 'get_documentation' tool with action/type parameters.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 46 | 2026-07-28+ | v2 |
Persist a manual AG Grid version/framework override for the current project
Generate an upgrade prompt for AG Grid version migration
Parameter descriptions lack constraint details. 'language' enum is ['typescript', 'javascript'] but description does not explain what happens if omitted. 'limit' parameter has no min/max bounds. 'version' parameter format not specified.
No error handling guidance. Tools provide no recovery hints (e.g., 'If version not found, call list-versions first'). No categorization of errors as retryable vs user-fixable.