Icon Mcp MCP Server

A powerful Model Context Protocol (MCP) server that provides unified search capabilities across multiple icon libraries with fuzzy search, intelligent caching, and comprehensive filtering options.

Local serverstdio

What is the Icon Mcp Server?

Icon Mcp is an MCP project maintained in the agentic-ph/icon-mcp repository. The maintainer describes its purpose as “A powerful Model Context Protocol (MCP) server that provides unified search capabilities across multiple icon libraries with fuzzy search, intelligent caching, and comprehensive filtering options”. Read the project documentation for the complete scope.

Installation

The documented npm package is icon-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares CACHE_TTL, DEFAULT_SEARCH_LIMIT, LOG_LEVEL. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
query	string, required): Search term for icon names
libraries	string[], optional): Specific libraries to search in
fuzzy	boolean, optional): Enable fuzzy search (default: true)
limit	number, optional): Maximum results to return (default: 10)
threshold	number, optional): Fuzzy search threshold 0.0-1.0 (default: 0.3)
includeScore	boolean, optional): Include match scores (default: true)
id	string, required): Unique identifier of the icon
library	string, required): Name of the library
category	string, required): Category name to search for
search_icons
get_icon
list_libraries
get_library_info
search_by_category

How to install the Icon Mcp Server

{
  "mcpServers": {
    "icon-search": {
      "command": "npx",
      "args": [
        "icon-mcp"
      ],
      "env": {
        "CACHE_TTL": "300000",
        "DEFAULT_SEARCH_LIMIT": "50",
        "LOG_LEVEL": "info"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
CACHE_TTL	Declared in the maintainer’s client configuration.	Check documentation
DEFAULT_SEARCH_LIMIT	Declared in the maintainer’s client configuration.	Check documentation
LOG_LEVEL	Declared in the maintainer’s client configuration.	Check documentation