Iconify

liveTechnology

Search icons, retrieve SVG data, and list collections from the Iconify open-source icon library

3tools
0msauth
free tier50 calls/day

Tools

search_iconsrequired: query

Search for icons by keyword across all Iconify collections. Returns icon names in "prefix:name" format (e.g., "mdi:home").

Parameters
NameTypeDescription
queryreqstringSearch keyword (e.g., "home", "arrow", "user")
limitoptnumberMaximum number of results (1-999, default 32)
▶Try it
get_iconsrequired: prefix, icons

Retrieve SVG body data for one or more icons in a specific collection. Returns SVG body, width, and height for each icon.

Parameters
NameTypeDescription
prefixreqstringCollection prefix (e.g., "mdi", "fa", "heroicons", "lucide")
iconsreqstringComma-separated icon names within the collection (e.g., "home,arrow-left,user")
▶Try it
list_collections

List all available icon collections in Iconify. Returns collection prefix, name, total icon count, author, license, and category.

No parameters required.

▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/iconify/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/iconify/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_icons","arguments":{"query": "hello"}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("search_icons", {"query":"example"});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("search icons, retrieve svg data, and list collections from the iconify open-source icon library");