Icons for coding agents

Every open-source icon, inside your coding agent.

One MCP server puts 314,000+ open-source icons inside Claude Code, Codex, Cursor and every other MCP client: your agent searches them by name and writes the exact SVG into your project.

Get your license key Read the setup guide

You

“Add a settings icon to the navbar and a bell for notifications.”

Open Source Icon · Search results

settingsLucide
bellLucide
settingsTabler Icons

Search by intent

Ask for “a settings gear” and the agent searches 314,000+ icons from 230+ libraries — the website's own typo-tolerant search, narrowed by library or collection.

The exact SVG

The agent fetches the icon itself at the size and color it asked for, ready to write to a file or paste inline. Every icon keeps its own open-source license.

Every MCP client

Claude Code, Codex, Cursor, Claude Desktop, Windsurf — anything that speaks MCP. It runs through npx: nothing to install, nothing bundled, never out of date.

One command, two tools

Your agent gets an icon workflow — not another search box.

1Search by intent. The agent asks for “a settings gear”, not a file name, and gets ranked matches from every library.
2Retrieve the exact SVG. One call returns the icon itself, at the size and color the design needs.
3Write it into the project. Plain SVG text lands in your component or your assets folder — nothing vendored, nothing bundled.
4Credit the library. The same call hands back the author and the license, so the agent can name them where they belong.

claude mcp add opensourceicon --env OSI_LICENSE_KEY=osi_… -- npx -y @opensourceicon/mcp-server

Runs through npx as @opensourceicon/mcp-server. Requires Node.js 18 or newer.

Give your agent a real icon system

One key. Every icon. Every agent.

Get your license key Open the guide

Open Source Icon for agents

Give your coding agent a consistent icon system.

Create a key, add the server to your client, then ask for an icon in plain language.

Install: npx -y @opensourceicon/mcp-server — every command below fetches the server on first run, so there is nothing to install by hand.

Quickstart

1Create your key. Sign in and copy the free license key from Settings. One per account, and every tool authenticates with it.
2Add the server. Run the command for your client with your own key in place of osi_…, or paste the JSON into the client's MCP config, then restart it.
3Ask the agent. “Add a lucide settings icon to the navbar.” It searches, picks a match and writes the SVG.

Claude Code

Run it once in your terminal with your own key in place of osi_…, then restart the CLI.

Terminal

claude mcp add opensourceicon --env OSI_LICENSE_KEY=osi_… -- npx -y @opensourceicon/mcp-server

Codex

The same shape from the Codex CLI.

Terminal

codex mcp add opensourceicon --env OSI_LICENSE_KEY=osi_… -- npx -y @opensourceicon/mcp-server

Other MCP clients

Cursor, Claude Desktop, Windsurf and the rest read a JSON config — paste this entry into it and restart the client.

JSON

{
  "mcpServers": {
    "opensourceicon": {
      "command": "npx",
      "args": ["-y", "@opensourceicon/mcp-server"],
      "env": { "OSI_LICENSE_KEY": "osi_…" }
    }
  }
}

Tools

What the agent can call once the server is running.

Tool	Input	Answer
search_icons	query, library?, collection?, limit?	Matching icons as prefix, name and palette, with the total found.
get_icon	prefix, name, size?, color?	The SVG, with its page here, the library, the author and the license.

Security

The key travels in an environment variable. OSI_LICENSE_KEY is set in your MCP client's config; the server reads it from the environment only and sends it as an Authorization header.
Never commit it. Keep it out of the repository, out of shared config you push and out of screenshots.
Regenerating it in Settings revokes the old one at once — for the MCP server, the VS Code extension and the Figma plugin alike.
The server writes nothing to your repository. It answers with SVG text; your agent decides where that text goes.