Aria Icons MCP Server

About Aria Icons

Aria Icons is an open-source icon explorer with 340,000+ SVG icons. Search, customize, and export icons in the browser or CLI, and connect AI assistants via a remote MCP server at https://icons.leularia.com/api/mcp. npm: aria-icons.

Aria Icons tools (12)

Read from the live server on Nov 8, 2026. These are the tools your AI assistant can call once connected.

search_icons

Fuzzy-search icons across all sets by name and metadata (brand titles, aliases, categories). Returns ranked matches with icon ids usable with get_icon_svg. Prefer this over list_icons when looking for a specific icon.

list_icons

List available icons in an organized way. Without arguments, returns a summary of all icon sets with counts. Pass 'set' to page through the icon names of one set.

get_icon_svg

Get the SVG content for a specific icon. The icon identifier should be in the format 'setId-iconName' (e.g., 'heroicons-academic-cap', 'thesvg-github', 'ph-acorn-bold'). For theSVG brand icons an optional 'variant' selects e.g. 'mono' or 'w

get_icon

Get SVG plus metadata for an icon. Prefer this over get_icon_svg. Icon ids look like 'lucide:house' or 'mdi:account'.

get_icon_component

Get framework component source for an icon (react, vue, svelte, solid, flutter, react-native, svg).

get_icons

Batch-fetch up to 20 icons. More efficient than multiple get_icon calls.

list_collections

List icon collections with counts. Filter with search.

find_similar_icons

Find the same icon in other collections, plus related names.

find_equivalent_icon

Map an icon to the closest match in a target collection (used by migrate).

recommend_icons

Recommend icons for a UI use case (settings button, auth, navigation, …).

add_icon_to_project

Prepare an icon component for the project. Remote HTTP cannot write the user's disk — returns file name, component source, and import. Local stdio MCP (`npx -y aria-icons`) writes the file.

doctor_project_icons

Remote servers cannot scan a local repo. Use stdio MCP or `aria-icons doctor`.

How to connect Aria Icons to Claude, Cursor or VS Code

Aria Icons runs as a hosted remote MCP server at https://icons.leularia.com/api/mcp. Add that URL to your MCP client's config (Claude Code, Cursor, Windsurf or VS Code) and the tools appear immediately, no install required.

{
  "mcpServers": {
    "aria-icons": {
      "url": "https://icons.leularia.com/api/mcp"
    }
  }
}

Claude Code: claude mcp add --transport http aria-icons https://icons.leularia.com/api/mcp. VS Code's .vscode/mcp.json uses a servers key instead of mcpServers (see how). Servers that require OAuth or an API key will prompt on first use.