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.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search query |
family | string | No | Filter by family |
style | string | No | Filter by style |
premium | boolean | No | Filter by premium status |
page | number | No | Page number (default: 1) |
per_page | number | No | Results per page (default: 20, max: 50) |
get_icon_preview
Get a visual SVG preview of a specific icon.
| Parameter | Type | Required | Description |
|---|---|---|---|
family | string | Yes | Icon family |
style | string | Yes | Icon style |
index | number | Yes | Icon index from search results |
list_families
List all icon families with their styles and icon counts. No parameters.
get_embed_code
Generate embed code for an icon.
| Parameter | Type | Required | Description |
|---|---|---|---|
family | string | Yes | Icon family |
style | string | Yes | Icon style |
index | number | Yes | Icon index from search results |
format | string | No | html, react, or web-component (default: html) |
trigger | string | No | Animation trigger (default: hover) |
size | number | No | Size in pixels (default: 64) |
colors | string | No | Color customization |
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