An MCP server that generates AWS architecture diagrams from specifications and parses natural language descriptions into structured AWS architecture diagram specifications.
Two tools with basic schemas but significant quality gaps. generate_aws_diagram has a complete input schema with types and descriptions, but parse_natural_language lacks parameter descriptions entirely. Both tool descriptions are present but generic (under 100 chars). No output schemas documented. Error handling returns generic error dicts without recovery guidance. No parameter validation constraints (enums, ranges). Tool names lack action verbs (should be 'create_aws_diagram' not 'generate_aws_diagram'). No idempotency hints or destructive operation warnings despite generate_aws_diagram performing file I/O.
Generate an AWS architecture diagram from a specification.
Parse a natural language description into a structured AWS architecture diagram specification.
parse_natural_language has no parameter descriptions. The 'description' parameter lacks any guidance on expected format, length, or content. LLMs cannot infer what constitutes a valid input.
No output schemas documented for either tool. Callers cannot know what fields to expect in responses. generate_aws_diagram returns {status, message, diagram_url, filename} but this is inferred, not declared. parse_natural_language returns {title, services, connections} or {status, message} on error, inconsistent and undocumented.
Error responses lack recovery guidance. Both tools return {'status': 'error', 'message': '...'} with no hint about what the LLM should do next (retry, ask user, call a different tool).
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 49 | 2026-07-28+ | v2 |
format_type parameter in generate_aws_diagram lacks enum constraint. Accepts 'png, jpg, svg, pdf' but no validation. LLMs may hallucinate 'webp' or 'tiff'. Should declare enum: ['png', 'jpg', 'svg', 'pdf'].
Tool names lack action verbs. 'generate_aws_diagram' is vague (generate could mean create, fetch, or render). 'parse_natural_language' is generic. Should be 'create_aws_diagram' and 'parse_architecture_description' for clarity.