{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Icon concept or search phrase, for example \"database\", \"user profile\", \"chill\", \"trash\", \"upload cloud\", \"AI model\", or \"beautiful\"."
    },
    "library": {
      "type": "string",
      "description": "Optional library key only when the user named a library. Omit it to search all libraries. Do not use all as a library key. Supported values include si (Supericons AI and developer tool logos), lucide, tabler, phosphor, heroicons, bootstrap, iconoir, ionicons, material, simpleicons (Simple Icons brand logos), and mingcute."
    },
    "library_mode": {
      "$ref": "#/properties/library",
      "description": "Optional library behavior. Omit a self-chosen library and search all, or use prefer with that library. Use strict only when the user explicitly requires the named library. All searches every eligible library. Unsupported or incomplete combinations are safely normalized with a warning."
    },
    "style": {
      "$ref": "#/properties/library",
      "default": "any",
      "description": "Optional style preference. Unsupported values are ignored with a warning."
    },
    "locale": {
      "$ref": "#/properties/library",
      "description": "Optional locale for multilingual search terms. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th. Unsupported values are ignored with a warning."
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 50,
      "default": 10,
      "description": "Maximum number of icons from 1 to 50. Numeric strings are accepted."
    },
    "include_query_frame": {
      "type": "boolean",
      "default": false,
      "description": "Optional public-safe diagnostics for query understanding. Boolean strings are accepted. Leave false for normal compact responses."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "task": {
      "type": "string",
      "default": "",
      "description": "Overall UI task, for example \"choose icons for an AI dashboard sidebar\" or \"select bottom navigation icons for a finance app\". Missing task text returns a structured recovery message."
    },
    "slots": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "default": [],
      "description": "List of 1 to 20 UI slots to fill, for example [\"model\", \"prompt\", \"dataset\", \"evaluation\"]. A single string is accepted as one slot. Larger lists return a structured split instruction."
    },
    "library": {
      "$ref": "#/properties/task",
      "description": "Optional library key when the user wants a consistent icon family. Supported values include si (Supericons AI and developer tool logos), lucide, tabler, phosphor, heroicons, bootstrap, iconoir, ionicons, material, simpleicons (Simple Icons brand logos), and mingcute."
    },
    "style": {
      "$ref": "#/properties/task",
      "default": "any",
      "description": "Optional style preference. Unsupported values are ignored with a warning."
    },
    "locale": {
      "$ref": "#/properties/task",
      "description": "Optional locale for multilingual slot labels. Unsupported values are ignored with a warning."
    },
    "limit_per_slot": {
      "type": [
        "number",
        "string"
      ],
      "default": 3,
      "description": "Number of choices per slot. Values outside 1 to 5 are clamped with a warning. Numeric strings are accepted."
    },
    "response_mode": {
      "$ref": "#/properties/task",
      "default": "plan",
      "description": "Response size mode: plan, assets, or full. Unsupported values use plan with a warning."
    },
    "include_query_frame": {
      "type": "boolean",
      "default": false,
      "description": "Optional public-safe diagnostics for query understanding. Boolean strings are accepted. Leave false for normal compact responses."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Exact icon ID without the library prefix, for example \"database\", \"user-circle\", \"brain-circuit\", or \"arrow-down\"."
    },
    "library": {
      "type": "string",
      "description": "Required library key for the exact icon. Supported values include si (Supericons AI and developer tool logos), lucide, tabler, phosphor, heroicons, bootstrap, iconoir, ionicons, material, simpleicons (Simple Icons brand logos), and mingcute."
    },
    "style": {
      "type": "string",
      "enum": [
        "any",
        "outline",
        "solid"
      ],
      "default": "any",
      "description": "Optional style preference. Material Symbols supports outline and solid. Other hosted libraries report their verified styles in list_libraries."
    }
  },
  "required": [
    "id",
    "library"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Optional search query to preview visually, for example \"license plate recognition camera scan car\"."
    },
    "icon_refs": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "description": "Optional fixed icon refs in library:id format. Arrays, a single ref, and comma-separated refs are accepted. Up to 100 are accepted, 24 appear on the browser preview, and 12 are rendered inline. Larger lists are safely truncated with a warning."
    },
    "library": {
      "$ref": "#/properties/query",
      "description": "Optional library key. Supported values include si (Supericons AI and developer tool logos), lucide, tabler, phosphor, heroicons, bootstrap, iconoir, ionicons, material, simpleicons (Simple Icons brand logos), and mingcute."
    },
    "style": {
      "$ref": "#/properties/query",
      "default": "any",
      "description": "Optional style preference. Unsupported values are ignored with a warning."
    },
    "locale": {
      "$ref": "#/properties/query",
      "description": "Optional locale for multilingual search terms. Supported values: zh-Hans, zh-Hant, ja, ko, es, de, pt, ar, hi, vi, th. Unsupported values are ignored with a warning."
    },
    "limit": {
      "type": [
        "number",
        "string"
      ],
      "default": 12,
      "description": "Requested inline icon count. Values outside 1 to 12 are safely clamped with a warning. Numeric strings are accepted."
    },
    "include_image": {
      "type": "boolean",
      "default": true,
      "description": "When true, include a PNG contact sheet as MCP image content. Boolean strings are accepted. A preview_url is always returned."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {}
}