First run¶
The commands below assume an installed CLI (sdwan-mcp, via uv tool install /
pipx). Running from a source checkout? Prefix each with uv run
(uv run sdwan-mcp …). Running without installing? Use
uvx catalyst-sdwan-super-mcp ….
Run as stdio (Claude Desktop)¶
Default transport — no network ports, the MCP client spawns the server as a subprocess.
You should see something like:
[server] SD-WAN Super MCP
[server] Spec version : 20.18
[server] Mode : READ-ONLY
[server] Transport : stdio
[server] vManage Auth : JWT
[loader] Loading vmanageapi_2018.yaml
[loader] Loaded 1 spec file(s), 2802 total paths
[loader] Mode=RO, max_actions_per_tool=150 -> 230 tool(s), 2251 operations
[loader] Index built: 2251 actions across 230 tools
[auth] JWT login successful
[server] 230 tools registered — starting stdio transport
Run as SSE (network-accessible)¶
Enable writes¶
Off by default. Pass --read-write to register POST/PUT/DELETE/PATCH:
⚠ Writes are real: they mutate your vManage. Don't aim this at production until you've practiced on the DevNet sandbox.
Diff two spec versions¶
Outputs added/removed operations and parameter drift.