# ReUI

> ReUI is a freemium MCP server for developer tools. Search ReUI shadcn components, blocks and icons and get exact install commands. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API
- **Website:** https://reui.io/docs/mcp
- **MCP Registry name:** io.github.keenthemes/reui
- **Categories:** developer tools, design and media
- **Listing updated:** 2026-11-15

## About

ReUI's server keeps a coding agent from guessing at component APIs. It queries the live ReUI registry, ranks matches for a natural-language request, returns real props and usage, and hands back the shadcn CLI command to install an item, with did-you-mean suggestions when a name is wrong instead of an invented command.

Beyond lookup it can plan a whole page: compose_page turns a page intent into ordered sections matched to blocks, validate_usage checks planned props against the documented API before any code is written, and get_audit_checklist lists the checks to run after adapting an item. get_thumbnail returns preview images so an agent can compare up to 4 options.

Access needs a ReUI account, free to create during the first OAuth sign-in. A free account covers the 27 ReUI building blocks and the free examples. Premium blocks and Motion Icons that a search can only answer with are flagged as locked, naming the plan that unlocks them, rather than silently dropped. A free account also has a daily request allowance that resets at UTC midnight.

## Features

- **Scored registry search:** Ranked matches across components, examples, blocks and icons, each with an install command.
- **Real component APIs:** Props and usage come from the docs, not memory.
- **Page composition:** Whole-page intents become ordered sections matched to blocks.
- **Usage validation:** Check planned components and props before writing code.
- **Install commands:** Validated shadcn CLI commands, plus project config for license keys.
- **Locked-item reporting:** Premium results are marked locked with the plan that unlocks them.

## Good for

- Build a dashboard page from existing ReUI blocks
- Find a data grid example and copy its working composition
- Pick an icon for many UI concepts in one call
- Audit an adapted block against ReUI-specific checks

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http reui https://mcp.reui.io
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.reui.io
```

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

```json
{
  "mcpServers": {
    "reui": {
      "url": "https://mcp.reui.io"
    }
  }
}
```

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

```json
{
  "servers": {
    "reui": {
      "type": "http",
      "url": "https://mcp.reui.io"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "reui": {
      "serverUrl": "https://mcp.reui.io"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "reui": {
      "type": "http",
      "url": "https://mcp.reui.io"
    }
  }
}
```

## Tools

- `search`: Ranked matches for a natural-language query.
- `search_icons`: Best-matching icons for many concepts in one call.
- `list_components`: List the 27 free ReUI components.
- `list_block_groups`: Top-level block groups with counts.
- `list_block_categories`: Block categories with counts.
- `list_example_categories`: Example categories with counts.
- `list_icon_categories`: Icon categories with counts.
- `get_component`: Props and usage for one or many components.
- `get_examples`: Working example compositions for a component.
- `get_block`: Full metadata for one block.
- `get_example`: Full metadata for one example.
- `get_icon`: Full metadata for one icon.
- `get_thumbnail`: Preview image of a block or example.
- `compose_page`: Turn a page intent into ordered sections matched to blocks.
- `validate_usage`: Check planned components and props against the documented API.
- `get_audit_checklist`: ReUI checks to run after installing.
- `get_install_command`: Exact shadcn CLI command for an item.
- `get_project_context`: components.json registry config and license-key setup.
- `get_agent_skill`: Serve the ReUI build skill to agents.

## FAQ

### Do I need an account?

Yes. Every request carries a credential; OAuth creates a free account on first connection, or use a personal token on headless machines.

### What does the free tier include?

The 27 ReUI components and every c-* example across all tools, with a daily request allowance.

### What do Pro and Ultimate add?

Pro adds premium blocks to search and installs; Ultimate adds Motion Icons.

### What is the endpoint?

https://mcp.reui.io over Streamable HTTP.

### Is ReUI free?

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

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

Run this command in your terminal: claude mcp add --transport http reui https://mcp.reui.io

### What are the best alternatives to ReUI?

The closest alternatives to ReUI 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/reui
