Cisco SD-WAN MCP Server

Name: Cisco SD-WAN MCP Server
Author: pcDamasceno

pcDamasceno

MCP server for Cisco Catalyst SD-WAN Manager (vManage). Read-only by default: fabric inventory, device health, control connections, BFD/OMP state, alarms, tunnel path quality, templates and policies as MCP tools for Claude and other AI assistants.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add cisco-sd-wan --env SDWAN_VMANAGE_URL='<SDWAN_VMANAGE_URL>' --env SDWAN_USERNAME='<SDWAN_USERNAME>' --env SDWAN_PASSWORD='<SDWAN_PASSWORD>' -- uvx cisco-sdwan-mcp

~/.codex/config.toml

[mcp_servers.cisco-sd-wan]
command = "uvx"
args = ["cisco-sdwan-mcp"]
env = { SDWAN_VMANAGE_URL = "<SDWAN_VMANAGE_URL>", SDWAN_USERNAME = "<SDWAN_USERNAME>", SDWAN_PASSWORD = "<SDWAN_PASSWORD>" }

# codex mcp add cisco-sd-wan --env SDWAN_VMANAGE_URL='<SDWAN_VMANAGE_URL>' --env SDWAN_USERNAME='<SDWAN_USERNAME>' --env SDWAN_PASSWORD='<SDWAN_PASSWORD>' -- uvx cisco-sdwan-mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "cisco-sd-wan": {
      "command": "uvx",
      "args": [
        "cisco-sdwan-mcp"
      ],
      "env": {
        "SDWAN_VMANAGE_URL": "<SDWAN_VMANAGE_URL>",
        "SDWAN_USERNAME": "<SDWAN_USERNAME>",
        "SDWAN_PASSWORD": "<SDWAN_PASSWORD>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "cisco-sd-wan": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "cisco-sdwan-mcp"
      ],
      "env": {
        "SDWAN_VMANAGE_URL": "<SDWAN_VMANAGE_URL>",
        "SDWAN_USERNAME": "<SDWAN_USERNAME>",
        "SDWAN_PASSWORD": "<SDWAN_PASSWORD>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "cisco-sd-wan": {
      "command": "uvx",
      "args": [
        "cisco-sdwan-mcp"
      ],
      "env": {
        "SDWAN_VMANAGE_URL": "<SDWAN_VMANAGE_URL>",
        "SDWAN_USERNAME": "<SDWAN_USERNAME>",
        "SDWAN_PASSWORD": "<SDWAN_PASSWORD>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "cisco-sd-wan": {
      "command": "uvx",
      "args": [
        "cisco-sdwan-mcp"
      ],
      "env": {
        "SDWAN_VMANAGE_URL": "<SDWAN_VMANAGE_URL>",
        "SDWAN_USERNAME": "<SDWAN_USERNAME>",
        "SDWAN_PASSWORD": "<SDWAN_PASSWORD>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "cisco-sd-wan": {
      "command": "uvx",
      "args": [
        "cisco-sdwan-mcp"
      ],
      "env": {
        "SDWAN_VMANAGE_URL": "<SDWAN_VMANAGE_URL>",
        "SDWAN_USERNAME": "<SDWAN_USERNAME>",
        "SDWAN_PASSWORD": "<SDWAN_PASSWORD>"
      }
    }
  }
}

Environment variables

SDWAN_VMANAGE_URL
SDWAN_USERNAME
SDWAN_PASSWORD

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related