MCP server

Aria Icons MCP: 1.4M SVG Icons and a CLI for AI Coding Agents

Aria Icons is a searchable catalog of open-source SVG icons with a CLI and an MCP server, so an AI agent can find, fetch and write icons into your repo.

Run
npx -y aria-icons@latest setup
View on GitHub

Stars, license and last push from GitHub. Install count as reported by the open skills directory.

What is Aria Icons MCP?

Aria Icons combines a web catalog of about 1.4 million open-source SVG icons, a command line tool and an MCP server. An AI agent can search collections, fetch one icon or a batch, find similar icons across sets, and map existing imports onto a single collection.

Aria Icons is a monorepo with a website, a CLI published as the aria-icons package and an MCP server. The catalog mixes vendored sets such as Lucide, Tabler and Heroicons with Iconify collections and a large set of brand logos.

Icon ids follow a collection:name pattern, for example lucide:house or thesvg:github. The same ids work in the CLI, the REST endpoints and the MCP tools, which keeps an agent's requests short.

What changes in your agent's output

  • Icons are written as files in the repository by the add command, instead of inline SVG pasted into chat.
  • A doctor command audits a codebase that mixes several icon libraries.
  • A migrate command maps existing icon-package imports onto one chosen collection.
  • A suggest command recommends a consistent set for a source folder.

Local or hosted MCP

The local route runs aria-icons over stdio through npx. The README also lists a hosted HTTP endpoint with the same catalog, which suits clients that prefer a URL entry over a local process.

Who Aria Icons is for

Best for

  • Teams cleaning up a codebase that imports from three icon packages and want one consistent set.
  • Developers who need brand logos and general icons from a single search.
  • Agents working beside shadcn MCP components that need matching icons.

Not for

  • Projects with strict license rules and no time to check sets. The README says icons keep their own upstream licenses, including copyleft ones.
  • Custom illustration work. It finds existing icons only.
  • Anyone who wants a zero-network setup, because the CLI and hosted MCP call a public API. Keyline Icons MCP is another option to compare.

Use it with UiChemy

Aria Icons covers icons inside code. For a WordPress build, UiChemy converts a Figma design with Figma to WordPress and lets you refine it with Composer in Elementor or Gutenberg. Click Get Started on uichemy.com.