MCP server providing access to the Iconify icon API and local icon corpus search/analysis
12 tools with complete schemas and descriptions. Naming follows verb_noun pattern (icons_get, icons_search, etc.). Descriptions are concise (40-120 chars) and explain what each tool does. All parameters have types and descriptions. However, descriptions lack WHEN to use guidance and dependency hints. No output schemas documented. Error handling not visible in tool definitions. Tool annotations present (readOnlyHint, destructiveHint, openWorldHint) but no idempotentHint. Parameters lack enums for constrained values (e.g., flip: 'horizontal|vertical|both', rotate: '90|180|270'). No pagination guidance visible for list tools. Missing recovery hints in descriptions.
Get API domain context
Generate a CSS mask sprite for a list of icons from one set. Required: prefix, icons.
Fetch many icons from one set as a single IconifyJSON payload. Required: prefix, icons.
Fetch one icon as SVG, optionally recoloured and resized. Required: prefix, name. Optional: color, width, height (plus 3 more).
Search icons by keyword across every icon set. Required: query. Optional: limit (default: 64), start, prefix (plus 2 more).
Suggest search keywords that start with or end with a fragment. Optional: prefix, keyword.
Get the last modification time per icon set, for cache invalidation and incremental sync. Optional: prefix, prefixes.
No output schemas documented. LLMs cannot plan downstream calls or extract required fields without knowing response structure. icons_get returns SVG, icons_search returns results array, but structure is implicit.
Constrained parameters lack enums. flip accepts 'horizontal|vertical|both' and rotate accepts '90|180|270' but are defined as free-form strings. LLMs will hallucinate invalid values.
Descriptions lack WHEN-to-use guidance and dependency hints. 'search' tool says 'Requires sync first' but no sync tool exists. icons_search and search appear to overlap but distinction is unclear.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 57 | 2026-07-28+ | v2 |
Report the Iconify API version and serving region.
Full-text search across all synced data. Faster than paginating list endpoints. Requires sync first.
List every icon name in one set, with categories, aliases, and hidden icons. Required: prefix. Optional: info, chars.
List every icon set with its size, author, licence, and category. Optional: prefix, prefixes.
Run read-only SQL against local database
Pagination not documented. icons_search accepts 'limit' and 'start' but no guidance on total count, next_cursor, or result limits. LLMs may request excessive results.
sql tool exposes direct database access with minimal description. No error handling guidance, no query validation hints, no examples of safe queries. High risk for injection or unintended data exposure.