Skip to main content
Glama

Supericons Agent Plugin

Semantische SVG-Icon-Suche für KI-Coding-Agenten.

Supericons hilft Agenten dabei, Icons nach Bedeutung zu finden, nicht nur nach Dateinamen. Verwenden Sie es, um über 20.000 kostenlose Icons zu durchsuchen, SVG-Code abzurufen und Icon-Sets für App-Navigation, Dashboards, Tools und Produkt-UI zu empfehlen.

Schnellinstallation

Verwenden Sie diese Konfiguration in jedem MCP-fähigen Coding-Agenten:

{
  "mcpServers": {
    "supericons": {
      "command": "npx",
      "args": ["-y", "supericons-mcp"]
    }
  }
}

Related MCP server: brain-mcp-icon-visual

IDE-Einrichtungsfelder

Wenn Ihre IDE ein Formular anstelle einer JSON-Datei anzeigt, geben Sie Folgendes ein:

Name: supericons
Transport: stdio
Command: npx
Arguments:
-y
supericons-mcp

Wenn Ihre IDE ein Argumentfeld hat, geben Sie Folgendes ein:

-y supericons-mcp

Lassen Sie Umgebungsvariablen für die kostenlose Icon-Suche leer.

Pro-Einrichtung

Für Premium-Icons oder Pro-Tools fügen Sie diese Umgebungsvariable hinzu:

SUPERICONS_API_KEY=your_api_key_here

Fügen Sie keine API-Schlüssel in öffentliche Issues, Screenshots oder freigegebene Konfigurationsdateien ein.

Gehosteter MCP-Endpunkt

Gehosteter Endpunkt:

https://mcp.supericons.dev/mcp

Server-Karte:

https://mcp.supericons.dev/.well-known/mcp/server-card.json

Verfügbare Tools

search_icons : Durchsuchen Sie kostenlose Icon-Bibliotheken nach Bedeutung, Bezeichnung, visueller Beschreibung, Tags und Synonymen.

recommend_icons : Empfehlen Sie Icons für UI-Bereiche wie Dashboard-Navigation, App-Tabs, Einstellungs-Panels oder Produktfunktionen.

get_icon : Rufen Sie ein SVG-Icon anhand der Icon-ID und der Bibliothek ab.

list_libraries : Listen Sie die kostenlosen Icon-Bibliotheken auf, die über Supericons MCP verfügbar sind.

Beispiel-Prompts

Use Supericons MCP to find a database icon. Prefer Lucide outline icons and show the icon id, library, and SVG.
Use Supericons MCP to recommend icons for an AI dashboard sidebar. The slots are model, prompt, dataset, evaluation, deployment, and monitoring. Prefer Lucide outline icons.

Umfang des öffentlichen Repositorys

Dieses Repository ist nur ein leichtgewichtiger Setup-Wrapper für Agenten-Verzeichnisse und IDE-Benutzer. Es enthält nicht den privaten Quellcode der Supericons-Website, die vollständige semantische Registry, interne Build-Workflows, private Daten, Dienstschlüssel oder Premium-Icon-Assets.

Available Tools

3 tools
convert_svg_to_pngBInspect

Convert an SVG string to PNG. Converter MCP is a Pro workflow tool.

ParametersJSON Schema
NameRequiredDescriptionDefault
svgYesRaw SVG string to render.
localeNoOptional locale for multilingual output. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th.
backgroundNoBackground color: `transparent` or a hex value like `#ffffff`.transparent
targetWidthNoOutput width in pixels.

TDQS

B3.3/5.0
Behavior2/5

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

No annotations are provided, so the description carries full burden. It only states the basic conversion action and does not disclose any behavioral traits like idempotency, side effects, permissions, or output characteristics.

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

Conciseness4/5

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

The description is very short with two sentences, no redundancy. However, it could be improved by adding more detail without becoming verbose. It is appropriately sized but lacks depth.

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

Completeness2/5

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

Given no annotations, no output schema, and 4 parameters with some defaults and enums, the description is too minimal. It does not explain return values, error conditions, or limitations, leaving the agent underinformed.

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 description coverage is 100%, so the schema already documents all parameters. The description adds no additional meaning beyond the schema's parameter descriptions, meeting baseline expectations.

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 'Convert an SVG string to PNG', which is specific with a verb and resource. It distinguishes from sibling tools 'inspect_converter_options' and 'preview_icons' by focusing on a direct conversion action.

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

Usage Guidelines3/5

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

