{
  "markdown": "# Supericons v2.0\n\nSemantic SVG icon search, previews, and recommendations for AI coding agents.\n\nSupericons helps agents find icons by meaning, not only by file name. It searches 20,000+ free icons across 11 libraries and can return SVG code or a visual comparison.\n\n## Release versions\n\nSupericons uses separate versions for the product plugin and its MCP runtime:\n\n| Component | Current release |\n| --- | --- |\n| Supericons plugin | `2.0.0` |\n| npm MCP runtime | `@supericons/mcp@0.4.22` |\n| Hosted MCP runtime | `0.4.22` |\n\nThe v2.0 plugin uses the current MCP runtime. There is no npm package named `@supericons/mcp@2.0.0`.\n\n## Quick start\n\nFor clients that support remote MCP servers, use the hosted endpoint:\n\n```text\nhttps://mcp.supericons.dev/mcp\n```\n\nFor clients that use local MCP commands, use:\n\n```json\n{\n  \"mcpServers\": {\n    \"supericons\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@supericons/mcp@latest\"]\n    }\n  }\n}\n```\n\nThe free tools do not need a Supericons API key.\n\n## Plugin files\n\nThis repository includes public plugin manifests for Codex, Claude Code, and compatible agent directories:\n\n```text\n.plugin/plugin.json\n.codex-plugin/plugin.json\n.claude-plugin/plugin.json\n.agents/plugins/marketplace.json\n```\n\nThe Codex plugin also uses:\n\n```text\n.codex-mcp.json\nskills/supericons-icon-search/SKILL.md\n```\n\n## Manual setup fields\n\nIf your client shows a form instead of a config file, enter:\n\n```text\nName: supericons\nTransport: stdio\nCommand: npx\nArguments:\n-y\n@supericons/mcp@latest\n```\n\nIf it has one argument field, enter:\n\n```text\n-y @supericons/mcp@latest\n```\n\n## Hosted tools\n\n`search_icons`\n: Search by meaning, label, visual description, tags, synonyms, and supported multilingual terms.\n\n`recommend_icons`\n: Recommend a consistent icon set for up to 20 named UI slots.\n\n`get_icon`\n: Retrieve one exact SVG icon when its icon ID and library are known.\n\n`preview_icons`\n: Compare search results or known icon references on a hosted preview page or image.\n\n`list_libraries`\n: List the 11 free icon libraries available through the hosted server.\n\n## Example prompts\n\n```text\nUse Supericons to find a Lucide database icon. Show the icon id, library, and SVG.\n```\n\n```text\nUse Supericons to recommend icons for an AI dashboard sidebar: model, prompt, dataset, evaluation, deployment, and monitoring. Prefer Lucide outline icons.\n```\n\n```text\nUse Supericons to preview the strongest camera scan icons so I can compare them visually.\n```\n\n## Pro setup\n\nFor Pro access, add the API key as an environment variable:\n\n```text\nSUPERICONS_API_KEY=<YOUR_SUPERICONS_API_KEY>\n```\n\nNever paste an API key into a public issue, screenshot, committed config file, or shared chat.\n\n## Links\n\n- Website: https://supericons.dev\n- MCP setup: https://supericons.dev/mcp/\n- npm package: https://www.npmjs.com/package/@supericons/mcp\n- Hosted MCP: https://mcp.supericons.dev/mcp\n- Server card: https://mcp.supericons.dev/.well-known/mcp/server-card.json\n\n## Public repository scope\n\nThis repository is the public setup and directory wrapper for Supericons. It contains public manifests, install examples, support information, and brand assets. Private product code, credentials, customer data, and internal operating data are not part of this repository.\n",
  "bytes": 3265,
  "sha": "7d2ebf109a2872887f7963055a9b36b61cb5642780e4c7c69aab457b24d9c494",
  "repo_slug": "curlymolelabs/supericons",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_curlymolelabs_supericons_supericons_42f21606/readme"
}