Cisco SD-WAN MCP Server MCP Server

Name: Cisco SD-WAN MCP Server MCP Server
Author: io.github.pcDamasceno

io.github.pcDamasceno/cisco-sdwan-mcp

Repository Registry

What is the Cisco SD-WAN MCP Server MCP server?

MCP server for Cisco Catalyst SD-WAN (vManage): fabric inventory, device health, alarms, policies.

How to install Cisco SD-WAN MCP Server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

SDWAN_VMANAGE_URL
required
Cisco Catalyst SD-WAN Manager URL, e.g. https://vmanage.example.com:8443
SDWAN_USERNAME
required
vManage username. Use a dedicated read-only account.
SDWAN_PASSWORD
required
secret
vManage password for SDWAN_USERNAME.
MCP_TRANSPORT
Must be stdio for this install. The server itself defaults to http; set http only when deploying it as a service.
SDWAN_VERIFY_SSL
Verify the vManage TLS certificate. Prefer SDWAN_CA_BUNDLE over disabling this.
SDWAN_CA_BUNDLE
Path to a CA bundle for a private-CA or self-signed vManage certificate.
SDWAN_ENABLE_WRITES
Register the configuration-changing tools. Read-only when unset.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "cisco-sdwan-mcp": {
      "command": "uvx",
      "args": [
        "cisco-sdwan-mcp"
      ],
      "env": {
        "SDWAN_VMANAGE_URL": "<YOUR_SDWAN_VMANAGE_URL>",
        "SDWAN_USERNAME": "<YOUR_SDWAN_USERNAME>",
        "SDWAN_PASSWORD": "<YOUR_SDWAN_PASSWORD>",
        "MCP_TRANSPORT": "<YOUR_MCP_TRANSPORT>",
        "SDWAN_VERIFY_SSL": "<YOUR_SDWAN_VERIFY_SSL>",
        "SDWAN_CA_BUNDLE": "<YOUR_SDWAN_CA_BUNDLE>",
        "SDWAN_ENABLE_WRITES": "<YOUR_SDWAN_ENABLE_WRITES>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "cisco-sdwan-mcp": {
      "command": "uvx",
      "args": [
        "cisco-sdwan-mcp"
      ],
      "env": {
        "SDWAN_VMANAGE_URL": "<YOUR_SDWAN_VMANAGE_URL>",
        "SDWAN_USERNAME": "<YOUR_SDWAN_USERNAME>",
        "SDWAN_PASSWORD": "<YOUR_SDWAN_PASSWORD>",
        "MCP_TRANSPORT": "<YOUR_MCP_TRANSPORT>",
        "SDWAN_VERIFY_SSL": "<YOUR_SDWAN_VERIFY_SSL>",
        "SDWAN_CA_BUNDLE": "<YOUR_SDWAN_CA_BUNDLE>",
        "SDWAN_ENABLE_WRITES": "<YOUR_SDWAN_ENABLE_WRITES>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "cisco-sdwan-mcp": {
      "command": "uvx",
      "args": [
        "cisco-sdwan-mcp"
      ],
      "env": {
        "SDWAN_VMANAGE_URL": "<YOUR_SDWAN_VMANAGE_URL>",
        "SDWAN_USERNAME": "<YOUR_SDWAN_USERNAME>",
        "SDWAN_PASSWORD": "<YOUR_SDWAN_PASSWORD>",
        "MCP_TRANSPORT": "<YOUR_MCP_TRANSPORT>",
        "SDWAN_VERIFY_SSL": "<YOUR_SDWAN_VERIFY_SSL>",
        "SDWAN_CA_BUNDLE": "<YOUR_SDWAN_CA_BUNDLE>",
        "SDWAN_ENABLE_WRITES": "<YOUR_SDWAN_ENABLE_WRITES>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "cisco-sdwan-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "cisco-sdwan-mcp"
      ],
      "env": {
        "SDWAN_VMANAGE_URL": "<YOUR_SDWAN_VMANAGE_URL>",
        "SDWAN_USERNAME": "<YOUR_SDWAN_USERNAME>",
        "SDWAN_PASSWORD": "<YOUR_SDWAN_PASSWORD>",
        "MCP_TRANSPORT": "<YOUR_MCP_TRANSPORT>",
        "SDWAN_VERIFY_SSL": "<YOUR_SDWAN_VERIFY_SSL>",
        "SDWAN_CA_BUNDLE": "<YOUR_SDWAN_CA_BUNDLE>",
        "SDWAN_ENABLE_WRITES": "<YOUR_SDWAN_ENABLE_WRITES>"
      }
    }
  }
}

Claude Code

claude mcp add cisco-sdwan-mcp --env SDWAN_VMANAGE_URL=<YOUR_SDWAN_VMANAGE_URL> --env SDWAN_USERNAME=<YOUR_SDWAN_USERNAME> --env SDWAN_PASSWORD=<YOUR_SDWAN_PASSWORD> --env MCP_TRANSPORT=<YOUR_MCP_TRANSPORT> --env SDWAN_VERIFY_SSL=<YOUR_SDWAN_VERIFY_SSL> --env SDWAN_CA_BUNDLE=<YOUR_SDWAN_CA_BUNDLE> --env SDWAN_ENABLE_WRITES=<YOUR_SDWAN_ENABLE_WRITES> -- uvx cisco-sdwan-mcp