aruba-cx-switching

View and manage VLANs and MAC address tables on Aruba CX switches via REST API.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Network engineers need to audit VLAN segmentation, track endpoint locations, and manage Layer 2 configurations on Aruba CX switches without manually logging into each device or risking ungoverned changes.

Core Features & Use Cases

  • VLAN Discovery: List VLAN configurations, names, and tagged/untagged port assignments across switches.
  • MAC Address Tracking: Query MAC address tables by VLAN or specific address to locate which port an endpoint connects to.
  • ITSM-Gated VLAN Management: Create, modify, or delete VLANs with ServiceNow change request validation when ITSM_ENABLED is set.
  • Use Case: A user asks "Which port is MAC aa:bb:cc:dd:ee:ff learned on?" to trace a misbehaving endpoint, then creates a guest VLAN with an approved CR number.

Quick Start

Ask the agent to show all VLANs on your core switch, for example: "Show all VLANs on core-sw-1".

Frequently Asked Questions about aruba-cx-switching

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

FAQPage Schema
How do I view VLANs on an Aruba CX switch?

Ask the agent to show VLANs on a target switch, such as "Show all VLANs on core-sw-1". The get_vlans tool returns VLAN IDs, names, admin state, and tagged/untagged port assignments via the switch REST API.

How do I find which switch port a MAC address is connected to?

Query the MAC address table with a specific address, for example "Find MAC address aa:bb:cc:dd:ee:ff on core-sw-1". The get_mac_table tool returns the port, VLAN, entry type, and age for that address.

Does creating a VLAN on Aruba CX require change management approval?

Write operations require a ServiceNow CR number when ITSM_ENABLED=true. With ITSM_LAB_MODE=true the CR format is validated without contacting ServiceNow, and with ITSM_ENABLED=false writes proceed without a CR.

What credentials does the Aruba CX MCP server need?

The server authenticates via the switch REST API using the ARUBA_CX_TARGETS environment variable as a JSON array, or ARUBA_CX_CONFIG pointing to a config file. Invalid credentials return an AUTH_FAILED error.

Why does VLAN creation fail with CR_REQUIRED or CR_INVALID?

CR_REQUIRED means ITSM gating is enabled and no cr_number parameter was provided. CR_INVALID means the CR failed validation, so verify the format matches the ServiceNow pattern such as CHG0001234 and that the change is approved.