@magicuidesign/mcp

Official ModelContextProtocol (MCP) server for Magic UI.

Install MCP configuration

npx @magicuidesign/cli@latest install <client>

Supported Clients

• [x] cursor
• [x] windsurf
• [x] claude
• [x] cline
• [x] 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 | |-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | getUIComponents | Provides a comprehensive list of all Magic UI components. | | getLayout | Provides implementation details for bento-grid, dock, file-tree, grid-pattern, interactive-grid-pattern, dot-pattern components. | | getMedia | Provides implementation details for hero-video-dialog, terminal, marquee, script-copy-btn, code-comparison components. | | getMotion | Provides implementation details for blur-fade, scroll-progress, scroll-based-velocity, orbiting-circles, animated-circular-progress-bar components. | | getTextReveal | Provides implementation details for text-animate, line-shadow-text, aurora-text, animated-shiny-text, animated-gradient-text, text-reveal, typing-animation, box-reveal, number-ticker components. | | getTextEffects | Provides implementation details for word-rotate, flip-text, hyper-text, morphing-text, spinning-text, sparkles-text components. | | getButtons | Provides implementation details for rainbow-button, shimmer-button, shiny-button, interactive-hover-button, animated-subscribe-button, pulsating-button, ripple-button components. | | getEffects | Provides implementation details for animated-beam, border-beam, shine-border, magic-card, meteors, neon-gradient-card, confetti, particles, cool-mode, scratch-to-reveal components. | | getWidgets | Provides implementation details for animated-list, tweet-card, client-tweet-card, lens, pointer, avatar-circles, icon-cloud, globe components. | | getBackgrounds | Provides implementation details for warp-background, flickering-grid, animated-grid-pattern, retro-grid, ripple components. | | getDevices | Provides implementation details for safari, iphone-15-pro, android components. |

MCP Limitations

Some clients have a limit on the number of tools they can call. This is why we opted to group the tools into categories. Note: For more specific context on each component, run the MCP locally and modify the logic that groups the components.

Credits

Big thanks to @beaubhp for creating the MCP server 🙏

MIT