What is the Unicon MCP server?
Unicon is an icon browser described as shadcn for icons, with 20,000+ icons from nine libraries. Its MCP server gives an AI coding agent four tools, search_icons, get_icon, get_multiple_icons and get_starter_pack, so the agent can search the libraries and fetch single icons or several at once.
Unicon is an icon browser with the tagline Just the icons you need, zero bloat. It lets you search 20,000+ icons and copy exactly what you need, like shadcn/ui, but for icons.
Its MCP server exposes four tools, search_icons, get_icon, get_multiple_icons and get_starter_pack, so an AI coding agent can search the icon libraries and fetch a single icon or several at once.
What changes in your agent's output
- The web app and CLI output React components, raw SVG or JSON, and the MCP server gives the agent four tools to search icons and fetch one or several.
- Unicon's pitch is copying only the icons you need, with zero dependencies, instead of installing a whole icon library.
- Search spans nine libraries at once, from Lucide and Phosphor to Tabler, Heroicons and Simple Icons brand logos.
- Unicon also ships a CLI, skills for AI assistants and a hosted endpoint for cloud IDEs.
How the setup works
- Add the JSON entry to the MCP configuration of Claude Desktop or Cursor, or point a cloud IDE such as v0, Bolt or Lovable at the hosted endpoint.
- Ask the agent for an icon, for example to add a home icon to the project or to search for dashboard icons.
Who the Unicon MCP server is for
Best for
- Front end developers who want a few icons from several libraries without installing each package.
- Builders working in v0, Bolt or Lovable, which can use the hosted endpoint.
- Developers who like the shadcn/ui copy-what-you-need model, since Unicon describes itself as shadcn/ui but for icons. The shadcn/ui MCP server covers components.
- Teams that also want an AI coding agent to follow icon grid, size and naming rules after the icons arrive. Unicon supplies the icons and the Icon System skill covers the rules.
Not for
- Libraries not yet added. Carbon, Blueprint, Devicons, Octicons and Cryptocurrency Icons are listed as coming soon.
- Android Vector Drawable output. Unicon offers React, Vue, Svelte, SVG and JSON, while the SVG to Android Vector Drawable MCP server converts SVG to Android Vector Drawable XML.
Connect Unicon MCP Server: Search and Copy Icons From 9 Libraries With an AI Coding Agent to your AI client
npx -y @webrenew/unicon-mcp-serverClaude Desktop and Cursor
Add the JSON entry above to the client's MCP configuration.
Cloud IDEs
In v0, Bolt or Lovable, use the hosted endpoint listed below.
CLI
Run
npx @webrenew/unicon search arrowto search without installing, ornpm install -g @webrenew/uniconto keep the CLI.AI skills
Run
unicon skill --ide claude, or use--ide cursoror--all, to install rules that teach an assistant to use Unicon. Supported are Claude Code, Cursor, Windsurf, Agent, Antigravity, OpenCode, Codex and Aider.
Client configuration
{
"mcpServers": {
"unicon": {
"command": "npx",
"args": ["-y", "@webrenew/unicon-mcp-server"]
}
}
}Endpoints and ports
https://unicon.sh/api/mcpFor cloud IDEs such as v0, Bolt and Lovablehttps://unicon.shBrowse and copy iconsWhat you can do with it
- 20,000+ iconsNine libraries sit behind one search: Lucide, Phosphor, Huge Icons, Heroicons, Tabler, Feather, Remix Icon, Simple Icons and Iconoir.
- Natural language search in the web appSearching happy face finds smile icons, and business finds briefcases and charts.
- Copy formatsThe web app copies icons as React components, raw SVG or JSON metadata, and the CLI also outputs Vue 3 SFCs and Svelte components.
- BundlesSelect several icons and export a single file with all React components, individual SVG files or JSON metadata.
- Config driven workflowThe CLI offers unicon init, unicon add and unicon sync for larger projects.
- Hosted and local serversRun the npx server in a desktop MCP client, or use the hosted endpoint in cloud IDEs.
- Open in v0Send selected icons to v0 to prototype UI components.
Tools it exposes
search_icons
Searches Unicon's icon libraries.
get_icon
Fetches a single icon.
get_multiple_icons
Fetches several icons at once.
get_starter_pack
One of the four Unicon MCP tools, named get_starter_pack in the README.
Frequently asked questions
What is the Unicon MCP server?
It is the MCP server for Unicon, an icon browser with 20,000+ icons from nine libraries. It gives an AI coding agent four tools, search_icons, get_icon, get_multiple_icons and get_starter_pack, so the agent can search the libraries and fetch single icons or several at once without installing whole icon packages.
How do I install the Unicon MCP server?
For Claude Desktop or Cursor, add an mcpServers entry named unicon that runs npx with the arguments -y @webrenew/unicon-mcp-server. For cloud IDEs such as v0, Bolt and Lovable, use the hosted endpoint listed in the connect section instead. Then ask the agent to add a home icon or to search for dashboard icons.
Which tools does it have?
It has four tools: search_icons, get_icon, get_multiple_icons and get_starter_pack. The server runs through npx for Claude Desktop and Cursor, and a hosted endpoint serves cloud IDEs such as v0, Bolt and Lovable. Further detail lives in the MCP docs under packages/mcp-server in the repository.
Which icon libraries does Unicon search?
Nine libraries: Lucide, Phosphor, Huge Icons, Heroicons, Tabler, Feather, Remix Icon, Simple Icons and Iconoir. Simple Icons holds 3,300+ brand logos and Tabler holds 5,000+ icons, Lucide 1,500+ and Huge Icons 4,000+. Carbon, Blueprint, Devicons, Octicons and Cryptocurrency Icons are listed as coming soon.
What formats can I get icons in?
The web app offers a React component, raw SVG or JSON metadata, and you can bundle several icons into one file of React components or into individual SVG files. The CLI also supports Vue 3 SFCs and Svelte components, with React and TypeScript as the default output.
Can I use Unicon without MCP?
Yes. The CLI runs with npx, for example npx @webrenew/unicon search arrow, and unicon get home prints an icon as a React component. A config file workflow with init, add and sync suits larger projects, and the web app at unicon.sh lets you browse and copy icons by hand.
What license does Unicon use?
It is MIT licensed. The webrenew/unicon repository uses the MIT license, and the icons keep their own original licenses. Lucide, Phosphor, Huge Icons, Heroicons, Tabler, Feather and Iconoir are MIT, Remix Icon is Apache-2.0, and Simple Icons is CC0, with full attribution in THIRD_PARTY_LICENSES.md.


