Cisco Umbrella MCP Server
by wyre-aiio.github.WYRE-AI/cisco-umbrella-mcpv1.0.0
MCP server for Cisco Umbrella's deployment, admin, policy, reporting, and investigate APIs.
context tax
queued
security
queued
cold start
queued
freshness
Active20d ago
Install Cisco Umbrella MCP server
Install in Claude Code
claude mcp add cisco-umbrella -e CISCOUMBRELLA_API_KEY='<ciscoumbrella-api-key>' -e CISCOUMBRELLA_API_SECRET='<ciscoumbrella-api-secret>' -- docker run -i --rm -e CISCOUMBRELLA_API_KEY -e CISCOUMBRELLA_API_SECRET ghcr.io/wyre-ai/cisco-umbrella-mcp:v1.0.0Install in Cursor
{
"mcpServers": {
"cisco-umbrella": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"CISCOUMBRELLA_API_KEY",
"-e",
"CISCOUMBRELLA_API_SECRET",
"ghcr.io/wyre-ai/cisco-umbrella-mcp:v1.0.0"
],
"env": {
"CISCOUMBRELLA_API_KEY": "<ciscoumbrella-api-key>",
"CISCOUMBRELLA_API_SECRET": "<ciscoumbrella-api-secret>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"cisco-umbrella": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"CISCOUMBRELLA_API_KEY",
"-e",
"CISCOUMBRELLA_API_SECRET",
"ghcr.io/wyre-ai/cisco-umbrella-mcp:v1.0.0"
],
"env": {
"CISCOUMBRELLA_API_KEY": "<ciscoumbrella-api-key>",
"CISCOUMBRELLA_API_SECRET": "<ciscoumbrella-api-secret>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"cisco-umbrella": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"CISCOUMBRELLA_API_KEY",
"-e",
"CISCOUMBRELLA_API_SECRET",
"ghcr.io/wyre-ai/cisco-umbrella-mcp:v1.0.0"
],
"env": {
"CISCOUMBRELLA_API_KEY": "<ciscoumbrella-api-key>",
"CISCOUMBRELLA_API_SECRET": "<ciscoumbrella-api-secret>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"cisco-umbrella": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"CISCOUMBRELLA_API_KEY",
"-e",
"CISCOUMBRELLA_API_SECRET",
"ghcr.io/wyre-ai/cisco-umbrella-mcp:v1.0.0"
],
"env": {
"CISCOUMBRELLA_API_KEY": "<ciscoumbrella-api-key>",
"CISCOUMBRELLA_API_SECRET": "<ciscoumbrella-api-secret>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| CISCOUMBRELLA_API_KEY | yes | — | Cisco Umbrella API Key, from Admin > API Keys (or Console Settings > API Keys for Multi-org/MSP) in the Umbrella admin console. |
| CISCOUMBRELLA_API_SECRET | yes | yes | Cisco Umbrella API Secret paired with the API Key. Shown only once at creation and cannot be retrieved later. |
| MCP_TRANSPORT | — | — | Transport mode for the server. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting. |
| AUTH_MODE | — | — | Credential source: 'env' reads vars locally, 'gateway' expects header injection from the WYRE MCP Gateway. |
| LOG_LEVEL | — | — | Log verbosity: debug, info, warn, error |
Freshness
Active — last maintenance signal 20d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-20 · 20d ago · GitHub
Latest release
2026-09-20 · 20d ago · GitHub · v1.0.0
Package published
no data · npm/PyPI
Registry entry updated
2026-09-20 · 20d ago · official registry · v1.0.0
FAQ
›How do I install the Cisco Umbrella MCP server in Claude Code?
Run: claude mcp add cisco-umbrella -e CISCOUMBRELLA_API_KEY='<ciscoumbrella-api-key>' -e CISCOUMBRELLA_API_SECRET='<ciscoumbrella-api-secret>' -- docker run -i --rm -e CISCOUMBRELLA_API_KEY -e CISCOUMBRELLA_API_SECRET ghcr.io/wyre-ai/cisco-umbrella-mcp:v1.0.0. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Cisco Umbrella require an API key?
Yes. It expects CISCOUMBRELLA_API_KEY, CISCOUMBRELLA_API_SECRET, of which 1 is a secret.
›Can I use Cisco Umbrella as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Cisco Umbrella in the official MCP registry?
Yes, as io.github.WYRE-AI/cisco-umbrella-mcp.