MCP Server — fckicons

MCP Server for Claude Code

Use fckicons directly from Claude Code. Search icons by description, generate PNG URLs, and download icon files — all from your AI assistant.

What is MCP?

The Model Context Protocol lets AI assistants use external tools. The fckicons MCP server gives Claude access to 5,400+ icons from Font Awesome, Bootstrap Icons, and Material Symbols.

Setup

Run this command in your terminal:

claude mcp add --transport http --scope project fckicons https://fckicons.com/mcp-server

Or just ask Claude Code:

Add the MCP server https://fckicons.com/mcp-server

Verify the installation:

claude mcp list

Restart Claude Code. Done. The fckicons tools are immediately available.

This adds the following to .mcp.json in your project root (sharable via git):

{
  "mcpServers": {
    "fckicons": {
      "type": "http",
      "url": "https://fckicons.com/mcp-server"
    }
  }
}

Available tools

TOOL search_icons

Search for icons by description. Claude uses this to find the best icon for a given context.

`query`	Descriptive search — "shopping cart", "download arrow", "warning"
`family`	Optional filter: `fontawesome`, `bootstrap-icons`, `material-symbols`
`limit`	Max results (default 10)

TOOL get_icon

Get full metadata for a specific icon — styles, tags, description.

`family`	Icon family
`name`	Icon name (e.g. `house`, `heart`)

TOOL get_icon_image

Get an icon as PNG or SVG. Claude receives the image content and can save it directly to your project using its Write tool.

`family`	Icon family
`name`	Icon name
`format`	`png` (raster, default) or `svg` (vector, scalable)
`size`	16–1024 pixels (default 256, PNG only)
`color`	Hex color without `#` (default `000000`)
`bg`	Hex color or `transparent`
`style`	Icon style variant

TOOL list_families

List all available icon font families with their icon counts and versions. No parameters.

Usage examples

Once installed, just ask Claude in natural language:

"Find me a home icon in red, 64px"
"Get me a blue shopping cart icon and save it to ./assets/cart.png"
"Generate an img tag for a white star icon on a dark background"
"What icon families are available?"
"Search for icons related to notifications"

Claude will pick the right tool, find the best matching icon, and generate exactly what you need.

Environment variables

FCKICONS_BASE_URL API base URL. Default: https://fckicons.com. Set to http://localhost:5011 for local development.