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 collections. Returns icon names in prefix:name format (e.g., "mdi:home"). Use get_icons to fetch SVG data for results.

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

Get SVG code and dimensions for specific icons. Input icon names in prefix:name format (e.g., "mdi:home", "fa:star"). Returns SVG markup, width, and height.

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

Browse available icon collections. Returns prefix, name, icon count, author, license, and category. Use the prefix with search_icons or get_icons.

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");