Model Context Protocol

IconVaultKit for AI Agents

Add one line to your agent config and your AI can search, preview, and fetch icons from 200,000+ icons across 100+ libraries without ever leaving the editor.

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI coding agents call external tools. Once you register the IconVaultKit MCP server in your agent config, your agent gains four new tools it can call at any time during a coding session.

No manual browsing, no copy-pasting icon names. Your agent searches, picks, and drops in the right icon on its own.

Endpoint

https://iconvaultkit.com/api/mcp

HTTP transport, JSON-RPC 2.0, MCP protocol version 2024-11-05. No API key required.

Setup

Claude Code(CLI or desktop app)

Run this command in your terminal, or add it manually to ~/.claude/claude.json:

claude mcp add --transport http iconvaultkit https://iconvaultkit.com/api/mcp

Or add manually to ~/.claude/claude.json:

{
  "mcpServers": {
    "iconvaultkit": {
      "type": "http",
      "url": "https://iconvaultkit.com/api/mcp"
    }
  }
}

Cursor

Go to Cursor Settings and open the MCP tab, or edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "iconvaultkit": {
      "url": "https://iconvaultkit.com/api/mcp"
    }
  }
}

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "iconvaultkit": {
      "serverType": "http",
      "url": "https://iconvaultkit.com/api/mcp"
    }
  }
}

Verify the connection

After adding the config, restart your agent and ask it:

"List the available icon libraries from IconVaultKit"

If the server is connected, your agent will call list_collections and return the full library list.

Available tools

search_icons

Search icons by keyword across 100+ libraries.

Parameters

querystringKeyword to search for (e.g. home, arrow right, user)

collectionstringoptionalLimit to one library prefix (e.g. lucide, mdi, heroicons)

limitnumberoptionalMax results, default 20, max 100

Example

search_icons({ query: "home", collection: "lucide", limit: 5 })

Returns

lucide:home  (Lucide)
lucide:home-3d  (Lucide)
lucide:fence  (Lucide)
...

get_icon_svg

Get the SVG markup for a specific icon.

Parameters

collectionstringLibrary prefix (e.g. lucide, mdi, heroicons)

namestringIcon name (e.g. home, arrow-right)

colorstringoptionalCSS color value, default currentColor

sizenumberoptionalSize in pixels, default 24

Example

get_icon_svg({ collection: "lucide", name: "home", color: "#6366f1", size: 32 })

Returns

<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" ...>...</svg>

list_collections

List all available icon libraries with their prefix and display name.

Example

list_collections()

Returns

mdi                          Material Design Icons
lucide                       Lucide
heroicons                    Heroicons
... (80+ libraries)

get_collection_icons

Browse all icons in a specific library.

Parameters

collectionstringLibrary prefix (e.g. heroicons, tabler)

limitnumberoptionalMax icons to return, default 50

Example

get_collection_icons({ collection: "heroicons", limit: 10 })

Returns

heroicons:academic-cap
heroicons:academic-cap-solid
heroicons:adjustments-horizontal
...

Example workflow

Tell your agent what you need in plain language and it will use the tools automatically:

"Add a home icon to the sidebar using Lucide"

"Find a settings icon from Heroicons and drop it into the nav component"

"What arrow icons does Tabler have? Use one for the back button"

"Replace all the Font Awesome icons in this file with Material Design equivalents"

Direct API access

You can also call the MCP endpoint directly with any JSON-RPC 2.0 client:

curl -X POST https://iconvaultkit.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "search_icons",
      "arguments": { "query": "home", "limit": 5 }
    }
  }'

A GET /api/mcp returns a JSON overview of all tools and setup instructions.

Listed on Smithery

IconVaultKit is listed on Smithery, an MCP server registry. You can install it from there or leave a review.

Questions

If you run into issues or need a feature, reach out at info@iconvaultkit.com or browse icons manually at iconvaultkit.com/icons.