Official ModelContextProtocol (MCP) server for Magic UI.
npx @magicuidesign/cli@latest install <client>- cursor
- windsurf
- claude
- cline
- roo-cline
Add to your IDE's MCP config:
{
"mcpServers": {
"magicuidesign-mcp": {
"command": "npx",
"args": ["-y", "@magicuidesign/mcp@latest"]
}
}
}Once configured, you can questions like:
"Make a marquee of logos"
"Add a blur fade text animation"
"Add a grid background"
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. |
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.
Big thanks to @beaubhp for creating the MCP server 🙏