Keyline Icons

What Keyline Icons MCP server does

The Keyline Icons MCP server gives an MCP-speaking assistant access to the Keyline Icons collection. It can search the icon set by name, return an icon's SVG source, and provide the corresponding React import. This is useful when an agent needs to identify a real asset and produce code for it rather than inventing an icon name or drawing.

The underlying collection contains 1,435 icons. Each icon is available in four styles—stroke, two-tone, duotone, and fill—and in rounded or sharp corner treatments where the relevant drawing exists. The set also includes square and circle container variants for supported icons.

How it works

The Keyline Icons MCP server runs as a local command-line process and communicates with the client over standard input and output. An MCP-compatible assistant sends a search or icon lookup request, and the server returns the matching icon data. No API key or network connection is required for the server operation described here.

Search results help an assistant select a name from the actual collection. After an icon is selected, the server can return SVG markup for the requested style and corner treatment, or show how to import that icon from the React package. The React output is suited to the @keyline-icons/react package, whose components accept normal SVG properties and a size prop.

Setup and configuration

Run the package with npx from an MCP client configuration. For Claude Code, the documented command is:

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

The same command can be used by other clients that support MCP over stdio, with configuration syntax adjusted to the client. The supplied material does not specify required environment variables, a separate configuration file, or a network endpoint.

Because the server is intended to run locally through npx, the project using it does not need an API key. The source repository is MIT licensed, and the icon collection is described as free under MIT.

Tools and capabilities

The Keyline Icons MCP server supports these workflows:

• Search the icon collection by name or query.
• Retrieve SVG source for a selected icon.
• Choose among available visual styles, including stroke, two-tone, duotone, and fill.
• Choose rounded or sharp corner treatments when available.
• Return a React import for the selected icon.
• Work with container forms such as supported square- and circle- icons.

The available output depends on the icon. For example, an icon with no fillable interior may only exist in stroke variants, while icons with an interior can have more style options. The server exposes the set; it does not imply that every icon has every style-specific drawing.

Limitations and notes

This server focuses on searching and retrieving Keyline Icons assets. The provided material does not describe editing icons, generating new drawings, inserting assets into design tools, or returning framework code other than the React import output.

The server requires an MCP client that can launch a stdio process. The README names Claude Code's setup command and states that other MCP-over-stdio clients can use the same command pattern. SVG files and React components in the repository are generated outputs, so changing the source drawings is a repository build workflow rather than an MCP-server feature.