Skip to content
MCP server

Cisco Umbrella

MCP server for Cisco Umbrella's deployment, admin, policy, reporting, and investigate…

Runs locallyStatus and history
Install
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.3

Add 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.Required
  • CISCOUMBRELLA_API_SECRETCisco Umbrella API Secret paired with the API Key. Shown only once at creation and cannot be retrieved later.Required
  • MCP_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.

How AIPoweredBot checks servers