MCP server: convert between INI files and JSON. Section + bare-key support.
Two simple tools with basic schemas and minimal descriptions. Both tools have input schemas with proper types, but descriptions are terse (under 100 chars) and lack context on when/why to use them. No parameter descriptions provided, LLMs cannot infer what 'text' or 'value' mean without additional guidance. No output schema documented. Error handling is present but generic ('ini failed: ...'). Tools are read-only and low-risk, but definition quality falls short of production standards.
Serialize a JSON object back to INI. Top-level must be an object.
Parse INI text into a JSON object. Sections become nested objects.
Parameter descriptions missing. 'text' and 'value' parameters lack descriptions explaining what they accept, format, or constraints. LLMs cannot infer parameter semantics from names alone.
Output schema not documented. Tool descriptions do not specify what fields the response contains or their types. Agents cannot plan downstream operations without knowing the output structure.
Tool descriptions are terse (under 100 chars) and lack context. No explanation of when to use to_json vs to_ini, what INI format is assumed, or edge cases (e.g., duplicate keys, special characters).
Error messages are generic. 'ini failed: ...' does not guide the LLM on recovery. Should specify what constraint was violated (e.g., 'Invalid INI syntax at line 5: missing value for key') and suggest next steps.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 51 | 2026-07-28+ | v2 |
No input validation hints. to_ini accepts 'value: object' but does not document what nested structures are valid, whether arrays are allowed, or size limits. Validation happens at runtime with a generic error.