lordicon-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@lordicon-mcp Find a search icon and give me the React embed code."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Related MCP server: icogenie-mcp
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-mcpOther 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 |
| string | Yes | Search query |
| string | No | Filter by family |
| string | No | Filter by style |
| boolean | No | Filter by premium status |
| number | No | Page number (default: 1) |
| 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 |
| string | Yes | Icon family |
| string | Yes | Icon style |
| 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 |
| string | Yes | Icon family |
| string | Yes | Icon style |
| number | Yes | Icon index from search results |
| string | No |
|
| string | No | Animation trigger (default: |
| number | No | Size in pixels (default: 64) |
| string | No | Color customization |
Development
npm install
npm run buildTest with the MCP Inspector:
LORDICON_API_KEY=your-key npx @modelcontextprotocol/inspector node dist/index.jsLicense
MIT
Available Tools
4 toolsget_embed_codeB
Generate ready-to-use embed code for a Lordicon icon in HTML, React, or web component format.
Inputs: index (required), style (required), family (required), size, +3 more.
get_icon_previewA
Get a visual preview of a specific Lordicon icon. Returns the icon as an embedded SVG image.
Inputs: index (required), style (required), family (required), name.
list_familiesA
List all Lordicon icon families and their styles with icon counts
Inputs: no named parameters.
search_iconsA
Search Lordicon icons by keyword. Returns icon names, families, styles, and indices for use with other tools.
Inputs: query (required), page, style, family, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct role in the icon workflow: discovery (list_families), search (search_icons), visualization (get_icon_preview), and integration (get_embed_code). There is no overlap or ambiguity between them.
All tool names follow the consistent verb_noun pattern (list_families, search_icons, get_icon_preview, get_embed_code). This makes the API predictable and easy to navigate.
Four tools is well-scoped for an icon service focused on search and usage. Each tool earns its place without redundancy or bloat, covering the essential user journey in a compact set.
The tool surface covers the full lifecycle for working with Lordicon icons: browse families, search for icons, preview them, and generate embed code. There are no obvious gaps for the stated purpose.
Maintenance
Related MCP Connectors
AI tool directory MCP server, live since July 2026. Tools, agents, models, companies, services.
Read-only search over 2,065+ AI agent tools and 276 MCP servers. Free, no sign-up needed.
Web search API and MCP server for developers building AI agents.
MCP server for building and testing AI agents with multi-model experimentation and insights.
Related MCP Servers
- AlicenseBqualityDmaintenanceMCP server that allows FE/UI/Designers to retrieve SVG icons via the Iconify API by simply asking LLMs rather than manually searching websites.321 npm4MIT
- AlicenseNot gradedqualityDmaintenanceAI-powered SVG icon generation MCP server. Generate production-ready SVG icons from text descriptions with customizable styles, sizes, and themes.108 npm8MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that provides AI tools with deep understanding of WireUI v2.x components and comprehensive icon support for Heroicons and Phosphor Icons.MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for searching Material Design Icons, enabling AI agents to find icons by name, alias, category, or concept.MIT