Skip to content
shadcn.io

shadcn.io is not affiliated with official shadcn/ui

MCP

search_icons

Search icon sets by name or by meaning. A query like delete finds the trash can, and several queries can run in one call.

Group
Icons
Inputs
library?limit?queries?query?
Access
Read-only

When to use it

  • The user wants an icon by what it shows or does: "arrow right", "delete", "github".
  • In the project's own set (library), for icons that match its others.

Inputs

InputType
library?string

One set only (the project's): lucide.

limit?number
queries?string[]

Several at once: the best few for each.

query?string

Its name or meaning: "delete". Or queries.

Example prompts

Name the server, so the agent doesn't answer from memory:

Prompts
use shadcnio to find icons for the sidebar: home, settings and logout
use shadcnio to find a delete icon in Lucide
use shadcnio to find the GitHub logo

Call and response

Asked “Find icons for the sidebar: home, settings and logout”, the agent sends this call. The response is real, trimmed: long lists show their first items and long strings are cut.

Call
search_icons({ library: "lucide", queries: ["home", "settings", "logout"] })
Response
{
  "count": 7,
  "next": "get_icon with names (one set) gives one import, or one command, for them all.",
  "results": [
    {
      "names": [
        "house",
        "bath",
        "… 1 more"
      ],
      "query": "home"
    },
    {
      "names": [
        "settings",
        "cog",
        "… 1 more"
      ],
      "query": "settings"
    },
    "… 1 more"
  ]
}

Call it by hand

Your MCP client sends this for you. To try the tool without one, post the call yourself; the server answers in server-sent events, the result on the data: line.

Terminal
Sign in to get your config
Sign in with a Pro account, and this holds your MCP URL, ready to paste.

What your agent reads

The server's description of search_icons, one of the Icons tools. Your agent reads it to decide when to call the tool:

tools/listsearch_icons.description
Search icon sets (or the project's one) by name or meaning: "delete" finds the trash can. queries for several. Names grouped by set.

Next

FAQ

How does icon search match a query?

Each word, against the icon's name, keywords and tags: "notification bell" finds the bell. The usual meaning of a UI word comes first ("close" is the x, "delete" the trash can), then the sets people use most.

Can I search for several icons at once?

Pass queries: the best few of each, in one call. With library, each query's names as a list.