Mozaic vs Icons MCP
A side-by-side look at the Mozaic and Icons MCP MCP servers: transport, auth, tools, quality signals, and the config to install either one in Claude, Cursor, Windsurf or VS Code.
Verdict: choose Mozaic for architecture & design work as a local process; choose Icons MCP for architecture & design over a hosted endpoint. You can also run both side by side in one mcpServers block.
Which MCP server should you choose?
Choose Mozaic when
- You need dedicated capabilities in the Architecture & Design domain.
- You prefer a local stdio subprocess transport.
- You have the keys it needs:
PORT, AUTH_TOKEN, DATABASE_PATH, MCP_SERVER_PATH, MCP_DEBUG. - You want tools like
get_design_tokens, get_component_info, list_components.
Choose Icons MCP when
- You need dedicated capabilities in the Architecture & Design domain.
- You prefer a remote HTTP/SSE transport.
- You want tools like
search_icons, search_icon_sets, get_icon.
Feature & specification comparison
Rows where the two servers differ are marked.
| Spec | ||
|---|---|---|
| Category | Architecture & Design | Architecture & Design |
| Quality signal | 53/100 · Good | 55/100 · Good |
| Install command | Confirmed | Confirmed |
| Transport | Local subprocess (stdio) | Remote HTTP/SSE |
| Auth | Not declared | Not declared |
| Pricing | Not declared | Not declared |
| Required env vars | PORTAUTH_TOKENDATABASE_PATHMCP_SERVER_PATHMCP_DEBUG | None listed |
| Verified owner | Community listing | Community listing |
| GitHub stars | 4 | 0 |
| Directory activity | 0 views 0 installs 0 upvotes | 0 views 0 installs 0 upvotes |
| Tools | 19 | 12 |
| Full listing | View Mozaic | View Icons MCP |
Tools & capabilities
Mozaic tools 19
get_design_tokensQuery tokens by category (colors, typography, spacing, etc.)get_component_infoGet component props, slots, events, and documentationlist_componentsList components by category or frameworkgenerate_vue_componentGenerate Vue 3 SFC code with propsgenerate_react_componentGenerate React/TSX code with TypeScriptgenerate_webcomponentGenerate native Web Component HTML with importsget_webcomponent_infoGet attributes, slots, events, CSS propertieslist_webcomponentsList web components by categorygenerate_freemarkerGenerate Freemarker macro code with configurationget_freemarker_infoGet macro configuration options and usagelist_freemarkerList Freemarker macros by categorysearch_documentationFull-text search across 309 documentation pages- +7 more on the listing page
Icons MCP tools 12
search_iconsSearch svgicons.com icons and return icon metadata. Raw SVG requires a Pro API token with icons:read and mcp:use scopes.search_icon_setsSearch icon sets by name, prefix, author, category, or description.get_iconReturn one icon by ID. Metadata is public; raw SVG requires a Pro API token with icons:read and mcp:use scopes.export_icon_pngRender one icon as PNG or a ZIP of PNG variants. Requires the Pro Plan and an MCP token with icons:read and exports:create scopes.recommend_icons_for_uiRecommend icon candidates for a UI description using svgicons.com search metadata.create_icon_kitCreate a persistent Pro Icon Collection and optionally add icon IDs. Requires Pro API token with collections:write and mcp:use scopes.generate_icon_kit_for_projectRecommend and persist an Icon Collection for a project brief. Requires Pro API token with collections:write and mcp:use scopes.export_icon_collectionQueue a Pro Icon Collection export, including optional PNG packs. Requires an MCP token with exports:create.list_icon_collectionsList your persistent Icon Collections with icon counts. Requires a Pro API token with collections:read and mcp:use scopes.get_icon_collectionRead one Icon Collection with its paginated entries. Custom-icon entries include entryId, customEditId, customName, and their customized SVG snapshot as the body. Requires a Pro API token with collections:read and mcp:use scopes.add_icons_to_collectionAdd catalog icons to an existing Icon Collection as plain entries (idempotent). Requires a Pro API token with collections:write and mcp:use scopes.remove_icon_from_collectionRemove an icon from an Icon Collection. Entry-precise by default: only the plain entry is removed and custom variants survive; set allVariants true to remove every entry of the icon. Requires a Pro API token with collections:write and mcp:use scopes.
Ready-to-paste client configs
Paste either block (or both) into your client config, e.g. claude_desktop_config.json or ~/.cursor/mcp.json. We only show a config when the install command is confirmed.
Mozaic
{
"mcpServers": {
"mozaic": {
"command": "npx",
"args": [
"-y",
"mozaic-mcp-server@2"
],
"env": {
"PORT": "YOUR_PORT_HERE",
"AUTH_TOKEN": "YOUR_AUTH_TOKEN_HERE",
"DATABASE_PATH": "YOUR_DATABASE_PATH_HERE",
"MCP_SERVER_PATH": "YOUR_MCP_SERVER_PATH_HERE",
"MCP_DEBUG": "YOUR_MCP_DEBUG_HERE"
}
}
}
}
Icons MCP
{
"mcpServers": {
"svg-icons-mcp": {
"url": "https://svgicons.com/mcp"
}
}
}
Frequently asked questions
Mozaic is categorized under Architecture & Design and uses a local stdio subprocess. Icons MCP belongs to Architecture & Design and uses a remote HTTP/SSE transport. Pick Mozaic for architecture & design work and Icons MCP for architecture & design.
Copy the mcpServers block from the config section on this page into your client's config (for example claude_desktop_config.json or ~/.cursor/mcp.json), then fully restart the client.
Mozaic has no declared pricing — check the project's own site. Icons MCP has no declared pricing — check the project's own site. If a server needs environment variables such as API keys, define them under the env key in your client's MCP config.
Yes. MCP clients support multiple servers: add mozaic and svg-icons-mcp as separate keys in the same mcpServers object, and your assistant will call tools from either one.
On AllMCPs, Mozaic has a quality signal of 53/100 (Good) with 0 views, 0 installs and 4 GitHub stars. Icons MCP has 55/100 (Good) with 0 views, 0 installs and 0 GitHub stars.