MCP server for Waiframe.ai — connect AI coding tools to your wireframe designs
The server defines 9 tools with clear naming conventions (all start with action verbs: list_, get_). Descriptions are present and reasonably detailed (averaging ~60 chars, within acceptable range). Input schemas are visible and properly typed. However, there are significant gaps: most parameter descriptions lack detail about formats, constraints, and expected values; output schemas are not documented in the visible code; error handling is minimal; no tool annotations (readOnlyHint) despite all being READ_ONLY. The tools follow a coherent pattern (projects → screens/flows/context → blueprint generation), but lack the LLM-optimization details needed for A-grade quality.
Get the component specification and guidelines for a specific component type
Get detailed information about a specific flow including its screens and navigation structure
Get detailed information about a specific project including screens, flows, and context
Analyze a wireframe project and generate a complete application blueprint — tech stack, packages, project structure, routes, and setup commands for scaffolding a real application from wireframes
Get the project context with design guidelines, brand information, and user personas
Get detailed information about a specific screen including its elements and connections
List all flows in a project
No output schemas documented. LLMs cannot infer what fields to expect from tool responses, forcing them to guess at the structure and plan downstream calls blindly.
Parameters lack constraint documentation. 'projectId' description says 'The project UUID (use list_projects to find it)' but does not specify format, length, or validation rules. LLMs need explicit format hints to avoid invalid values.
No tool annotations present despite all 9 tools being READ_ONLY. The spec supports readOnlyHint and destructiveHint annotations, these enable agents to reason about safety and idempotence without extra work.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | D | 51 | 2026-07-28+ | v2 |
| 2026-03-09 | F | 45 | - | v1 |
List all projects in your Waiframe workspace
List all screens in a project
Error handling strategy not visible in code. No error classification (retryable vs fatal), no recovery guidance, no invalid value echoing. Agents calling these tools have no way to recover from failures.
Descriptions for list tools do not mention pagination. If these APIs return large result sets, the tools should accept limit/offset and return total counts. No pagination constraints visible in schema or description.
'componentType' parameter in get_component_spec lacks enum definition. Description suggests values like 'button-primary', 'text-input' but does not provide a complete list. LLMs may hallucinate invalid component type names.