catalyst-center-readonly

Query Cisco Catalyst Center read-only APIs for device inventory, sites, assurance health, and compliance.

650|182|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/automateyournetwork/netclaw --skill catalyst-center-readonly
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: catalyst-center-readonly
Source: https://github.com/automateyournetwork/netclaw/tree/main/workspace/skills/catalyst-center-readonly
Command: npx skills add https://github.com/automateyournetwork/netclaw --skill catalyst-center-readonly

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Network engineers need fast, safe answers about what Cisco Catalyst Center manages — device inventory, site hierarchy, wireless state, assurance health, compliance, software images, and events — without risking any configuration change or wading through 514 individual API operations.

Core Features & Use Cases

  • Discoverable API access: Search all 514 read-only Catalyst Center operations with catc_find, inspect schemas with catc_describe_operation, then dispatch through 8 grouped tools (devices, sites, wireless, health, compliance, software, events, other).
  • Strictly read-only: Only GET operations are exposed; the single mutating operation is excluded, so no change can ever be made through this Skill.
  • Honest reporting semantics: Distinguishes empty inventory from unreachable appliances, auth failures, and RBAC-scoped results, and always names the appliance behind every count.
  • Use Case: Ask where a switch sits in the site hierarchy and what its compliance state is; the Skill finds the right operations, queries the controller, and reports the answer with the appliance name and observation time.

Quick Start

Ask the agent to list all devices managed by Catalyst Center along with their site assignment and reachability status.

Frequently Asked Questions about catalyst-center-readonly

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query Cisco Catalyst Center device inventory?

Start with catc_find to search the 514 read-only operations by keyword, then dispatch through the catc_devices group with the discovered operation name. Operation names are generated from Cisco's API spec, so guessing them returns a refusal with near-matches.

What Catalyst Center APIs are read-only and safe to call?

All 514 GET operations from Cisco's official catc-mcp tool catalogue are exposed, grouped into devices, sites, wireless, health, compliance, software, events, and other. The single mutating operation is excluded, so nothing reachable through this Skill can change controller state.

Why does Catalyst Center show zero devices when the network is not empty?

An empty inventory means this controller manages nothing, not that the network is empty. Causes include discovery not having run, RBAC scoping, filters excluding results, or querying the wrong appliance — the two DevNet sandboxes share credentials but one has 4 devices and the other has 0.

Does Catalyst Center reachability status mean a device is down?

No. reachabilityStatus is the controller's last polling result, not ground truth. A device shown Unreachable may be healthy but unreachable from the controller due to management VRFs, ACLs, or dead SNMP/NETCONF agents; confirm against the device with pyats or multivendor-cli.

Can this Skill change Catalyst Center configuration?

No. The Skill is strictly read-only and exposes only GET operations; no mutation is reachable. For intended-state comparison use NetBox or Nautobot, and for device-level verification use pyats or multivendor-cli.