@keyline-icons/mcp

An MCP server for Keyline Icons. Lets an agent search the set, read an icon's SVG, and get the right React import, without guessing at names.

Install

Claude Code:

claude mcp add keyline-icons -- npx -y @keyline-icons/mcp

Anything else that speaks MCP over stdio:

{
  "mcpServers": {
    "keyline-icons": {
      "command": "npx",
      "args": ["-y", "@keyline-icons/mcp"]
    }
  }
}

No API key, no network. The whole set ships inside the package.

Tools

| Tool | What it does | | --- | --- | | describe_set | Counts, styles, and the rule deciding which icons have which style. Worth calling first. | | search_icons | Find icons by name. Returns which styles each has. | | get_icon | Full SVG source for one name, style and corner treatment, regular or sharp. | | get_react_usage | The import line and JSX from @keyline-icons/react, sharp entry points included. |

Why the tools are shaped this way

Names are guessable but not obvious. Compounds read base-first, so a mail icon with a tick is mail-check and not check-mail, and containers are prefixes: square-arrow-down. search_icons ranks exact over prefix over word-boundary over substring, so searching check returns check before the twelve compounds containing it.

A missing style is a real answer, not an error. bar-chart is three open strokes with no interior, so it has no fill, and the tool says exactly that rather than returning nothing. Duotone and fill need a fillable region, which comes from the glyph's own enclosed area or from a square/circle container.

Typos resolve in one turn. A name that misses is matched by substring, then by edit distance, then by leading segment, so chekc suggests check and arow suggests the arrow-* family even though there is no bare arrow icon.

Licence

MIT.