List every category in the Cisco Systems Corporate Iconography catalog, with a human-readable label and how many icons fall into each.

Use this first to understand how the 308-icon catalog is organized before calling cisco_list_icons or cisco_search_icons with a category filter.

Args: none.

Returns JSON: { "categories": [ { "id": "routing_l3", "label": "Roteamento (Camada 3)", "icon_count": 12 } ] }

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").

List icons from the 308-icon Cisco Systems Corporate Iconography catalog, optionally filtered by category, with pagination.

Defaults to curated_only=true, returning the 29 icons most relevant for teaching/enterprise network diagrams (router, switch, firewall, server, access point, cloud, etc.). Set curated_only=false to browse the full catalog (legacy/specific Cisco products, generic devices, people/buildings/phones icons).

Does NOT return image bytes — call cisco_get_icon with an id from the results to fetch the actual image.

Args:

• curated_only (boolean, default true): restrict to the 29 curated icons

• category (string, optional): filter by category id (see cisco_list_categories)

• limit (number, default 50, max 100): page size

• offset (number, default 0): pagination offset

Returns JSON: { "total": number, "count": number, "offset": number, "results": [ { "id": string, "name": string, "category": string, "curated": boolean, "description": string } ], "has_more": boolean, "next_offset": number | null }

Fetch one Cisco network icon by id: its full metadata plus the actual image (PNG, RGB — pre-converted from Cisco's original CMYK JPEGs, which render blank or with wrong colors in most web/collaborative tools like Miro or Figma/FigJam).

Use this after cisco_search_icons or cisco_list_icons has told you the exact id you need. The image is returned as an embedded PNG you can place directly into a Miro board, Figma/FigJam file, or document.

Args:

• id (string, required): exact icon id (case-sensitive), e.g. "router", "cisco_asa_5500"

Returns:

• An image content block (PNG, RGB) — pass its dimensions to a 'FIT' scale mode when placing on a canvas; the icons are NOT square (e.g. "router" is ~77x52), so a 'FILL' scale mode will crop or distort it.

• A text block with the icon's metadata (name, category, curated flag, description, and — for curated icons — glossary_name/function/when_to_use).

Error Handling:

• Returns "Error: icon '' not found" if the id doesn't exist. Call cisco_search_icons first to find the correct id — don't retry with guessed variations.