Skip to main content
Glama

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-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

Available Tools

4 tools
get_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

    A3.9/5.0

    Scored across 4 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      MCP server that allows FE/UI/Designers to retrieve SVG icons via the Iconify API by simply asking LLMs rather than manually searching websites.
      3
      21 npm
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      AI-powered SVG icon generation MCP server. Generate production-ready SVG icons from text descriptions with customizable styles, sizes, and themes.
      108 npm
      8
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that provides AI tools with deep understanding of WireUI v2.x components and comprehensive icon support for Heroicons and Phosphor Icons.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for searching Material Design Icons, enabling AI agents to find icons by name, alias, category, or concept.
      MIT