What is the Magic UI MCP server?
The Magic UI MCP server is the official Model Context Protocol server for Magic UI. It lets an AI coding agent list, search and look up registry components, including install instructions and examples, so prompts like add a blur fade text animation produce the right component.
It is the official MCP server for Magic UI, a library of animated interface components. Your AI coding agent can browse the live registry, search it by keyword and fetch install details, all without you leaving the editor.
Example prompts
Once it is configured you can ask for things in plain language. The README gives these examples:
- Make a marquee of logos.
- Add a blur fade text animation.
- Add a grid background.
A small tool surface
Some clients cap how many tools they can call, so the server keeps a short generic list and reads straight from the live registry. Three tools cover listing, searching and fetching a single item with install instructions.
Best for
- Front-end developers adding motion and effects to marketing pages.
- Teams already using shadcn-style components. Compare the shadcn/ui MCP server or MCP UI Components.
Use it with UiChemy
Prototype a landing page with Magic UI components, then bring it to WordPress with UiChemy's AI to WordPress. Get Started at uichemy.com.
Connect Magic UI MCP Server for AI Coding Agents to your AI client
npx @magicuidesign/cli@latest install <client>Run the installer
Replace <client> with cursor, windsurf, claude, cline or roo-cline.
Or configure by hand
Paste the JSON config into your IDE's MCP settings.
Ask for a component
Describe the effect you want and let the agent search the registry.
Client configuration
{
"mcpServers": {
"magicuidesign-mcp": {
"command": "npx",
"args": ["-y", "@magicuidesign/mcp@latest"]
}
}
}What you can do with it
- Official serverMaintained alongside the Magic UI library.
- One-command client setupThe CLI installs the config for Cursor, Windsurf, Claude, Cline and Roo Cline.
- Live registryReads the current Magic UI registry rather than a stale copy.
- SearchableFind components by keyword, kind or description.
- Install guidanceEach item comes with install instructions and examples.
Tools it exposes
listRegistryItems
Lists Magic UI registry items with optional kind, query, limit and offset filters.
searchRegistryItems
Searches items by keyword across names, titles, descriptions and registry types, with pagination.
getRegistryItem
Returns one item with install instructions and optional source, related items and examples.
Frequently asked questions
What is the Magic UI MCP server?
It is the official Model Context Protocol server for Magic UI. It gives an AI coding agent three tools to list registry items, search them by keyword and fetch one item with install instructions, so you can ask for a component in plain language and get the right one.
How do I install the Magic UI MCP server?
Run npx @magicuidesign/cli@latest install followed by your client name: cursor, windsurf, claude, cline or roo-cline. If you prefer manual setup, add a server named magicuidesign-mcp with the command npx and the arguments -y and @magicuidesign/mcp@latest. Setup takes about a minute on most machines.
Which editors does it support?
The installer lists Cursor, Windsurf, Claude, Cline and Roo Cline. Any other MCP-compatible client can still use it through the manual JSON configuration, since the server runs as a standard local npx command. Restart your editor after the installer finishes.
What tools does it provide?
Three: listRegistryItems for browsing, searchRegistryItems for keyword search with pagination, and getRegistryItem for details on a single component including install instructions. The list is kept short because some clients limit how many MCP tools they can call. The server reads from the live registry each time.
What can I ask it to do?
Ask in everyday terms. The README suggests prompts such as make a marquee of logos, add a blur fade text animation, or add a grid background. The agent searches the registry, finds the matching component and follows its install instructions.
Is the Magic UI MCP server free?
The server is open source under the MIT licence and runs locally with npx. Check the Magic UI site for the terms of the components themselves, since the licence in this repository covers the server code. Ask for the effect by name for the best match.
Does it work with Claude Code?
Yes. Use the claude option in the installer, or add the same npx command to Claude's MCP configuration by hand. Any MCP-compatible AI coding agent can run it because it follows the standard protocol. Compare it with a design system synthesizer for token work.


