MCP server for shadcn/ui component references
Four tools with complete input schemas and basic descriptions, but significant gaps in parameter documentation and output schema specification. All tools are read-only discovery/reference tools with no state modification. Naming follows verb_noun convention (list_, get_, search_). However, parameter descriptions are minimal (e.g., 'Name of the shadcn/ui component' lacks format/constraint guidance), and no output schemas are documented. Error handling is present but generic. The server lacks pagination support despite potentially returning large component lists, and no tool annotations (readOnlyHint) are declared despite all tools being safe.
Get detailed information about a specific shadcn/ui component
Get usage examples for a specific shadcn/ui component
Get a list of all available shadcn/ui components
Search for shadcn/ui components by keyword
No output schemas documented. LLMs cannot predict response structure, forcing them to parse unstructured results and plan downstream calls blindly.
Parameter descriptions lack format/constraint guidance. 'Name of the shadcn/ui component' does not specify case sensitivity, valid characters, or how to handle typos. Should include: 'Lowercase component name (e.g., accordion, button, card). Case-sensitive.'
No pagination support. list_shadcn_components may return dozens of components with no limit or offset parameters. Large unstructured lists blow context windows and degrade LLM reasoning.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 55 | 2026-07-28+ | v2 |
No tool annotations. All four tools are read-only and safe to retry, but lack readOnlyHint declarations. Agents cannot distinguish safe tools from destructive ones without explicit hints.
Error handling is generic. Code shows McpError with ErrorCode.MethodNotFound for unknown tools, but no guidance on what to do if a component is not found or if external fetch fails. Should return 'Component "xyz" not found. Available components: [list]' to enable agent self-correction.