Install IconsDB for your agents

Give your coding agent 146,000 open source icons. The IconsDB MCP server searches by meaning and answers with the exact import for the icon package already in your package.json. Remote, no install, no API key.

MCP endpoint
https://iconsdb.app/mcp

Set up your agent

  1. 1

    Run once in your project (or add --scope user to enable it everywhere):

    claude mcp add --transport http iconsdb https://iconsdb.app/mcp
  2. 2

    Check it connected:

    claude mcp list
  3. 3

    Try: "add home, settings and log-out icons to the sidebar using the icon library already in package.json".

What the agent can do

  • Intent search. “a shopping cart”, “log out”, “a lady cooking” — hybrid keyword + semantic ranking across 57 sets.
  • Package-aware. If the project uses lucide-react, every result is a paste-ready import: import { House } from "lucide-react". Knows Heroicons, Tabler, Phosphor, Remix, Bootstrap, MDI, Font Awesome, Octicons, Radix, Simple Icons, react-icons and more; falls back to @iconify/react or an inline component.
  • Consistency. Ask for several concepts at once and it reports which single set covers all of them, so a nav bar doesn't mix three icon styles.
  • Small responses. Ten grouped rows per query, SVG only when asked, licence and attribution on every answer.

Tools

detect_icon_packages

First call. Pass the project's dependency names; learns which icon sets are already installed.

dependencies: string[]

search_icons

Find icons by meaning. Pass `queries` for several concepts at once to get one set that covers all of them, and `package` to keep results importable.

query | queries[], package?, sets?, kind?, style?, license?, limit?

get_icon

Paste-ready code for one icon: the set's own npm import, the @iconify universal component, and an inline no-dependency component. Also variants and the same icon in other sets.

id, format=react|vue|svelte|solid|svg|jsx|iconify|unplugin|css|data-uri|all, color?, size?, package?

get_icons

Batch get_icon for a whole nav bar or toolbar in one round-trip.

ids[], format?, package?

list_icon_sets

All 57 sets with counts, licence, attribution flag and npm packages.

kind?, license?, package?

Example session

> Add home, settings and log-out icons to the sidebar using our existing icon library.

detect_icon_packages(["react", "next", "lucide-react"])
  → lucide-react (react) → sets: lucide

search_icons({ queries: ["home", "settings", "log out"], package: "lucide-react" })
  → Sets covering all 3 concepts: lucide
    home → lucide:house · settings → lucide:settings · log out → lucide:log-out

get_icons({ ids: ["lucide:house", "lucide:settings", "lucide:log-out"], format: "react" })
  → import { House } from "lucide-react";
    import { Settings } from "lucide-react";
    import { LogOut } from "lucide-react";
    License: ISC — free for commercial use, no attribution

Icons keep their original licences — see licenses.

Trademarks

Brand and product logos (Simple Icons, SVG Logos, Devicon, Font Awesome Brands, Boxicons Logos, Skill Icons and similar sets) are trademarks of their respective owners. The set licenses cover the SVG artwork only and grant no trademark rights; IconsDB is not affiliated with or endorsed by any of these brands. Use logos to identify a brand and follow that brand's own usage guidelines.