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 the name and description of Magic UI registry items. Returns all components by default, with optional kind, limit, and offset. |
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 🙏
