# Digche Icons

Digche provides semantic icon discovery for any AI platform. It is not tied to
a model vendor or agent host.

## Preferred integration: MCP

- Transport: Streamable HTTP
- Endpoint: https://digche.vercel.app/api/mcp
- Descriptor: https://digche.vercel.app/mcp-server.json
- Tools: list_categories, search_icons, recommend_icons, find_replacement,
  preview_icons, get_icon_svg
- Prompt: migrate_ui_icons
- Resource: digche://guides/icon-migration
- Connection presets: https://digche.vercel.app/api/v1/integrations

Recommended sequence: for a whole screen call recommend_icons once with the UI
slots and the task, rather than searching per icon. For a single replacement
call find_replacement once per unique icon meaning and UI context, request at
most 3 candidates, then call get_icon_svg only for the final slug and style. Use
search_icons when the first match is ambiguous, and preview_icons when the
choice needs to be seen before it is made.

Every tool returns a status field. When it is not "ok", follow next_step rather
than guessing a slug: no_icons_found means nothing matched, needs_clarification
means the request was too ambiguous to answer, and error carries a plain-language
reason.

## Universal REST and OpenAPI fallback

- API root: https://digche.vercel.app/api/v1
- OpenAPI 3.1: https://digche.vercel.app/api/v1/openapi.json
- Health: https://digche.vercel.app/api/v1/health
- Search: GET https://digche.vercel.app/api/v1/icons?q={intent}&limit=3
- Detail: GET https://digche.vercel.app/api/v1/icons/{slug}
- Categories: GET https://digche.vercel.app/api/v1/categories
- Preview sheet: GET https://digche.vercel.app/api/v1/preview?slugs={a,b,c}&style=Linear

Use REST or import the OpenAPI document when an AI host does not support MCP.
The host must support MCP, function tools, or HTTP access for direct use.

## Selection policy

- Match by meaning, context, category, aliases, tags, and use cases; not shape alone.
- Preserve the project's existing Digche style; otherwise prefer Linear for UI.
- Keep existing fallbacks when confidence is low rather than guessing.
- Preserve currentColor, accessibility labels, sizing, and interaction states.