{"name":"io.github.curlymolelabs/supericons","slug":"curlymolelabs-supericons","title":"Supericons","description":"Multilingual semantic SVG icon search with previews for AI coding agents. 20,000+ icons.","url":"https://mcp.market/server/curlymolelabs-supericons","rating":null,"grade":"A","score":88,"certified":false,"status":"active","category":"search","tags":["search"],"presence":{"score":26,"stars":1,"forks":0,"downloads_week":39,"last_push_at":"2026-08-04T17:53:24.000Z","license":"MIT"},"uptime":{"percent":100,"checks":28,"ok":28,"last_checked_at":"2026-11-04T05:45:36.261Z","last_ok_at":"2026-11-04T05:45:36.261Z","latency_ms":117},"claimed":false,"transport":"mixed","callable_via_gateway":true,"default_price_micros":0,"repository":"https://github.com/curlymolelabs/supericons","website":null,"version":"0.4.22","remotes":[{"type":"streamable-http","url":"https://mcp.supericons.dev/mcp"}],"packages":[{"registryType":"npm","identifier":"@supericons/mcp","version":"0.4.22","transport":{"type":"stdio"}}],"tools":[{"name":"get_icon","description":"Retrieve one exact SVG icon using an exact ref returned by search_icons, recommend_icons, or preview_icons. Do not guess icon IDs. Use search_icons first if the user only described a concept. Returns SVG code, explicit public library labels, visual preview URL, and public semantic guidance for the exact icon.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"id":{"type":"string","description":"Exact icon ID without the library prefix, for example \"database\", \"user-circle\", \"brain-circuit\", or \"arrow-down\"."},"library":{"type":"string","description":"Required library key for the exact icon. Supported values include si (Supericons AI and developer tool logos), lucide, tabler, phosphor, heroicons, bootstrap, iconoir, ionicons, material, simpleicons (Simple Icons brand logos), and mingcute."},"style":{"type":"string","enum":["any","outline","solid"],"default":"any","description":"Optional style preference. Material Symbols supports outline and solid. Other hosted libraries report their verified styles in list_libraries."}},"required":["id","library"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"list_libraries","description":"List the free icon libraries available through the hosted Supericons MCP server. Use this before filtering by library or when a user asks which icon libraries are supported.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{}}},{"name":"preview_icons","description":"Refine an icon result set or preview known icon refs returned by another Supericons tool. Use search_icons first for normal icon requests. Long icon lists are accepted and safely truncated to 12. Returns ready-to-use Markdown, a hosted preview fallback, a direct PNG image URL, and, when requested, an MCP image contact sheet.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"query":{"type":"string","description":"Optional search query to preview visually, for example \"license plate recognition camera scan car\"."},"icon_refs":{"type":"array","items":{"type":"string"},"minItems":1,"description":"Optional fixed icon refs in library:id format. Arrays, a single ref, and comma-separated refs are accepted. Up to 100 are accepted, 24 appear on the browser preview, and 12 are rendered inline. Larger lists are safely truncated with a warning."},"library":{"$ref":"#/properties/query","description":"Optional library key. Supported values include si (Supericons AI and developer tool logos), lucide, tabler, phosphor, heroicons, bootstrap, iconoir, ionicons, material, simpleicons (Simple Icons brand logos), and mingcute."},"style":{"$ref":"#/properties/query","default":"any","description":"Optional style preference. Unsupported values are ignored with a warning."},"locale":{"$ref":"#/properties/query","description":"Optional locale for multilingual search terms. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th. Unsupported values are ignored with a warning."},"limit":{"type":["number","string"],"default":12,"description":"Requested inline icon count. Values outside 1 to 12 are safely clamped with a warning. Numeric strings are accepted."},"include_image":{"type":"boolean","default":true,"description":"When true, include a PNG contact sheet as MCP image content. Boolean strings are accepted. A preview_url is always returned."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"recommend_icons","description":"Recommend a coherent icon set for up to 20 named UI slots in one call. Uses task context to narrow ambiguous meanings. When context is insufficient, returns needs_clarification with labeled interpretation options instead of guessing. Invalid inputs and service failures return a plain-language reason and a next step instead of a bare protocol error. Returns one recommendation and optional alternatives for each resolved slot, with explicit public library labels and visual preview URLs where available. Library key si means Supericons, not Simple Icons.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"task":{"type":"string","default":"","description":"Overall UI task, for example \"choose icons for an AI dashboard sidebar\" or \"select bottom navigation icons for a finance app\". Missing task text returns a structured recovery message."},"slots":{"type":"array","items":{"type":"string"},"default":[],"description":"List of 1 to 20 UI slots to fill, for example [\"model\", \"prompt\", \"dataset\", \"evaluation\"]. A single string is accepted as one slot. Larger lists return a structured split instruction."},"library":{"$ref":"#/properties/task","description":"Optional library key when the user wants a consistent icon family. Supported values include si (Supericons AI and developer tool logos), lucide, tabler, phosphor, heroicons, bootstrap, iconoir, ionicons, material, simpleicons (Simple Icons brand logos), and mingcute."},"style":{"$ref":"#/properties/task","default":"any","description":"Optional style preference. Unsupported values are ignored with a warning."},"locale":{"$ref":"#/properties/task","description":"Optional locale for multilingual slot labels. Unsupported values are ignored with a warning."},"limit_per_slot":{"type":["number","string"],"default":3,"description":"Number of choices per slot. Values outside 1 to 5 are clamped with a warning. Numeric strings are accepted."},"response_mode":{"$ref":"#/properties/task","default":"plan","description":"Response size mode: plan, assets, or full. Unsupported values use plan with a warning."},"include_query_frame":{"type":"boolean","default":false,"description":"Optional public-safe diagnostics for query understanding. Boolean strings are accepted. Leave false for normal compact responses."}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"search_icons","description":"Use this as the main icon tool. Search 20,000+ curated SVG icons across 11 libraries by meaning, label, visual description, tags, and synonyms. When matches exist, the response includes a paste-ready suggested answer, a direct preview image, and Markdown that can show the image in the final reply. When no supported match exists, it returns an honest structured no-result with a next step and no fabricated icon. If you choose a library yourself, use prefer. Use strict only when the user explicitly requires that library. Library key si means Supericons, not Simple Icons.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"description":"Icon concept or search phrase, for example \"database\", \"user profile\", \"chill\", \"trash\", \"upload cloud\", \"AI model\", or \"beautiful\"."},"library":{"type":"string","description":"Optional library key only when the user named a library. Omit it to search all libraries. Do not use all as a library key. Supported values include si (Supericons AI and developer tool logos), lucide, tabler, phosphor, heroicons, bootstrap, iconoir, ionicons, material, simpleicons (Simple Icons brand logos), and mingcute."},"library_mode":{"$ref":"#/properties/library","description":"Optional library behavior. Omit a self-chosen library and search all, or use prefer with that library. Use strict only when the user explicitly requires the named library. All searches every eligible library. Unsupported or incomplete combinations are safely normalized with a warning."},"style":{"$ref":"#/properties/library","default":"any","description":"Optional style preference. Unsupported values are ignored with a warning."},"locale":{"$ref":"#/properties/library","description":"Optional locale for multilingual search terms. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th. Unsupported values are ignored with a warning."},"limit":{"type":"number","minimum":1,"maximum":50,"default":10,"description":"Maximum number of icons from 1 to 50. Numeric strings are accepted."},"include_query_frame":{"type":"boolean","default":false,"description":"Optional public-safe diagnostics for query understanding. Boolean strings are accepted. Leave false for normal compact responses."}},"required":["query"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}],"scan":{"score":88,"grade":"A","scanned_at":"2026-09-24T21:40:38.478Z","report":{"scannerVersion":"0.1.9","scannedAt":"2026-09-24T21:40:38.478Z","components":{"code":{"score":25,"max":25,"notes":["51 source files scanned"]},"reliability":{"score":20,"max":20,"notes":["remote reachable in 455ms"]},"poisoning":{"score":15,"max":15,"notes":["5 tool descriptions checked"]},"auth":{"score":10,"max":15,"notes":["open endpoint, read-only tools"]},"maintenance":{"score":12,"max":15,"notes":["last push 51 days ago"]},"identity":{"score":6,"max":10,"notes":["registry namespace matches repository owner"]}},"findings":[],"inputs":{"probes":[{"url":"https://mcp.supericons.dev/mcp","reachable":true,"authRequired":false,"latencyMs":455,"serverInfo":{"name":"supericons","version":"0.4.37"}}],"packages":[{"registryType":"npm","identifier":"@supericons/mcp","version":"0.4.22","found":true,"license":"SEE LICENSE IN LICENSE","hasInstallScripts":false,"dependencyCount":7,"publishedAt":"2026-07-23T09:58:34.907Z","repositoryUrl":"git+https://github.com/curlymolelabs/supericons.git","weeklyDownloads":39}],"repo":{"found":true,"owner":"curlymolelabs","repo":"supericons","archived":false,"pushedAt":"2026-08-04T17:53:24Z","stars":1,"forks":0,"openIssues":0,"ownerType":"User","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/267614984?v=4","ownerCreatedAt":"2026-03-12T09:58:28Z","license":"MIT"},"icon":{"url":"https://avatars.githubusercontent.com/u/267614984?v=4&s=128","source":"github"},"presence":{"stars":1,"forks":0,"downloadsWeek":39,"license":"MIT","lastPushAt":"2026-08-04T17:53:24.000Z","score":26}}}},"grade_history":[],"reviews":[]}