Skip to main content
Glama

Server Details

Multilingual semantic SVG icon search with previews for AI coding agents. 20,000+ icons.

If you are the author of this connector, you can claim ownership with GitHub, an HTTP challenge, or a DNS record. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Last Tested
Transport
Streamable HTTP
URL
Repository
curlymolelabs/supericons
GitHub Stars
1
Server Listing
Supericons

Available Tools

5 tools
get_iconGet IconAInspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
idYesExact icon ID without the library prefix, for example "database", "user-circle", "brain-circuit", or "arrow-down".
styleNoOptional style preference. Material Symbols supports outline and solid. Other hosted libraries report their verified styles in list_libraries.any
libraryYesRequired 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.

Output Schema

ParametersJSON Schema
NameRequiredDescription
codeNoStable error code when the exact icon is unavailable.
hintNoPlain-language explanation of how to recover.
iconNoExact matching icon when found.
errorNoRecoverable error message when no exact icon is found.
next_stepNoRecommended next tool action.
retryableNoWhether repeating the same exact lookup may succeed.

TDQS

A3.9/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations set readOnlyHint to false, while the description describes 'Retrieve', implying a read-only operation. This is a direct annotation contradiction. No behavioral traits beyond the return value are disclosed, but the contradiction forces a score of 1.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is three sentences, front-loaded with the primary purpose. Each sentence earns its place: the main action, a usage warning, and the return value. No wasted or redundant words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description covers purpose, usage constraints (don't guess, use search_icons for concepts), and return value contents (SVG code, labels, preview URL, semantic guidance). An output schema exists, but the description adds valuable context without being bloated. Complete for a retrieval tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema provides 100% parameter descriptions, establishing a baseline of 3. The description adds context that the id must be an exact ref from specific tools, but this is more usage guidance than parameter semantics. No additional syntax or format details are provided beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states 'Retrieve one exact SVG icon using an exact ref' with a specific verb and resource. It distinguishes from sibling tools by emphasizing 'exact' and requiring a ref from search_icons, recommend_icons, or preview_icons, contrasting with search and preview functions.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Description explicitly instructs users to not guess icon IDs and to use search_icons first when the user only described a concept. This provides clear when-to-use guidance and an alternative tool recommendation.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

list_librariesList LibrariesA
Read-onlyIdempotent
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Output Schema

ParametersJSON Schema
NameRequiredDescription
librariesYesFree icon libraries available through this hosted MCP server.
publicRecordCountYesNumber of public semantic icon records searchable through the hosted MCP server.

TDQS

A4.3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, idempotentHint=true, and destructiveHint=false. The description adds the 'free' scope and hosted-server context, but discloses no additional behaviors like pagination or rate limits. This is sufficient for a simple list operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two concise sentences: the first states the purpose clearly, the second gives a usage tip. No filler or redundant information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given zero parameters, rich annotations, and the presence of an output schema, the description fully covers what an agent needs to select and invoke the tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There are zero parameters, so the baseline is 4. The description adds relevant context about the list's content ('free icon libraries') without needing to describe any parameter syntax.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb 'list' with a clear resource 'free icon libraries' and context ('hosted Supericons MCP server'). It distinguishes from sibling tools that operate on individual icons, making the tool's purpose unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It explicitly advises use before filtering by library and when users ask about supported libraries. This provides clear context, though it does not name alternative tools directly or specify when not to use it.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

preview_iconsPreview IconsA
Read-onlyIdempotent
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoRequested inline icon count. Values outside 1 to 12 are safely clamped with a warning. Numeric strings are accepted.
queryNoOptional search query to preview visually, for example "license plate recognition camera scan car".
styleNoOptional style preference. Unsupported values are ignored with a warning.any
localeNoOptional 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.
libraryNoOptional 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.
icon_refsNoOptional 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.
include_imageNoWhen true, include a PNG contact sheet as MCP image content. Boolean strings are accepted. A preview_url is always returned.

Output Schema

ParametersJSON Schema
NameRequiredDescription
errorNoRecoverable error message when preview inputs are missing or invalid.
queryNoSearch query used for the visual preview, if any.
resultsYesIcons included in the visual preview.
warningsNoUnsupported optional inputs that were safely ignored.
image_urlNoDirect PNG URL for clients or Markdown renderers that can show remote images.
next_stepYesUseful next action for the caller.
preview_urlYesBrowser URL for visual inspection.
image_includedYesWhether this response includes MCP image content.
markdown_imageNoReady-made Markdown image snippet for final answers in clients that render remote Markdown images.
rendered_countYesNumber of icons rendered in the inline preview.
truncated_fromNoOriginal icon ref count when the input was truncated.
client_display_noteYesPlain-language note for clients that do not render images inline.
browser_preview_countYesNumber of accepted icon refs available at preview_url.
suggested_response_markdownNoReady-to-use answer with the image, refs, and browser fallback link.

TDQS

A4.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond read-only/idempotent annotations, the description discloses truncation behavior for long icon lists and outlines the return format (Markdown, hosted preview, PNG URL, optional MCP contact sheet), adding useful behavioral context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences front-load purpose, provide usage guidance, and summarize outputs without unnecessary fluff.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With a rich schema and output schema, the description covers purpose, alternatives, and key behaviors, making it complete for an agent to select and invoke correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% with descriptive parameter details, so the description does not need to explain parameters. It adds a small amount of context by referencing icon_refs, but the schema already covers semantics.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states a specific action ('Refine an icon result set or preview known icon refs') and resource ('icon refs returned by another Supericons tool'), distinguishing it from search_icons which is the primary request tool.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly instructs to use search_icons first for normal icon requests, positioning this tool as a refinement/preview step. Also implies it works with refs from other Supericons tools, providing clear when-to-use context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

recommend_iconsRecommend IconsAInspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
taskNoOverall 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.
slotsNoList 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.
styleNoOptional style preference. Unsupported values are ignored with a warning.any
localeNoOptional locale for multilingual slot labels. Unsupported values are ignored with a warning.
libraryNoOptional 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.
response_modeNoResponse size mode: plan, assets, or full. Unsupported values use plan with a warning.plan
limit_per_slotNoNumber of choices per slot. Values outside 1 to 5 are clamped with a warning. Numeric strings are accepted.
include_query_frameNoOptional public-safe diagnostics for query understanding. Boolean strings are accepted. Leave false for normal compact responses.

Output Schema

ParametersJSON Schema
NameRequiredDescription
codeNoStable error code for programmatic recovery.
hintNoPlain-language recovery instruction.
taskYesOriginal UI task.
errorNoPlain-language reason the recommendation did not complete.
styleNoStyle preference used for recommendations.
statusNoHTTP status from a hosted dependency failure.
detailsNoStructured limits or failure details.
libraryNoLibrary filter used for recommendations, if provided.
resultsYesRecommended icon choices grouped by requested UI slot.
warningsNoUnsupported optional inputs that were safely ignored or clamped.
next_stepNoUseful next action for the caller.
retryableNoWhether a corrected or later request may succeed.
slot_countYesNumber of UI slots requested.
preview_urlNoBrowser URL for visual inspection of the recommended icon set.
query_frameNoOptional public-safe query understanding diagnostics for the task.
response_modeYesResponse size mode used for this recommendation.
search_runtimeNoSearch execution path used for this recommendation.
all_slots_resolvedYesWhether every requested slot received a recommendation without clarification.
clarification_slotsYesSlots that need the caller to choose an interpretation.
needs_clarificationYesWhether one or more ambiguous slots require more context.
retry_after_secondsNoSeconds to wait before retrying a rate-limited recommendation.
fallback_recommendedYesWhether the caller should consider direct search or clarification.
low_confidence_slotsYesSlots whose result is missing or has low confidence.
suggested_response_markdownNoPlain-language explanation suitable for the agent response.

TDQS

A4.7/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With all annotations false, the description carries the full burden and does so thoroughly. It states behavior for insufficient context ('returns needs_clarification with labeled interpretation options instead of guessing'), error handling ('plain-language reason and a next step'), and a specific disambiguation ('Library key si means Supericons, not Simple Icons'). This goes beyond annotations and adds significant behavioral insights.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is five sentences, each carrying essential information without fluff. It front-loads the primary action, then covers edge cases, return values, and a key library clarification. No sentence is wasted, making it dense yet structured.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (8 parameters, no required params), the description is remarkably complete. It covers return behavior, error handling, clarification requests, and a library naming caveat. An output schema exists, so it does not need to explain return structure. The description addresses both typical and edge-case usage.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3. The description adds extra meaning beyond schema by noting the slot limit ('up to 20 named UI slots'), clarifying the 'si' library key, and mentioning response modes and alternatives. This added context raises it above the baseline.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource: 'Recommend a coherent icon set for up to 20 named UI slots in one call.' This clearly differentiates from sibling tools like search_icons or get_icon by emphasizing the 'coherent set' and 'up to 20 named UI slots' scope.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage context: use when you need multiple cohesive icon recommendations in one call. However, it does not explicitly mention alternatives or exclusion criteria, though the sibling list in context signals provides some differentiation. The phrase 'coherent icon set' and 'up to 20 named UI slots' effectively frames its intended use.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

search_iconsSearch IconsAInspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoMaximum number of icons from 1 to 50. Numeric strings are accepted.
queryYesIcon concept or search phrase, for example "database", "user profile", "chill", "trash", "upload cloud", "AI model", or "beautiful".
styleNoOptional style preference. Unsupported values are ignored with a warning.any
localeNoOptional 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.
libraryNoOptional 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_modeNoOptional 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.
include_query_frameNoOptional public-safe diagnostics for query understanding. Boolean strings are accepted. Leave false for normal compact responses.

Output Schema

ParametersJSON Schema
NameRequiredDescription
codeNoStable code for a structured no-result.
hintNoPlain-language recovery hint for a structured no-result.
errorNoPlain-language error for a structured no-result.
statusNoHTTP status from an upstream search failure.
detailsNoStructured rate-limit or upstream failure details.
resultsYesMatching icons with SVG code and semantic guidance.
warningsNoUnsupported optional inputs that were safely ignored.
image_urlNoDirect PNG URL when usable icons exist.
next_stepYesUseful next action for the caller.
retryableNoWhether changing the query or filters may produce a result.
limit_scopeNoAllowance scope reported by a rate limit.
preview_urlNoBrowser URL for visual inspection of this search result set.
query_frameNoOptional public-safe query understanding diagnostics.
library_modeYesLibrary behavior used for this search.
outcome_typeNoWhether this response contains results, an honest no-match, or a tool failure.
result_countNoNumber of verified icons returned by this search.
markdown_imageNoReady-made Markdown image when usable icons exist.
search_runtimeNoSearch execution path used for this request.
top_result_refNoTop ordered icon ref when results exist.
requested_libraryYesPreferred or required library, when supplied.
retry_after_secondsNoSeconds to wait before retrying a rate-limited search.
result_interpretationNoPlain-language guidance for interpreting this result count and outcome.
suggested_response_markdownYesCompact answer that accurately reflects this response.

TDQS

A4.7/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations are all false, so the description carries the full behavioral burden. It thoroughly discloses match behavior (paste-ready answer, direct preview image, Markdown), no-match behavior (honest structured no-result with next step, no fabricated icon), and library-mode semantics. The si/Supericons disambiguation also prevents a likely misuse. This exceeds the minimum expected transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Every sentence earns its place: the primary-role statement, search capability, match/no-match response behavior, library-mode guidance, and the si/Supericons warning. It is front-loaded with the most important usage directive and remains compact for a tool with 7 parameters.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The description is complete for correct invocation: it covers query style, result behavior, failure handling, library selection, and a known naming trap. The output schema exists, so detailed return-value documentation is already available to the agent. No critical operational context is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3. The description adds meaningful guidance beyond the schema by explaining the prefer/strict library_mode behavior, the condition for strict usage, and the si key ambiguity. This additional context raises the score.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description opens with 'Use this as the main icon tool' and names a specific action and resource: searching 20,000+ curated SVG icons across 11 libraries by meaning, labels, visual description, tags, and synonyms. It clearly establishes this as the primary search tool and distinguishes it from siblings like get_icon and list_libraries.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives explicit guidance on when to use this tool ('main icon tool') and how to choose library modes: 'If you choose a library yourself, use prefer' and 'Use strict only when the user explicitly requires that library.' It does not explicitly compare against sibling tools, but the primary-tool framing and mode rules provide clear usable context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Frequently Asked Questions

Discussions

No comments yet. Be the first to start the discussion!

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Visual 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
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables 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
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI agents and humans to resolve, search, and retrieve deterministic, policy-compliant SVG icons from the IconPark library, with explicit ambiguity handling and visual decision support.
    Apache 2.0
  • A
    license
    A
    quality
    D
    maintenance
    A Model Context Protocol (MCP) server for semantic SVG icon search. Generate infographic SVG icons by keyword — over 100,000 icons with semantic search support.
    1
    20
    MIT
Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

A4.4/5.0
Disambiguation5/5

Each tool targets a distinct stage of the icon workflow: list_libraries for discovery, search_icons for concept search, recommend_icons for UI slot sets, preview_icons for refining/previewing results, and get_icon for exact retrieval. The descriptions explicitly state when to use each tool, so there is little risk of misselection.

Naming Consistency5/5

All tool names follow a consistent lowercase snake_case verb_noun pattern: list, search, preview, recommend, get. The object nouns are plural for set-level operations and singular for exact retrieval, which is predictable and clear.

Tool Count5/5

Five tools is well-scoped for an icon retrieval server. Each tool serves a necessary and non-redundant function, and the set is neither bloated nor too thin.

Completeness5/5

The tool surface covers the full icon workflow: library discovery, semantic search, preview/refinement, exact SVG retrieval, and multi-slot recommendation. No-result and insufficient-context cases are handled with next steps, so there are no obvious dead ends for the stated domain.