The description provides no explicit guidance on when to use this tool over alternatives. The phrase 'Pro workflow tool' hints at advanced use but lacks clarity on context or exclusions.

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

inspect_converter_optionsAInspect

List the current Converter MCP options, workflow hints, and recommended starting combinations. Converter MCP is a Pro workflow tool.

ParametersJSON Schema
NameRequiredDescriptionDefault
localeNoOptional locale for multilingual output. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th.

TDQS

A3.7/5.0
Behavior3/5

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

No annotations are provided, so the description carries full burden for behavioral disclosure. It describes the tool as listing options, which suggests a read-only operation, but does not explicitly state that it is non-destructive or mention any side effects. The behavior is straightforward but not fully transparent.

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 consists of two short, front-loaded sentences. The first states the purpose, and the second adds useful context about it being a Pro workflow tool. Every sentence serves a purpose with no redundancy.

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

Completeness3/5

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

Given there is no output schema and no annotations, the description does not specify the output format (e.g., whether it returns a list or object) or how to interpret the options and workflow hints. It is adequate for a simple listing tool but lacks completeness for agents needing to parse the response.

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 has one parameter (locale) with 100% schema coverage, meaning the schema adequately describes it. The parameter description is included in the schema but not reiterated in the main description. The description adds no extra semantic meaning beyond what the schema provides, so baseline score of 3 is appropriate.

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 the verb 'List' and the specific resource 'Converter MCP options', workflow hints, and recommended starting combinations. It distinguishes from sibling tools 'preview_icons' and 'convert_svg_to_png' by focusing on inspecting configuration rather than previewing or converting.

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

Usage Guidelines3/5

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

The description implies that this tool is used to inspect options and workflow hints, but it does not explicitly state when to use it versus the siblings or provide any exclusions or prerequisites. The usage context is implied but not clarified.

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

preview_iconsAInspect

Refine an icon result set or preview known icon refs. Use search_icons first for normal icon requests. Long icon lists are accepted and safely truncated to 12. Returns a browser preview page, direct PNG image URL, ready-made Markdown image snippet, 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. Unsupported values are ignored with a warning.
libraryNoOptional library filter such as si (Supericons), mingcute, lucide, tabler, material, or simpleicons (Simple Icons).
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.

TDQS

A4.2/5.0
Behavior4/5

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

With no annotations, the description carries the full burden. It discloses truncation of lists to 12, clamping of limit, acceptance of icon_refs up to 100, and returned items. It lacks explicit read-only or auth info, but the preview nature implies no side effects.

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?

Extremely concise: two sentences front-loading purpose and usage, then listing capabilities. Every sentence adds value with no redundancy.

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

Completeness4/5

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

Without an output schema, the description sufficiently explains return types (preview page, PNG URL, Markdown snippet, contact sheet). It covers main use cases and edge cases like truncation. Could add example usage but is adequate for an agent.

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 description coverage is 100%, so baseline is 3. The description adds some behavioral context (truncation, clamping) but largely repeats schema info. No new parameter-specific meaning beyond what the schema already provides.

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 the tool refines icon result sets or previews known icon refs, using specific verbs and resources. It distinguishes from the sibling search_icons by advising to use that first for normal requests.

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?

Explicitly says 'Use search_icons first for normal icon requests,' providing a clear context for when to use this tool. However, it does not address exclusions for its sibling tools inspect_converter_options and convert_svg_to_png.

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

TDQS

A3.7/5.0
Disambiguation5/5

Each tool serves a distinct purpose: inspecting converter options, previewing icons, and converting SVG to PNG. No overlap in functionality.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern: inspect_, preview_, convert_. The naming is uniform and predictable.

Tool Count5/5

With 3 tools, the server is appropriately scoped for icon-related tasks. It covers configuration, preview, and conversion without unnecessary bloat.

Completeness2/5

The tool set is missing a search_icons tool, which is referenced in the preview_icons description as a prerequisite. This gap limits the workflow and indicates incompleteness for the domain.

Maintenance

ActivitySlowing
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    D
    maintenance
    MCP server that allows FE/UI/Designers to retrieve SVG icons via the Iconify API by simply asking LLMs rather than manually searching websites.
    3
    30
    4
    MIT
  • 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
  • F
    license
    Not graded
    quality
    C
    maintenance
    MCP server for searching Material Design Icons, enabling AI agents to find icons by name, alias, category, or concept.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/curlymolelabs/supericons'

If you have feedback or need assistance with the MCP directory API, please join our Discord server