# Unicon

> Shadcn for icons.

- **Type:** MCP server
- **Install:** `agentstack add mcp-webrenew-unicon`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [webrenew](https://agentstack.voostack.com/s/webrenew)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [webrenew](https://github.com/webrenew)
- **Source:** https://github.com/webrenew/unicon
- **Website:** https://unicon.sh

## Install

```sh
agentstack add mcp-webrenew-unicon
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Unicon

**Just the icons you need. Zero bloat.**

Browse 20,000+ icons and copy exactly what you need. Like [shadcn/ui](https://ui.shadcn.com), but for icons.

[**Try it now at unicon.sh**](https://unicon.sh)

[](https://github.com/WebRenew/unicon/actions/workflows/ci.yml)
[](https://www.npmjs.com/package/@webrenew/unicon)
[](https://opensource.org/licenses/MIT)

## Why Unicon?

Most icon libraries force you to install thousands of icons just to use a handful. Unicon lets you browse everything in one place and copy only what you need.

- **Browse once, use anywhere** — Search 9 icon libraries
- **Copy exactly what you need** — React, SVG, or JSON
- **Bundle multiple icons** — Export a set at once
- **Zero dependencies** — Paste directly into your project

## Icon Libraries

| Library | Icons | Style |
|---------|-------|-------|
| [Lucide](https://lucide.dev) | 1,500+ | Minimal, consistent stroke |
| [Phosphor](https://phosphoricons.com) | 1,300+ | 6 weights per icon |
| [Huge Icons](https://hugeicons.com) | 4,000+ | Modern, versatile |
| [Heroicons](https://heroicons.com) | 300+ | By Tailwind CSS team |
| [Tabler](https://tabler.io/icons) | 5,000+ | Clean, customizable |
| [Feather](https://feathericons.com) | 280+ | Simple, elegant |
| [Remix Icon](https://remixicon.com) | 2,800+ | Outlined & filled |
| [Simple Icons](https://simpleicons.org) | 3,300+ | Brand logos |
| [Iconoir](https://iconoir.com) | 1,600+ | Regular & solid |

### Coming Soon

| Library | Icons | License | Focus |
|---------|-------|---------|-------|
| [Carbon](https://carbondesignsystem.com/elements/icons/library/) | 2,000+ | Apache-2.0 | IBM's enterprise design system |
| [Blueprint](https://blueprintjs.com/docs/#icons) | 300+ | Apache-2.0 | Palantir's data-focused icons |
| [Devicons](https://devicon.dev) | 200+ | MIT | Programming languages & dev tools |
| [Octicons](https://primer.style/foundations/icons) | 600+ | MIT | GitHub's icon set |
| [Cryptocurrency Icons](https://github.com/spothq/cryptocurrency-icons) | 400+ | CC0 | Coins and tokens |

## How to Use

### 1. Search for icons

Use natural language — search "happy face" to find smile icons, or "business" for briefcases and charts.

### 2. Copy what you need

Click any icon and choose your format:

**React Component** — Drop directly into your project:
```jsx
export const ArrowRight = (props) => (
  
    
  
)
```

**Raw SVG** — For HTML, design tools, or anywhere else:
```html

  

```

### 3. Bundle multiple icons

Select multiple icons and export as:
- Single file with all React components
- Individual SVG files
- JSON metadata

### 4. Open in v0

Send icons to [v0.dev](https://v0.dev) to prototype UI components.

## CLI

Install icons directly from your terminal.

### Installation

```bash
npm install -g @webrenew/unicon

# Or use npx (no install)
npx @webrenew/unicon search arrow
```

### Quick Start

```bash
# Search for icons
unicon search "dashboard"

# Get icon as React component
unicon get home

# Copy to clipboard (macOS)
unicon get home | pbcopy

# Save to file
unicon get settings -o ./Settings.tsx

# Bundle icons by category
unicon bundle --category Dashboards

# Preview in terminal
unicon preview star
```

### Output Formats

| Format | Description |
|--------|-------------|
| `react` | React/TS components (default) |
| `vue` | Vue 3 SFCs |
| `svelte` | Svelte components |
| `svg` | Raw SVG |
| `json` | Icon metadata |

### Config-Driven Workflow

For larger projects, use a config file:

```bash
unicon init
unicon add dashboard --category Dashboards
unicon add nav --query "arrow chevron"
unicon sync
```

See [CLI.md](./CLI.md) for full documentation.

## AI Integration

Unicon works with AI coding assistants.

### Skills for AI Assistants

Install rules that teach AI assistants to use Unicon:

```bash
unicon skill --ide claude
unicon skill --ide cursor
unicon skill --all
```

**Supported:** Claude Code, Cursor, Windsurf, Agent, Antigravity, OpenCode, Codex, Aider

Then ask your AI:
- "Add a home icon to my project"
- "Search for dashboard icons"

### MCP Server

For deeper integration, use the [MCP](https://modelcontextprotocol.io/) server.

**Claude Desktop / Cursor:**

```json
{
  "mcpServers": {
    "unicon": {
      "command": "npx",
      "args": ["-y", "@webrenew/unicon-mcp-server"]
    }
  }
}
```

**Cloud IDEs (v0, Bolt, Lovable):**

```
https://unicon.sh/api/mcp
```

**Tools:** `search_icons`, `get_icon`, `get_multiple_icons`, `get_starter_pack`

See [MCP docs](./packages/mcp-server/README.md) for details.

## Self-Hosting

Want to run your own instance? See [DEVELOPMENT.md](./DEVELOPMENT.md) for setup instructions.

### Build Notes

- The app build uses `webpack` (`next build --webpack`) for deterministic CI/local builds in restricted environments.
- The home route (`/`) is intentionally dynamic to avoid build-time database fetches during prerender.

[](https://vercel.com/new/clone?repository-url=https://github.com/WebRenew/unicon)

## License

MIT License — see [LICENSE](LICENSE) for details.

Icons retain their original licenses. See [THIRD_PARTY_LICENSES.md](THIRD_PARTY_LICENSES.md) for full attribution.

- MIT: Lucide, Phosphor, Huge Icons, Heroicons, Tabler, Feather, Iconoir, Devicons, Octicons
- Apache-2.0: Remix Icon, Carbon, Blueprint
- CC0: Simple Icons, Cryptocurrency Icons (logos are trademarks of their owners)

---

Built by [WebRenew](https://webrenew.com)

[unicon.sh](https://unicon.sh) · [Issues](https://github.com/WebRenew/unicon/issues)

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [webrenew](https://github.com/webrenew)
- **Source:** [webrenew/unicon](https://github.com/webrenew/unicon)
- **License:** MIT
- **Homepage:** https://unicon.sh

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-webrenew-unicon
- Seller: https://agentstack.voostack.com/s/webrenew
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.