ui-layouts MCP server
Commit Nov 15, 2026Enables AI assistants to search, retrieve documentation, and fetch TypeScript/React source code for UI components from ui-layouts.com.
Also known as ui-layouts/mcp
- Stars
- 34
- Tools
- 4
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 15, 2026
- License
- MIT
What is ui-layouts MCP?
ui-layouts enables AI assistants to search, retrieve documentation, and fetch TypeScript/React source code for UI components from ui-layouts.com. It exposes 4 tools, such as key, href, maxChars.
Summary generated from the project's README
About ui-layouts MCP server
Finding and integrating UI components from ui-layouts.com is what this server enables for developers using AI assistants like Claude Desktop or Cursor. It provides a structured pipeline to move from a vague design requirement to a fully implemented React component. By connecting to the component registry, the server allows an AI to search for specific elements, read their technical documentation, and examine the underlying TypeScript source code.
Users can set up the server locally using npx without needing a global installation. The system works through a series of specialized tools including search_components for discovery, get_docs for retrieving MDX markdown documentation, and get_source_code for fetching the actual .tsx implementation files. It also includes get_component_meta to pull structured HTML metadata such as descriptions and keywords. This setup is ideal for developers who want to automate the process of exploring, understanding, and implementing high-quality UI layouts directly within their coding environment.
What you can do with it
- 1Discovering specific UI elementsSearch the component registry using tags or names to find matching design patterns.
- 2Automating component implementationUse specialized prompts to generate step-by-step guides for integrating components into specific frameworks.
Written from the project's README. Every use case is checked against a quote from it.
ui-layouts MCP tools 4
Detected from the READMEkeyhrefmaxCharstimeoutMs
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableui-layouts/mcp is public and reachablegithub.com/ui-layouts/mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-05github.com/ui-layouts/mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model4 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub@ui-layouts/mcp
@ui-layouts/mcp provides AI assistants with several valuable tools to help them search, understand, and retrieve UI components from ui-layouts.com.
Each tool can be used independently, but they are designed to work together as a complete "component exploration pipeline."
📦 Installation & MCP Setup
Requirements
- Node.js: >=20.10.0
- MCP Client: Claude Desktop, Cursor, or compatible MCP client
Quick Start
Run @ui-layouts/mcp without installing it globally using npx. This is the recommended way to get started:
{
"mcpServers": {
"ui-layouts-mcp": {
"type": "stdio",
"command": "npx",
"args": ["@ui-layouts/mcp"]
}
}
}
💡 Note:
npxwill automatically download and run the latest version of@ui-layouts/mcpwhen needed. No global installation required!
Using with Claude Code (CLI)
claude mcp add ui-layouts-mcp --scope user -- npx -y @ui-layouts/mcp
This registers the MCP server under the CLI-safe name ui-layouts-mcp while still using the @ui-layouts/mcp npm package.
🛠️ Tools
🔍 search_components
Search through the ui-layouts.com component registry by component name, key, group, tags, or href. It performs intelligent matching to find components that meet your criteria and returns detailed information about each match.
When it's useful
- To find a specific UI component by name or tag
- To explore available components by category
- To discover components with particular design or functional features
📘 get_docs
Fetch the complete documentation for a component as raw MDX markdown, read from the ui-layouts source repo on GitHub.
Installation commands, props tables, and structure snippets come through as-is. Example previews appear as tags such as <ComponentCodePreview name="..." />. Pass that name to get_source_code to get the example code.
Parameters
key— component key (e.g.accordion)href— component href (e.g./components/accordion), used whenkeyis omittedmaxChars— max characters of markdown to return (default20000)timeoutMs— fetch timeout in milliseconds (default7000)
When it's useful
- To read implementation guides and examples
- To view a component’s structure, props, or variants
- To extract technical explanations for AI-assisted reasoning or integration
🧩 get_component_meta
Fetch structured HTML metadata for a specific component from ui-layouts.com.
It includes fields such as title, description, keywords, Open Graph, Twitter card,
and even custom metadata like component-names and available-components.
When it's useful
- To understand a component’s intent or SEO context
- To generate previews or summaries automatically
- To retrieve linked
componentNamesfor source code lookup
💾 get_source_code
Fetch the actual TypeScript/React source code of a component directly from
https://www.ui-layouts.com/r/{component}.json.
The tool reads the files[].content field from the JSON registry and returns the .tsx implementation.
When it's useful
- To review or analyze the source code of a component
- To use the component implementation as a code example
- To verify that a component matches your design or API expectations
💬 Prompts
The MCP server also provides reusable prompt templates that guide AI assistants to perform complex tasks using the available tools.
🎯 find_component
Help find the best ui-layouts component(s) for specific requirements, use cases, or design needs.
Parameters:
requirements: What you need (e.g. 'collapsible content sections with smooth animation')tags(optional): Comma-separated tags to filter by (e.g. 'interactive,layout')maxCandidates(optional): Max candidates to fetch docs for (default: '3', range: 1-10)
What it does:
- Generates multiple search queries with synonyms
- Calls
search_componentsmultiple times and merges results - Fetches documentation for top candidates using
get_docs - Provides structured recommendations with:
- Recommended: name/key/href/tags, why, trade-offs
- Alternatives: 1-3 alternative options
- Next steps: Exact tool calls to continue
Strategy:
- Uses intelligent search with synonyms (e.g. accordion/collapse/disclosure)
- Prioritizes components matching provided tags
- Ranks by relevance and compares multiple candidates
🛠️ implement_component
Get a step-by-step implementation guide for a ui-layouts component, including code examples, integration steps, and best practices.
Parameters:
componentKey(optional): Component key (e.g. 'accordion', 'sparkles-title')componentHref(optional): Component href (e.g. '/components/accordion')- One of
componentKeyorcomponentHrefis required. framework(optional): Target framework (e.g. 'react', 'next', 'vite', 'general', default: 'react')includeSourceCode(optional): Whether to include source code ('true' or 'false', default: 'true')
What it does:
- Fetches component documentation and optionally source code
- Generates a comprehensive implementation guide with:
- Overview: Component purpose, features, and when to use
- Installation: Dependencies and setup for the target framework
- Basic Usage: Minimal working example with explanations
- Configuration: Available props and customization options
- Advanced Examples: Real-world use cases with code
- Integration: Framework-specific setup and patterns
- Styling & Customization: Theming and appearance customization
- Best Practices: Performance tips, accessibility, common pitfalls
- Troubleshooting: Common issues and solutions
Output:
- Practical, copy-paste ready code examples
- Framework-specific integration guidance
- Real code from source when available
🔗 Recommended Workflow
💡 Tip: Combine these tools for a full exploration experience:
search_components → get_docs → get_component_meta → get_source_code
| Step | Description | Example |
|---|---|---|
| ① | Find components matching a keyword or tag | search_components { "q": "accordion" } |
| ② | Fetch their documentation (MDX) | get_docs { "key": "accordion" } |
| ③ | Retrieve metadata & component links | get_component_meta { "key": "accordion" } |
| ④ | Get TSX source code from registry | get_source_code { "componentName": "single-layout-accordion" } |
⚙️ Server Info
- MCP server name (alias):
ui-layouts-mcp - npm package:
@ui-layouts/mcp - Transport:
stdio - Base URL: https://www.ui-layouts.com
🧠 Example Usage in Cursor / Claude
> call tool search_components { "q": "slider" }
> call tool get_docs { "key": "align-slider" }
> call tool get_component_meta { "key": "align-slider" }
> call tool get_source_code { "componentName": "align-slider" }
👤 Author (Naymur & Jinho)
- X: @naymur_dev
- LinkedIn: in/naymur-rahman
- LinkedIn: in/jinho-yeom
Be A Sponsor
ui-layouts MCP questions
What tools does ui-layouts MCP provide?
It exposes 4 tools, including key, href, maxChars, timeoutMs.
How do I install the ui-layouts MCP server?
The recommended way is to run it using npx without a global installation via your MCP client configuration.
What tools are available in this server?
The server provides tools to search components, fetch MDX documentation, retrieve HTML metadata, and get actual TypeScript/React source code.