Skip to content
MCP server

Cisco Umbrella MCP

Every Cisco Umbrella v2 API call, plus MSP child-org switching, domain verdicts, list…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.6
Listing updated
4 days ago

About Cisco Umbrella MCP

Cisco Umbrella MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Every Cisco Umbrella v2 API call, plus MSP child-org switching, domain verdicts, list diffs, and

Install

Run in a terminal

claude mcp add cisco-umbrella-mcp --env CISCO_UMBRELLA_API_KEY='<CISCO_UMBRELLA_API_KEY>' --env CISCO_UMBRELLA_API_SECRET='<CISCO_UMBRELLA_API_SECRET>' --env CISCO_UMBRELLA_MCP_HTTP_TOKEN='<CISCO_UMBRELLA_MCP_HTTP_TOKEN>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/cisco-umbrella-v0.1.6/cisco-umbrella-mcp.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "cisco-umbrella-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/cisco-umbrella-v0.1.6/cisco-umbrella-mcp.mcpb"
      ],
      "env": {
        "CISCO_UMBRELLA_API_KEY": "<CISCO_UMBRELLA_API_KEY>",
        "CISCO_UMBRELLA_API_SECRET": "<CISCO_UMBRELLA_API_SECRET>",
        "CISCO_UMBRELLA_MCP_HTTP_TOKEN": "<CISCO_UMBRELLA_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "cisco-umbrella-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/cisco-umbrella-v0.1.6/cisco-umbrella-mcp.mcpb"
      ],
      "env": {
        "CISCO_UMBRELLA_API_KEY": "<CISCO_UMBRELLA_API_KEY>",
        "CISCO_UMBRELLA_API_SECRET": "<CISCO_UMBRELLA_API_SECRET>",
        "CISCO_UMBRELLA_MCP_HTTP_TOKEN": "<CISCO_UMBRELLA_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "cisco-umbrella-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/cisco-umbrella-v0.1.6/cisco-umbrella-mcp.mcpb"
      ],
      "env": {
        "CISCO_UMBRELLA_API_KEY": "<CISCO_UMBRELLA_API_KEY>",
        "CISCO_UMBRELLA_API_SECRET": "<CISCO_UMBRELLA_API_SECRET>",
        "CISCO_UMBRELLA_MCP_HTTP_TOKEN": "<CISCO_UMBRELLA_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "cisco-umbrella-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/cisco-umbrella-v0.1.6/cisco-umbrella-mcp.mcpb"
      ],
      "env": {
        "CISCO_UMBRELLA_API_KEY": "<CISCO_UMBRELLA_API_KEY>",
        "CISCO_UMBRELLA_API_SECRET": "<CISCO_UMBRELLA_API_SECRET>",
        "CISCO_UMBRELLA_MCP_HTTP_TOKEN": "<CISCO_UMBRELLA_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "cisco-umbrella-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/cisco-umbrella-v0.1.6/cisco-umbrella-mcp.mcpb"
      ],
      "env": {
        "CISCO_UMBRELLA_API_KEY": "<CISCO_UMBRELLA_API_KEY>",
        "CISCO_UMBRELLA_API_SECRET": "<CISCO_UMBRELLA_API_SECRET>",
        "CISCO_UMBRELLA_MCP_HTTP_TOKEN": "<CISCO_UMBRELLA_MCP_HTTP_TOKEN>"
      }
    }
  }
}

Configuration

  • CISCO_UMBRELLA_API_KEYSet the CISCO_UMBRELLA_API_KEY credential for the Cisco Umbrella MCP server.Required
  • CISCO_UMBRELLA_API_SECRETSet the CISCO_UMBRELLA_API_SECRET credential for the Cisco Umbrella MCP server.Required
  • CISCO_UMBRELLA_ORG_IDOptional. Child org ID to act on from an MSP or Multi-org parent key (the same as --org). Leave blank to act on the key's own organization.
  • CISCO_UMBRELLA_BASE_URLOptional. Leave blank to use https://api.umbrella.com. Set it only to point at a different host, such as a test server; credentials then go to that host.
  • CISCO_UMBRELLA_TOKEN_URLOptional. Leave blank to use https://api.umbrella.com/auth/v2/token. It must be on the API host; a token URL on any other host is refused.
  • CISCO_UMBRELLA_OAUTH_SCOPEOptional. Scope sent with the token request. Leave blank: an Umbrella key already carries the scopes it was created with.
  • CISCO_UMBRELLA_MCP_READ_ONLYOptional. Set to exactly 1 to expose only read-only tools and refuse any state-changing execute call.
  • CISCO_UMBRELLA_NO_LOCAL_DATAOptional. Set to 1 to keep no local copy of API responses: reads go to the API and the response cache is off.
  • CISCO_UMBRELLA_MCP_HTTP_TOKENRequired only when running the MCP server with --transport http (a remote/hosted deployment). Callers must send a matching Authorization: Bearer header. Not needed for the default local stdio transport that Claude Desktop uses.
  • CISCO_UMBRELLA_MCP_UPLOAD_ROOTOptional. Leave blank. Reserved for MCP file uploads: no Cisco Umbrella MCP tool in this release takes a file, so the server never opens a local path and this setting has no effect.
  • CISCO_UMBRELLA_USER_AGENTOptional. Overrides the User-Agent the CLI sends on Umbrella requests. Leave blank to use the CLI's own built-in User-Agent.
  • PRINTING_PRESS_CLIENT_PROFILEOnly used when the MCP server is bound to a tenant-gated client profile. This connector registers no tenant-gated source, so leave it blank; pick a customer with CISCO_UMBRELLA_ORG_ID instead.

Pricing

Open source

Cisco Umbrella MCP FAQ

Is Cisco Umbrella MCP free?

Yes. Cisco Umbrella MCP is open source, so you can use and self-host it for free.

How do I add Cisco Umbrella MCP to Claude Code?

Run this command in your terminal: claude mcp add cisco-umbrella-mcp --env CISCO_UMBRELLA_API_KEY='<CISCO_UMBRELLA_API_KEY>' --env CISCO_UMBRELLA_API_SECRET='<CISCO_UMBRELLA_API_SECRET>' --env CISCO_UMBRELLA_MCP_HTTP_TOKEN='<CISCO_UMBRELLA_MCP_HTTP_TOKEN>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/cisco-umbrella-v0.1.6/cisco-umbrella-mcp.mcpb