Magic UI MCP server
Commit Nov 4, 2026Allows AI editors to search, browse, and install Magic UI components directly into your project.
Also known as magicuidesign/mcp
- Stars
- 224
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 4, 2026
- License
- MIT
What is Magic UI MCP?
Magic UI allows AI editors to search, browse, and install Magic UI components directly into your project.
Summary generated from the project's README
About Magic UI MCP server
Integrating Magic UI components into your frontend projects is what this server enables for developers using AI-powered editors. By connecting to the live Magic UI registry, it allows tools like Cursor, Windsurf, Claude, Cline, and Roo-Cline to find and implement specific UI elements directly within your codebase.
You can set it up using the npx command or by manually adding the configuration to your IDE settings. The server provides three specific tools: listRegistryItems for browsing the registry with filters like kind or offset, searchRegistryItems for keyword searches across titles and descriptions, and getRegistryItem to retrieve detailed installation instructions and source code for a single component.
Because it reads directly from the live registry instead of using hardcoded categories, the server maintains a small tool surface that works well even with clients that have tool call limits. It focuses on direct registry access rather than broad semantic categories like widgets or media.
What you can do with it
- 1Browse available UI componentsAsk your AI editor to show you a list of available Magic UI items using filters.
- 2Search for specific animationsFind a particular component by searching for keywords in its name or description.
- 3Implement visual effectsInstruct the AI to add specific visual elements like a marquee or a grid background to your project.
- 4Retrieve installation detailsGet the exact instructions and source code needed to install a single registry item.
Written from the project's README. Every use case is checked against a quote from it.
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 reachablemagicuidesign/mcp is public and reachablegithub.com/magicuidesign/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-04github.com/magicuidesign/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 model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub@magicuidesign/mcp
Official ModelContextProtocol (MCP) server for Magic UI.
Install MCP configuration
npx @magicuidesign/cli@latest install <client>
Supported Clients
- cursor
- windsurf
- claude
- cline
- roo-cline
Manual Installation
Add to your IDE's MCP config:
{
"mcpServers": {
"magicuidesign-mcp": {
"command": "npx",
"args": ["-y", "@magicuidesign/mcp@latest"]
}
}
}
Example Usage
Once configured, you can questions like:
"Make a marquee of logos"
"Add a blur fade text animation"
"Add a grid background"
Available Tools
The server provides the following tools callable via MCP:
| Tool Name | Description |
|---|---|
listRegistryItems |
Lists Magic UI registry items with optional filters like kind, query, limit, and offset. Recommended for registry browsing. |
searchRegistryItems |
Searches Magic UI registry items by keyword across names, titles, descriptions, and registry types, with pagination support. |
getRegistryItem |
Returns details for a single registry item, including install instructions and optional source, related items, and examples. |
MCP Limitations
Some clients have a limit on the number of tools they can call. The server keeps a small generic tool surface and reads directly from the live Magic UI registry, rather than relying on hardcoded category buckets. Broad semantic discovery concepts such as widgets, media, or devices are not currently modeled as first-class categories in the MCP API.
Credits
Big thanks to @beaubhp for creating the MCP server 🙏
Magic UI MCP questions
Which AI clients are supported?
The server supports Cursor, Windsurf, Claude, Cline, and Roo-Cline.
How can I install the MCP configuration?
You can install the configuration using the command: npx @magicuidesign/cli@latest install <client>