Aicon
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., "@Aicon search for home icons in heroicons"
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.
π¨ Aicon - AI Icon Search & Generation
MCP Server + API for intelligent icon management with AI-powered generation and web-based authentication.
π Quick Start
For Users
# 1. Install the MCP server
npm install -g aicon-mcp
# 2. Add to Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"aicon": {
"command": "aicon",
"args": []
}
}
}
# 3. Authenticate in Claude Desktop
# Use: login({action: "login"}) to start web authenticationFor Developers/Admins
See DEPLOY.md for complete deployment instructions.
Related MCP server: Iconify MCP Server
π What This Does
π Search Icons: Find from 275,000+ existing icons (Material, Heroicons, Lucide, etc.)
π¨ Generate Icons: Create custom icons using AI (powered by Runware.ai)
π₯ Download Icons: Save as SVG or PNG with background removal
π Web Authentication: Claude Code-style login flow with subscription plans
π Usage Tracking: Monitor API usage and rate limits
π Secure: API key authentication with permission controls
π Authentication System
Web-Based Login Flow
Run
login({action: "login"})in Claude DesktopBrowser opens automatically for authentication
Login/register with credentials
Select subscription plan (Free/Pro/Enterprise)
API key generated and saved automatically
All icon tools now available!
Subscription Plans
π FREE: 100 searches/month, SVG downloads
π PRO: Unlimited searches + AI generation ($9/month)
π’ ENTERPRISE: Everything unlimited + API access ($29/month)
ποΈ Architecture
βββββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββ
β MCP Server βββββΆβ Backend API βββββΆβ External APIs β
β (Local) β β (Vercel) β β Iconify+Runware β
βββββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββ
β β β
βΌ βΌ βΌ
βββββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββ
β Claude Desktop β β Supabase DB β β Generated SVGs β
β (AI Client) β β (Usage & Keys) β β (./Aicon/) β
βββββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββπ¦ Components
1. MCP Server (/src/)
Tools: 6 MCP tools including web authentication
Config: Multi-level configuration (env, user, project)
Storage: Local file management for downloaded icons
Client: HTTP client with request tracking
2. Backend API (Deployed to Vercel)
Endpoints: REST API for icon search, generation, usage
Auth: Production API key system with permissions
Database: Supabase integration for usage tracking
Processing: Image manipulation (Sharp, Potrace)
π οΈ Development
MCP Server
npm install
npm run dev # Development mode
npm run build # Build TypeScript
npm run typecheck # Type checkingπ― Usage Examples
Authenticate First
// Start web authentication in Claude Desktop
login({action: "login"})
// Check authentication status
login({action: "status"})
// View subscription plans
login({action: "plans"})Search for Icons
// Search icons after authentication
search_icons({
query: "home",
library: "heroicons",
style: "outline"
})Generate Custom Icons
// Generate AI icons (Pro/Enterprise plans)
generate_icons({
subject: "rocket ship",
context: "space app",
style: "filled",
colors: "blue gradient"
})Download Icons
// Download icons in various formats
fetch_icons({
id: "heroicons:home",
type: "iconify",
format: "svg"
})π Features
β 275,000+ Icons from 200+ open source icon libraries
β AI Generation with background removal
β Web Authentication Claude Code-style login flow
β Subscription Plans Free/Pro/Enterprise tiers
β Format Support (SVG, PNG)
β Rate Limiting with usage tracking
β Production Ready with comprehensive tests
β Claude Integration via MCP protocol
π License
MIT License - see LICENSE file for details.
Available Tools
1 toolloginLogin to Icon MCP ServiceC
Authenticate with your Icon MCP account through the web interface to access premium features.
Inputs: action (required), apiKey.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 1 tool
With only a single tool, there is no possibility of confusion between tools. The purpose of 'login' is clear and distinct within its narrow scope.
The single tool name 'login' is a clear, conventional verb that is easy to understand. There are no other tools to create inconsistencies or mixed naming conventions.
A single tool is too few for a server that promises 'premium features' and implies an underlying application surface. The server appears to offer authentication only, leaving core functionality unexposed.
The tool surface is severely incomplete. Only authentication is available; there are no tools to perform any actual premium functions, data operations, or other workflows that the login is meant to unlock.
Related MCP Connectors
Icons for agentic development: search & fetch 366,000+ open-source icons as SVG/PNG. No API key.
Multilingual semantic SVG icon search with previews for AI coding agents. 20,000+ icons.
Search 161,000+ free icons; get SVG (single/bulk), PNG, related icons, webfont classes. No API key.
Icons that match, in your colors. Your AI finds them for your website or slides, in 10 languages.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides access to over 200,000 icons from 150+ collections with features for searching, recommendations, and direct file synchronization. It supports multiple frameworks and optimizes AI performance by writing icon code directly to project files.1,751 npm1,485MIT
- AlicenseNot gradedqualityDmaintenanceProvides access to over 200,000 open-source vector icons from more than 200 icon sets via the Iconify API. It enables users to browse, search, and retrieve specific icon data along with usage examples for popular web frameworks like React, Vue, and Tailwind CSS.490 npm24GPL 3.0
- FlicenseNot gradedqualityDmaintenanceVisual icon search, retrieval, and comparison for AI agents. Search 200k+ icons semantically, render side-by-side comparison grids, and retrieve raw SVG markup β all tools return images so vision-capable LLMs can see the icons.1-

Svg/icons MCPofficial
AlicenseNot gradedqualityCmaintenanceEnables AI coding tools to search, inspect, recommend, and export SVG icons from svgicons.com for use in design systems, frontend projects, and AI-assisted workflows.MIT