nuxt__ui/docs/server/mcp/tools/search-icons.ts

import { z } from 'zod'

export default defineMcpTool({
  description: 'Search for icons across Iconify collections. Returns matching icon names in the `i-{prefix}-{name}` format used by Nuxt UI. Default collection is `lucide`.',
  annotations: {
    readOnlyHint: true,
    destructiveHint: false,
    idempotentHint: true,
    openWorldHint: true
  },
  inputSchema: {
    query: z.string().describe('Search query (e.g., "arrow", "home", "settings")'),
    collection: z.string().default('lucide').describe('Icon collection to search within (e.g., "lucide", "heroicons", "mdi"). Defaults to "lucide".'),
    limit: z.number().min(1).max(999).optional().describe('Maximum number of results (default: 64)')
  },
  inputExamples: [
    { query: 'home' },
    { query: 'arrow', collection: 'heroicons' },
    { query: 'chart', collection: 'lucide', limit: 10 }
  ],
  cache: '1h',
  async handler({ query, collection, limit }) {
    const params = new URLSearchParams({ query, prefix: collection })
    if (limit) params.set('limit', String(limit))

    const data = await $fetch<{ icons: string[], total: number }>(`https://api.iconify.design/search?${params}`)

    return {
      icons: data.icons.map((icon) => {
        const [iconPrefix, ...nameParts] = icon.split(':')
        const name = nameParts.join(':')
        return {
          name: `i-${iconPrefix}-${name}`,
          preview: `https://api.iconify.design/${iconPrefix}/${name}.svg`
        }
      }),
      total: data.total,
      query,
      collection
    }
  }
})