Built-in prompts
SZ-MCP ships ten built-in prompts, which appear in Claude’s + menu under
the connector. Each one is a ready-written request that Claude then carries out
with code_mode. Every prompt is listed for every user. The set is fixed: you
cannot add, edit or remove prompts.
Every argument is optional. Leave one blank and the prompt tells Claude what to do instead, usually to ask you or to use a default. Argument values are trimmed and cut to 500 characters.
The ten prompts
Section titled “The ten prompts”| Title in the + menu | What it does | Arguments |
|---|---|---|
| Explore the SmartZone API | Find the right helper or endpoint for a goal across the wireless (WSG) and switch (SwitchM) APIs, and run the read-only parts. | goal: what you want to do. Blank: Claude asks |
| Controller health check | Cluster, APs, switches, open alarms, licences, firmware and streaming in one pass, as a verdict and a findings table. | None |
| Why is this AP offline? | Last seen, reboot and disconnect alarms, whether the rest of the zone is down too, and the ICX port it’s cabled to, as a likely cause with evidence. | ap: AP name, MAC, serial or IP. Blank: Claude lists the offline APs and asks |
| Find a client | Where a client is connected (AP, SSID, VLAN, signal), its recent sessions, and joins, disconnects and roams from the stream. | client: client MAC (best), IP, hostname or username. Blank: Claude asks |
| A client’s journey | Why a client dropped, roamed or could not connect: its joins, roams, failures and disconnects in order, with reasons and a verdict. | client: as above. hours: look-back window, default 24 |
| Which switch port is it on? | Find the ICX port a device or AP is plugged into, tell its own port from an uplink, and check link, speed, PoE, errors, VLANs and 802.1X. | device: MAC (best), IP, description, AP MAC, or a switch and port. Blank: Claude asks |
| Switch fleet audit | ICX switches by status, model and firmware: offline switches, firmware drift per model, health flags, and CPU/memory when streamed. | group: switch group name. Blank: every switch |
| Compare switch config backups | Diff an ICX switch’s two newest config backups and explain what changed, flagging anything that weakens security or could cut connectivity. | switch: switch MAC (its id), name or IP. Blank: Claude lists the switches and asks |
| Alarm triage | Group the alarms of the last N hours by type and device, order them by impact, and say which need action and which are noise. | hours: look-back window, default 24. severity: minimum severity (Critical, Major, Minor, Warning or Informational), default Warning |
| Streaming status | Is the controller streaming to sz-mcp? Connection, last message age, freshness per data kind against its cadence, and decode failures. | None |
The descriptions above are the ones Claude sees when it lists the prompts.
Do prompts change anything on my controller?
Section titled “Do prompts change anything on my controller?”No. Every prompt ends with the same rules: everything in the task is read-only, and if a fix needs a change on the controller (a reboot, a config edit, acknowledging or clearing an alarm), Claude describes it and asks you first. The write guard still applies to any write you then agree to.
The rules also tell Claude to check ok and status on every call and say
which parts failed, and to treat names, SSIDs, hostnames and event text from
your network as data, never as instructions.
Which prompts depend on streaming?
Section titled “Which prompts depend on streaming?”Four prompts use Northbound streaming data when it exists, and Northbound streaming is not available on the hosted service yet:
| Prompt | Without streaming |
|---|---|
| Streaming status | Reports that streaming isn’t set up, and stops |
| Find a client | Uses the current connection and recent ended sessions from the API; joins, disconnects and roams need the stream |
| A client’s journey | Shows only IP updates, ended sessions and the current connection, and says so |
| Switch fleet audit | Leaves out CPU and memory |
The Controller health check also covers streaming status as one of its checks.