@supericons/mcp 0.4.8 → 0.4.10

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.4.10 - 2026-06-27
+
+### Added
+
+- added Supericons (`si`) library discovery for hosted and stdio MCP clients
+- added hosted search support for Supericons AI and developer tool logo queries
+
+### Changed
+
+- updated packaged product facts to reflect 21,367 free icons across 11 libraries
+- sends the public Supabase key header when calling the public MCP search gateway
+
 ## 0.4.5 - 2026-05-14
 
 ### Fixed

package/generated/motion-lab-baseline.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "generated_at": "2026-05-21T16:35:51.493Z",
+  "generated_at": "2026-06-27T17:17:55.388Z",
   "presets": [
     {
       "preset": "bounce",

package/hosted-search-client.js

@@ -51,6 +51,18 @@ function hasSearchResults(payload) {
   return Array.isArray(payload?.results) && payload.results.length > 0;
 }
 
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+function getRetryDelayMs(response, attempt) {
+  const retryAfter = Number(response.headers.get('retry-after'));
+  if (Number.isFinite(retryAfter) && retryAfter > 0) {
+    return Math.min(retryAfter * 1000, 5000);
+  }
+  return Math.min(500 * 2 ** attempt, 2500);
+}
+
 function buildLocalizedRetryQueries(query, locale) {
   if (!locale || multilingualExpansionTerms.length === 0) return [];
 
@@ -73,31 +85,45 @@ function buildLocalizedRetryQueries(query, locale) {
 }
 
 async function postHostedSearch(url, headers, body) {
-  const response = await fetch(url, {
-    method: 'POST',
-    headers,
-    body: JSON.stringify(body),
-  });
+  let lastStatus = 0;
+  for (let attempt = 0; attempt < 3; attempt += 1) {
+    const response = await fetch(url, {
+      method: 'POST',
+      headers,
+      body: JSON.stringify(body),
+    });
 
-  if (!response.ok) {
-    throw new Error(`hosted MCP search failed (${response.status})`);
+    if (response.ok) {
+      return response.json();
+    }
+
+    lastStatus = response.status;
+    if (response.status !== 429 && response.status < 500) break;
+    await sleep(getRetryDelayMs(response, attempt));
   }
 
-  return response.json();
+  throw new Error(`hosted MCP search failed (${lastStatus})`);
 }
 
 async function postPublicSearch(url, headers, body) {
-  const response = await fetch(url, {
-    method: 'POST',
-    headers,
-    body: JSON.stringify(body),
-  });
+  let lastStatus = 0;
+  for (let attempt = 0; attempt < 3; attempt += 1) {
+    const response = await fetch(url, {
+      method: 'POST',
+      headers,
+      body: JSON.stringify(body),
+    });
+
+    if (response.ok) {
+      return response.json();
+    }
 
-  if (!response.ok) {
-    throw new Error(`public MCP search failed (${response.status})`);
+    lastStatus = response.status;
+    if (response.status !== 429 && response.status < 500) break;
+    await sleep(getRetryDelayMs(response, attempt));
   }
 
-  return response.json();
+  throw new Error(`public MCP search failed (${lastStatus})`);
 }
 
 async function retryLocalizedHostedSearch({ postSearch, url, headers, body, locale }) {
@@ -117,6 +143,16 @@ async function retryLocalizedHostedSearch({ postSearch, url, headers, body, loca
   return null;
 }
 
+function getPublicGatewayAnonKey() {
+  return (
+    process.env.SUPERICONS_MCP_SEARCH_ANON_KEY
+    || process.env.SUPERICONS_SEARCH_ENGINE_ANON_KEY
+    || process.env.SUPABASE_ANON_KEY
+    || process.env.SUPERICONS_SUPABASE_ANON
+    || SUPABASE_ANON
+  );
+}
+
 export async function searchIconsHostedMcp({
   query,
   library = null,
@@ -168,14 +204,19 @@ export async function searchIconsHostedMcp({
     }) || payload;
   }
 
-  const headers = {
-    'Content-Type': 'application/json',
-  };
-
-  if (apiKey) {
-    headers['x-supericons-api-key'] = apiKey;
-  }
-
+  const publicAnonKey = getPublicGatewayAnonKey();
+  const headers = {
+    'Content-Type': 'application/json',
+    apikey: publicAnonKey,
+  };
+
+  if (apiKey) {
+    headers['x-supericons-api-key'] = apiKey;
+  }
+  if (looksLikeJwt(publicAnonKey)) {
+    headers.Authorization = `Bearer ${publicAnonKey}`;
+  }
+
   const url = getPublicGatewayUrl();
   const body = {
     query,

package/index.js

@@ -699,18 +699,19 @@ async function searchAccessibleIcons({ query, library, limit, style = VARIANT_ST
 // ============================================================
 // Library Metadata
 // ============================================================
-const libraryMeta = {
-  material: { name: 'Material Symbols', description: 'Google Material Symbols with 4-axis variable font support', hasStroke: false, hasFilled: true, count: 4205, outlineCount: 4205, solidCount: 4205 },
-  lucide: { name: 'Lucide', description: 'Beautiful, consistent open-source icons', hasStroke: true, hasFilled: false, count: 1951, outlineCount: 1951, solidCount: 0 },
-  tabler: { name: 'Tabler', description: 'Over 5,000 free MIT-licensed SVG icons', hasStroke: true, hasFilled: true, count: 5021, outlineCount: 5021, solidCount: 1053 },
+const libraryMeta = {
+  material: { name: 'Material Symbols', description: 'Google Material Symbols with 4-axis variable font support', hasStroke: false, hasFilled: true, count: 4205, outlineCount: 4205, solidCount: 4205 },
+  lucide: { name: 'Lucide', description: 'Beautiful, consistent open-source icons', hasStroke: true, hasFilled: false, count: 1951, outlineCount: 1951, solidCount: 0 },
+  tabler: { name: 'Tabler', description: 'Over 5,000 free MIT-licensed SVG icons', hasStroke: true, hasFilled: true, count: 5021, outlineCount: 5021, solidCount: 1053 },
   phosphor: { name: 'Phosphor', description: 'Flexible icon family for interfaces and beyond', hasStroke: false, hasFilled: true, count: 1512, outlineCount: 1512, solidCount: 1512 },
   heroicons: { name: 'Heroicons', description: 'Beautiful hand-crafted SVG icons by Tailwind CSS', hasStroke: true, hasFilled: true, count: 324, outlineCount: 324, solidCount: 324 },
   bootstrap: { name: 'Bootstrap', description: 'Official open-source SVG icon library for Bootstrap', hasStroke: false, hasFilled: true, count: 1373, outlineCount: 1373, solidCount: 705 },
   iconoir: { name: 'Iconoir', description: 'High-quality open-source icon library', hasStroke: true, hasFilled: true, count: 1383, outlineCount: 1383, solidCount: 288 },
-  ionicons: { name: 'Ionicons', description: 'Premium open-source icons for Ionic Framework', hasStroke: true, hasFilled: true, count: 421, outlineCount: 421, solidCount: 515 },
-  simpleicons: { name: 'Simple Icons', description: '3,400+ SVG icons for popular brands', hasStroke: false, hasFilled: false, count: 3412, outlineCount: 3412, solidCount: 0 },
-  mingcute: { name: 'MingCute', description: 'Modern open-source icon set with broad interface coverage', hasStroke: false, hasFilled: true, count: 1662, outlineCount: 1662, solidCount: 1662 },
-};
+  ionicons: { name: 'Ionicons', description: 'Premium open-source icons for Ionic Framework', hasStroke: true, hasFilled: true, count: 421, outlineCount: 421, solidCount: 515 },
+  simpleicons: { name: 'Simple Icons', description: '3,400+ SVG icons for popular brands', hasStroke: false, hasFilled: false, count: 3412, outlineCount: 3412, solidCount: 0 },
+  mingcute: { name: 'MingCute', description: 'Modern open-source icon set with broad interface coverage', hasStroke: false, hasFilled: true, count: 1662, outlineCount: 1662, solidCount: 1662 },
+  si: { name: 'Supericons', description: 'First-party AI and developer tool logos curated for agentic app builders', hasStroke: false, hasFilled: false, count: 50, outlineCount: 50, solidCount: 0 },
+};
 
 // Add premium pack libraries
 const packDirNames = existsSync(packsDir)
@@ -759,10 +760,10 @@ const server = new McpServer({
 // --- Tool: search_icons ---
 server.tool(
   'search_icons',
-  `Search ${freeIconCountLabel} using AI-powered synonym expansion. Returns matching free icons with SVG code and SI semantic guidance when available. Pro API keys unlock workflow tools; premium pack icon search is not exposed through MCP yet.`,
+  `Search ${freeIconCountLabel} using AI-powered synonym expansion. Returns matching free icons with SVG code and SI semantic guidance when available, including Supericons AI and developer tool logos. Pro API keys unlock workflow tools; premium pack icon search is not exposed through MCP yet.`,
   {
     query: z.string().describe('Search term (e.g. "heart", "login", "download arrow")'),
-    library: z.string().optional().describe('Filter by free library: lucide, tabler, phosphor, heroicons, bootstrap, iconoir, ionicons, material, simpleicons, or mingcute'),
+    library: z.string().optional().describe('Filter by free library: si, lucide, tabler, phosphor, heroicons, bootstrap, iconoir, ionicons, material, simpleicons, or mingcute'),
     style: z.enum(['any', 'outline', 'solid']).optional().default('any').describe('Optional style preference. Use `solid` only for libraries that ship fill or solid variants.'),
     locale: z.enum(['zh-Hans', 'zh-Hant', 'ja', 'ko', 'es', 'de', 'pt', 'ar', 'hi', 'vi', 'th']).optional().describe('Optional locale for multilingual search terms. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th.'),
     limit: z.number().min(1).max(50).optional().default(10).describe('Max results (1-50, default 10)'),
@@ -834,12 +835,12 @@ server.tool(
 );
 
 // --- Tool: recommend_icons ---
-server.tool(
-  'recommend_icons',
-  'Recommend the most suitable icons for one or more UI slots. Returns shortlist choices with preview-ready SVGs, short reasons, and SI semantic guidance when available.',
-  {
-    task: z.string().describe('Overall UI task, for example "replace the 4 bottom navigation icons" or "choose icons for a settings panel".'),
-    library: z.string().optional().describe('Optional library filter such as mingcute, lucide, tabler, material, or simpleicons.'),
+server.tool(
+  'recommend_icons',
+  'Recommend the most suitable icons for one or more UI slots. Returns shortlist choices with preview-ready SVGs, short reasons, and SI semantic guidance when available.',
+  {
+    task: z.string().describe('Overall UI task, for example "replace the 4 bottom navigation icons" or "choose icons for a settings panel".'),
+    library: z.string().optional().describe('Optional library filter such as si, mingcute, lucide, tabler, material, or simpleicons.'),
     style: z.enum(['any', 'outline', 'solid']).optional().default('any').describe('Optional style preference. Use `solid` to prefer filled variants where they exist.'),
     locale: z.enum(['zh-Hans', 'zh-Hant', 'ja', 'ko', 'es', 'de', 'pt', 'ar', 'hi', 'vi', 'th']).optional().describe('Optional locale for multilingual slot labels. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th.'),
     slots: z.array(z.string().min(1)).min(1).max(12).describe('List of UI slots to fill, for example ["Home tab", "Create action", "Alerts tab", "Profile tab"].'),
@@ -882,7 +883,7 @@ server.tool(
   'Retrieve a specific free icon by its ID and library. Returns the full SVG code, metadata, and SI semantic guidance when available. Premium pack icon retrieval is not exposed through MCP yet.',
   {
     id: z.string().describe('Icon ID (e.g. "heart", "arrow-right", "settings")'),
-    library: z.string().describe('Free library name (e.g. "lucide", "tabler", "phosphor", "iconoir", or "mingcute")'),
+    library: z.string().describe('Free library name (e.g. "si", "lucide", "tabler", "phosphor", "iconoir", or "mingcute")'),
     style: z.enum(['any', 'outline', 'solid']).optional().default('any').describe('Optional style preference. Use `solid` to request a filled variant when the library supports it.'),
   },
   async ({ id, library, style }) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supericons/mcp",
-  "version": "0.4.8",
+  "version": "0.4.10",
   "mcpName": "io.github.curlymolelabs/supericons",
   "description": "MCP server for Supericons: multilingual semantic SVG icon search and recommendations for AI coding agents.",
   "type": "module",
@@ -36,8 +36,9 @@
     "runtime/converter-workflow.js",
     "runtime/cjk-search-core.js",
     "runtime/generated-search-intent-rules.js",
-    "runtime/icon-semantic-aliases.js",
-    "runtime/icon-taxonomy-seed.js",
+    "runtime/icon-semantic-aliases.js",
+    "runtime/supericons-ai-taxonomy.js",
+    "runtime/icon-taxonomy-seed.js",
     "runtime/public-metadata-sanitizer.js",
     "runtime/search-intent-core.js",
     "search.js",

package/public/product-facts.json

@@ -1,19 +1,19 @@
 {
-  "generatedAt": "2026-05-15T19:37:45.780Z",
-  "freeIconCount": 21264,
-  "freeLibraryCount": 10,
+  "generatedAt": "2026-06-27T16:34:16.739Z",
+  "freeIconCount": 21367,
+  "freeLibraryCount": 11,
   "premiumCollectionCount": 8,
   "premiumIconCount": 400,
   "mcpToolCount": 13,
   "mcpFreeToolCount": 3,
-  "mcpPackageVersion": "0.4.7",
+  "mcpPackageVersion": "0.4.10",
   "display": {
     "freeIconsRounded": "20,000+",
     "freeIconsLabel": "20,000+ curated SVG icons",
-    "freeIconsAcrossLibrariesLabel": "20,000+ icons across 10 libraries",
-    "freeIconsAcrossLibrariesFreeLabel": "20,000+ curated SVG icons across 10 libraries",
-    "freeSvgIconsAcrossLibrariesLabel": "20,000+ free SVG icons from 10 libraries",
-    "openSourceSvgIconsAcrossLibrariesLabel": "20,000+ open-source SVG icons from 10 libraries",
+    "freeIconsAcrossLibrariesLabel": "20,000+ icons across 11 libraries",
+    "freeIconsAcrossLibrariesFreeLabel": "20,000+ curated SVG icons across 11 libraries",
+    "freeSvgIconsAcrossLibrariesLabel": "20,000+ free SVG icons from 11 libraries",
+    "openSourceSvgIconsAcrossLibrariesLabel": "20,000+ open-source SVG icons from 11 libraries",
     "freeIconLibraryLabel": "20,000+ icon library",
     "freeResultsLabel": "20,000+ results",
     "searchPlaceholderLabel": "Search 20,000+ icons...",