Cisco Umbrella
MCP server for Cisco Umbrella's deployment, admin, policy, reporting, and investigate…
- Pricing
- Open source
- Runs
- Locally
- Version
- 1.0.3
- Listing updated
- 5 days ago
About Cisco Umbrella
Cisco Umbrella is an open-source MCP server. It runs locally on your machine and is started by your AI client.
MCP server for Cisco Umbrella's deployment, admin, policy, reporting, and investigate APIs.
Install
Run in a terminal
claude mcp add cisco-umbrella-mcp --env CISCOUMBRELLA_API_KEY='<CISCOUMBRELLA_API_KEY>' --env 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.3Add to claude_desktop_config.json
{
"mcpServers": {
"cisco-umbrella-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"CISCOUMBRELLA_API_KEY",
"-e",
"CISCOUMBRELLA_API_SECRET",
"ghcr.io/wyre-ai/cisco-umbrella-mcp:v1.0.3"
],
"env": {
"CISCOUMBRELLA_API_KEY": "<CISCOUMBRELLA_API_KEY>",
"CISCOUMBRELLA_API_SECRET": "<CISCOUMBRELLA_API_SECRET>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"cisco-umbrella-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"CISCOUMBRELLA_API_KEY",
"-e",
"CISCOUMBRELLA_API_SECRET",
"ghcr.io/wyre-ai/cisco-umbrella-mcp:v1.0.3"
],
"env": {
"CISCOUMBRELLA_API_KEY": "<CISCOUMBRELLA_API_KEY>",
"CISCOUMBRELLA_API_SECRET": "<CISCOUMBRELLA_API_SECRET>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"cisco-umbrella-mcp": {
"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.3"
],
"env": {
"CISCOUMBRELLA_API_KEY": "<CISCOUMBRELLA_API_KEY>",
"CISCOUMBRELLA_API_SECRET": "<CISCOUMBRELLA_API_SECRET>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"cisco-umbrella-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"CISCOUMBRELLA_API_KEY",
"-e",
"CISCOUMBRELLA_API_SECRET",
"ghcr.io/wyre-ai/cisco-umbrella-mcp:v1.0.3"
],
"env": {
"CISCOUMBRELLA_API_KEY": "<CISCOUMBRELLA_API_KEY>",
"CISCOUMBRELLA_API_SECRET": "<CISCOUMBRELLA_API_SECRET>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"cisco-umbrella-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"CISCOUMBRELLA_API_KEY",
"-e",
"CISCOUMBRELLA_API_SECRET",
"ghcr.io/wyre-ai/cisco-umbrella-mcp:v1.0.3"
],
"env": {
"CISCOUMBRELLA_API_KEY": "<CISCOUMBRELLA_API_KEY>",
"CISCOUMBRELLA_API_SECRET": "<CISCOUMBRELLA_API_SECRET>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
CISCOUMBRELLA_API_KEYCisco Umbrella API Key, from Admin > API Keys (or Console Settings > API Keys for Multi-org/MSP) in the Umbrella admin console.RequiredCISCOUMBRELLA_API_SECRETCisco Umbrella API Secret paired with the API Key. Shown only once at creation and cannot be retrieved later.RequiredMCP_TRANSPORTTransport mode for the server. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting.AUTH_MODECredential source: 'env' reads vars locally, 'gateway' expects header injection from the WYRE MCP Gateway.LOG_LEVELLog verbosity: debug, info, warn, error
Pricing
Open source
Cisco Umbrella FAQ
Is Cisco Umbrella free?
Yes. Cisco Umbrella is open source, so you can use and self-host it for free.
How do I add Cisco Umbrella to Claude Code?
Run this command in your terminal: claude mcp add cisco-umbrella-mcp --env CISCOUMBRELLA_API_KEY='<CISCOUMBRELLA_API_KEY>' --env 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.3
Where this comes from
- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.