# UICapsule

> UICapsule is an open-source MCP server for developer tools. Search and install animated React components from UICapsule's shadcn registry. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Web, API, CLI
- **Website:** https://www.uicapsule.com
- **Repository:** https://github.com/kyh/uicapsule
- **MCP Registry name:** com.uicapsule/components
- **Categories:** developer tools, design and media
- **Listing updated:** 2026-11-16

## About

UICapsule is a gallery of working React components chosen for unusual motion: a dynamic island, a volume dial, an ASCII renderer, a card stack, a scrubbable terminal. The gallery is run by Kaiyu Hsu, and everything in it is MIT licensed.

The MCP endpoint at /mcp exposes two tools, search_components and get_component, so an agent can look up a component by what it does and then pull its source. Each component is a shadcn registry item, so the shadcn CLI can write its files and npm dependencies straight into a project.

The site says it is not a general UI kit, CSS framework or hosted service, and it needs no account or API key. It also serves Markdown versions of pages, an llms.txt catalog and filters by element and style.

## Features

- **Component search:** search_components finds components by what they do.
- **Source retrieval:** get_component returns a component's source, dependencies and install targets.
- **shadcn CLI install:** Items install with npx shadcn add against a registry URL.
- **Dependency visibility:** Each registry item lists its npm dependencies and files before you adopt it.
- **Agent-readable site:** Pages return Markdown on request and llms.txt lists the full catalog.
- **MIT licensed:** Components are free for personal and commercial use without attribution.

## Good for

- Find a specific interaction such as a dial or card stack for a UI
- Drop an animated component into a project through the shadcn CLI
- Survey interaction-design prior art by element and style
- Check a component's dependencies before installing

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http components https://www.uicapsule.com/mcp
```

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

```sh
https://www.uicapsule.com/mcp
```

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

```json
{
  "mcpServers": {
    "components": {
      "url": "https://www.uicapsule.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "components": {
      "type": "http",
      "url": "https://www.uicapsule.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "components": {
      "serverUrl": "https://www.uicapsule.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "components": {
      "type": "http",
      "url": "https://www.uicapsule.com/mcp"
    }
  }
}
```

## Tools

- `search_components`: Searches the component catalog by what components do.
- `get_component`: Returns one component with its source and dependencies.

## FAQ

### Does it need an API key?

No. The site says nothing requires an API key, account or rate-limited token.

### What licence do components use?

MIT, for personal and commercial work with no attribution required.

### How do I add the server?

Run claude mcp add --transport http uicapsule https://www.uicapsule.com/mcp; any Streamable HTTP client works.

### Is it a full component library?

No. It is a curated set of single components with unusual motion, not a design system.

### Is UICapsule free?

Yes. UICapsule is open source, so you can use and self-host it for free.

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

Run this command in your terminal: claude mcp add --transport http components https://www.uicapsule.com/mcp

### What are the best alternatives to UICapsule?

The closest alternatives to UICapsule 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/uicapsule
