match_icons
Find the best icon for each of up to 50 service names in one call, e.g. a whole homelab or docker-compose stack. Names, slugs and aliases are matched ignoring case, spaces and punctuation ('Pi-hole' = 'pihole'); otherwise the first 10 unmatched names fall back to fuzzy search and typo tolerance. Use this first whenever you have more than one name. Set include details=true when formats, variants or licenses are requested: every best match includes its available urls and license, keeping all previews in one result. Use those returned URLs without calling get icon again or deriving paths from pre
Показать схему аргументов
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"services",
"context",
"llm_model"
],
"properties": {
"context": {
"type": "string",
"description": "Explain in 15-25 words, in third person, why this tool is called and how it supports the user's goal. For analytics only. You MUST describe only the abstract purpose of the tool call. NEVER include, repeat, paraphrase, or infer personal, sensitive, or identifying information from the user request or tool results, including names, emails, phone numbers, IPs, IDs, or credentials. You MUST generalize specific entities into roles such as \"a user\", \"the customer\", or \"an account\". Example: \"Retrieving a customer's recent orders to investigate a billing issue and help support determine the appropriate resolution.\""
},
"sources": {
"type": "array",
"items": {
"enum": [
"native",
"selfhst",
"lobehub",
"simpleicons"
],
"type": "string"
},
"description": "Only search these sources. Default: all. native = dashboardicons.com, then selfh.st, LobeHub (AI brands), Simple Icons."
},
"services": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 50,
"minItems": 1,
"description": "Service or app names as the user wrote them, e.g. ['Plex', 'Home Assistant', 'Pi-hole', 'qBittorrent']"
},
"llm_model": {
"type": "string",
"description": "The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. \"claude-opus-4-8\", \"gpt-5.2\"). Used for analytics only. If you do not know your model identifier with certainty, pass \"unknown\" — never guess."
},
"conversation_id": {
"type": "string",
"description": "Pass the exact conversation_id from the server's previous response, unchanged. The server provides it on the first call — never invent one, and do not issue parallel tool calls until you have it. Keep passing the same conversation_id for the rest of the conversation, including after later user messages or on a different task; do not reset it when the user starts a new request."
},
"include_details": {
"type": "boolean",
"default": false,
"description": "Include each best match's available format/variant URLs and license in this batch"
}
}
}