lordicon-mcp

An MCP (Model Context Protocol) server that lets AI agents search, preview, and generate embed code for Lordicon animated icons.

Features

• Search icons — Find icons by keyword with filtering by family, style, and premium status

• Preview icons — Get visual SVG previews that AI agents can actually see

• Browse families — List all available icon families and styles

• Generate embed code — Get ready-to-paste HTML, React, or web component code

Setup

1. Get a Lordicon API Key

Sign up at lordicon.com and get your API key from the dashboard.

2. Add to your MCP client

Claude Code

claude mcp add lordicon -e LORDICON_API_KEY=your-api-key-here -- npx -y github:roandegraaf/lordicon-mcp

Other MCP Clients

Add the server to your client's MCP configuration:

{
  "mcpServers": {
    "lordicon": {
      "command": "npx",
      "args": ["-y", "github:roandegraaf/lordicon-mcp"],
      "env": {
        "LORDICON_API_KEY": "your-api-key-here"
      }
    }
  }
}

Tools

search_icons

Search for icons by keyword.

get_icon_preview

Get a visual SVG preview of a specific icon.

list_families

List all icon families with their styles and icon counts. No parameters.

get_embed_code

Generate embed code for an icon.

Development

npm install
npm run build

Test with the MCP Inspector:

LORDICON_API_KEY=your-key npx @modelcontextprotocol/inspector node dist/index.js

License

MIT