# WunderUI

> WunderUI is a freemium MCP server for design and media. Give coding agents the WunderUI design system: components, props, tokens and rules. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, self-hosted
- **Website:** https://wunderui.com
- **Repository:** https://github.com/kl-webmedia/wunderui-mcp
- **MCP Registry name:** io.github.Kl-webmedia/wunderui-mcp
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-14

## About

WunderUI is a React and Figma design system with 185 components, and this server feeds it to a coding agent so it builds with the real library instead of rebuilding a data grid from raw divs. It runs locally over stdio and needs no key or account for the free parts.

Tools return the component inventory filterable by category or plan, a component's exports, TypeScript prop signature and import line, light and dark tokens as JSON, CSS or Tailwind mappings, and the DESIGN.md rules. Others return page templates, copy-paste starters such as app shell, dashboard and AI chat, and the short always-on rules for CLAUDE.md or AGENTS.md. Resources expose the same data to clients that support them.

Free and Pro tiers apply: on the Free plan an agent should use only components marked free, and Pro skills and block source need a WUNDERUI_LICENSE_KEY.

## Features

- **Component inventory:** Lists components filtered by category, plan or text, with prop signatures.
- **Design tokens:** Light and dark tokens as JSON, CSS or Tailwind mappings.
- **Agent rules:** Returns DESIGN.md sections and always-on rules for CLAUDE.md or AGENTS.md.
- **Templates and starters:** Page templates and copy-paste TSX starters.
- **Skills and block source:** Free and Pro skills and UI block source, with Pro needing a license key.

## Good for

- Have an agent build a dashboard from existing components
- Keep generated UI on theme tokens in light and dark
- Look up a component's props before using it
- Audit a screen for hardcoded colours

## Install

### Claude Code (Terminal)

```sh
claude mcp add wunderui-mcp -- npx -y wunderui-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "wunderui-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "wunderui-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "wunderui-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "wunderui-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "wunderui-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "wunderui-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "wunderui-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "wunderui-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "wunderui-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "wunderui-mcp"
      ]
    }
  }
}
```

## Tools

- `list_components`: The component inventory, filterable by category, plan or text.
- `get_component`: Exports, prop signature, import line, example and docs URL.
- `get_tokens`: Light and dark tokens as JSON, CSS or Tailwind mappings.
- `get_design_md`: The full DESIGN.md or one section.
- `list_templates`: Full-page templates and what each is built from.
- `get_starter`: Copy-paste TSX starters.
- `get_library_info`: Package name, version, install commands and counts.
- `get_instructions`: Short always-on rules for CLAUDE.md or AGENTS.md.
- `list_skills`: The WunderUI agent skills.
- `get_skill`: One skill's instructions.
- `get_block_source`: React source of a UI block; needs a Pro key.

## FAQ

### Do I need a key?

Not for the free parts. Pro skills and block source need WUNDERUI_LICENSE_KEY.

### How do I install it?

Run claude mcp add wunderui -- npx -y wunderui-mcp, or use npx in another client's config.

### Which clients work?

Claude Code, Cursor, Windsurf, Cline, Codex, VS Code and other stdio MCP clients.

### What tiers exist?

Free, Core and Pro; each component is marked with its plan.

### Is WunderUI free?

WunderUI has a free plan, with paid plans for more usage or features.

### How do I add WunderUI to Claude Code?

Run this command in your terminal: claude mcp add wunderui-mcp -- npx -y wunderui-mcp

### What are the best alternatives to WunderUI?

The closest alternatives to WunderUI are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/wunderui
