Search Cisco Network Icons
cisco_search_iconsFind official Cisco icons for network diagrams by keyword search, returning icon metadata and IDs so you can fetch the exact image for diagram construction.
Instructions
Search the 308 official Cisco Systems Corporate Iconography icons by keyword. Matches against the icon's id, name, and description text.
This tool does NOT return image bytes — it returns lightweight metadata so you can identify the right icon id, then call cisco_get_icon with that id to fetch the actual image. Use this whenever the user asks "what icon represents X" or before assembling a diagram.
Args:
query (string, required): search term, e.g. "firewall", "roteador", "switch"
curated_only (boolean, default false): restrict to the 29 curated, pedagogically-annotated icons
category (string, optional): restrict to one category id (see cisco_list_categories)
limit (number, default 20, max 50): maximum results
Returns JSON: { "query": string, "total_matches": number, "count": number, "results": [ { "id": string, "name": string, "category": string, "curated": boolean, "description": string } ], "truncated": boolean }
Examples:
Use when: "que ícone eu uso pra representar um firewall?" -> query="firewall"
Use when: "preciso do ícone genérico de roteador wireless" -> query="wireless router"
Don't use when: you already know the exact id (use cisco_get_icon directly)
Error Handling:
Returns an empty "results" array (not an error) when nothing matches — suggest the user try an English equivalent or a generic fallback icon (e.g. "generic_gateway", "generic_processor").
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of results to return (default 20). | |
| query | Yes | Search term to match against icon id, name, and description. Cisco's original names are in English (e.g. 'router', 'firewall', 'switch') — if a Portuguese/Spanish term returns nothing, retry with the likely English equivalent. | |
| category | No | Optional category id to restrict the search to (see cisco_list_categories for valid ids, e.g. 'routing_l3', 'security'). | |
| curated_only | No | If true, only search the 29 curated icons (common classroom/enterprise equipment with full pedagogical context: function, when_to_use). Default false searches the full 308-icon catalog. |