A Model Context Protocol (MCP) server for ArchiMate 3.2 enterprise architecture diagrams. Creates Mermaid and ArchiMate XML diagrams with validation against ArchiMate 3.2 specification.
Server has 5 tools with complete input schemas and descriptions. Naming follows verb_noun convention (generate_, validate_, list_, export_). Descriptions are present (avg 120 chars) but lack actionable context for LLM selection. Parameter descriptions exist but are minimal (avg 40 chars). No output schemas documented. Error handling and recovery guidance absent. Missing tool annotations (readOnlyHint, destructiveHint). No pagination support despite list tools. Composition is reasonable, tools are single-purpose, but missing chaining context (e.g., generate_diagram should reference validate_archimate_model).
Export ArchiMate model as standard XML Open Exchange Format (.archimate)
Generate ArchiMate diagrams in Mermaid or Draw.io format from elements and relationships
List all available ArchiMate 3.2 element types with their layers
List all available ArchiMate relationship types
Validate ArchiMate elements and relationships against the ArchiMate 3.2 specification
No output schemas documented. LLMs cannot infer what fields to expect from tool responses, forcing them to guess at downstream field names and types. This breaks tool chaining and wastes tokens on clarification.
Parameter descriptions are minimal (avg 40 chars). E.g., 'Unique identifier for the element' lacks context on format, length, or constraints. LLMs cannot validate inputs without explicit constraints.
No error handling or recovery guidance. Tools do not document what happens on invalid input (e.g., unknown element type, circular relationships). LLMs receive no actionable error messages.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 57 | 2026-07-28+ | v2 |
list_archimate_elements and list_archimate_relationships lack pagination (limit, offset, total_count). No result cap documented. Large result sets will blow context windows.
Missing tool annotations. export_archimate_xml is marked WRITE but has no destructiveHint in schema. generate_archimate_diagram and list_* tools lack readOnlyHint. Agents cannot infer safety/idempotency.