Skip to main content
Glama
MSPbotsAI

cisco-umbrella-mcp

by MSPbotsAI
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
AUTH_MODENogateway = credentials per-request via headers; env = shared credentials from env vars (local dev only)gateway
MCP_HTTP_PORTNoHTTP server port8080
MCP_TRANSPORTNostdio (Claude Desktop) or http (gateway)stdio
UMBRELLA_API_KEYNoCisco Umbrella API Key (Admin > API Keys)
UMBRELLA_KEY_SECRETNoCisco Umbrella Key Secret (shown once at creation time)

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
cisco_umbrella_get_activity_dnsA

List DNS activity events.

    API: GET /reports/v2/activity/dns

    Args:
        from_: Required. Start of the time range. Accepts epoch
            milliseconds, ISO-8601 (e.g. "2024-01-01T00:00:00Z"), or a
            relative offset (e.g. "-1days", "-7days", "now").
        to: Required. End of the time range. Same accepted formats as from_.
        limit: Max results per page (default 100).
        offset: Pagination offset.
        domains: Comma-separated domain filter.
        categories: Comma-separated content category ID filter.
        identityids: Comma-separated identity (e.g. roaming computer) ID filter.
        verdict: Filter by verdict, e.g. "allowed" or "blocked".
        threats: Comma-separated threat name filter.
        timezone: IANA timezone name for the response's time fields.
cisco_umbrella_get_activity_proxyA

List proxy (Secure Web Gateway) activity events.

    API: GET /reports/v2/activity/proxy

    Args:
        from_: Required. Start of the time range. Accepts epoch
            milliseconds, ISO-8601 (e.g. "2024-01-01T00:00:00Z"), or a
            relative offset (e.g. "-1days", "-7days", "now").
        to: Required. End of the time range. Same accepted formats as from_.
        limit: Max results per page (default 100).
        offset: Pagination offset.
        domains: Comma-separated domain filter.
        urls: Comma-separated URL filter.
        categories: Comma-separated content category ID filter.
        identityids: Comma-separated identity ID filter.
        verdict: Filter by verdict, e.g. "allowed" or "blocked".
        threats: Comma-separated threat name filter.
        filename: Filter by downloaded file name.
        timezone: IANA timezone name for the response's time fields.
cisco_umbrella_get_activity_firewallA

List network firewall activity events.

    API: GET /reports/v2/activity/firewall

    Args:
        from_: Required. Start of the time range. Accepts epoch
            milliseconds, ISO-8601 (e.g. "2024-01-01T00:00:00Z"), or a
            relative offset (e.g. "-1days", "-7days", "now").
        to: Required. End of the time range. Same accepted formats as from_.
        limit: Max results per page (default 100).
        offset: Pagination offset.
        identityids: Comma-separated identity (e.g. network tunnel) ID filter.
        ruleid: Filter by firewall rule ID.
        verdict: Filter by verdict, e.g. "allowed" or "blocked".
        categories: Comma-separated category filter.
        timezone: IANA timezone name for the response's time fields.
cisco_umbrella_get_activity_amp_retrospectiveA

List AMP (Advanced Malware Protection) retrospective activity events — files that were re-classified as malicious after they were first seen.

    API: GET /reports/v2/activity/amp-retrospective

    Args:
        from_: Required. Start of the time range. Accepts epoch
            milliseconds, ISO-8601 (e.g. "2024-01-01T00:00:00Z"), or a
            relative offset (e.g. "-1days", "-7days", "now").
        to: Required. End of the time range. Same accepted formats as from_.
        limit: Max results per page (default 100).
        offset: Pagination offset.
        ampdisposition: Filter by AMP disposition, e.g. "malicious".
        sha256: Filter by a specific file's SHA-256 hash.
        timezone: IANA timezone name for the response's time fields.
cisco_umbrella_list_roaming_computersA

List roaming computers (endpoints running the Umbrella roaming client).

    API: GET /deployments/v2/roamingcomputers

    Args:
        page: Page number (default 1).
        limit: Max results per page (default 100, max 100).
        name: Filter by computer name (partial match).
        status: Filter by status.
        swg_status: Filter by Secure Web Gateway module status.
        last_sync_before: Only computers that last synced before this time.
        last_sync_after: Only computers that last synced after this time.
cisco_umbrella_list_applicationsA

List discovered cloud applications (App Discovery).

    API: GET /reports/v2/appDiscovery/applications

    Args:
        sources: Comma-separated data source filter, e.g. "dns,swg,cdfw".
        identity: Filter by identity (e.g. roaming computer or network) ID.
        labels: Comma-separated label filter.
        controllable: Filter to only applications with a controllable policy.
        categories: Comma-separated application category ID filter.
        subcategory: Filter by application subcategory.
        limit: Max results per page.
        offset: Pagination offset.
cisco_umbrella_list_protocolsA

List discovered network protocols (App Discovery).

    API: GET /reports/v2/appDiscovery/protocols

    Args:
        identity: Filter by identity (e.g. roaming computer or network) ID.
        limit: Max results per page.
        offset: Pagination offset.
        sort: Sort field — "firstDetected" or "lastDetected".
        order: Sort order — "asc" or "desc".
cisco_umbrella_list_application_categoriesB

List application categories (App Discovery).

    API: GET /reports/v2/appDiscovery/applicationCategories

    Args:
        limit: Max results per page (1-100).
        offset: Pagination offset.
cisco_umbrella_list_customersA

List customer organizations under this Umbrella Managed Provider (MSP) account.

    API: GET /admin/v2/managed/customers

    Args:
        page: Page number (default 1).
        limit: Max results per page (default 100, max 100).
cisco_umbrella_get_providers_consoleA

Get this Umbrella Managed Provider console's subscription/usage summary (package name, total/used seats, customer count, status, renewal/expiry dates). Not a list — returns a single object.

    API: GET /reports/v2/providers/consoles

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4/5.0

Scored across 10 tools

Disambiguation5/5

Each tool targets a distinct resource and action: four activity types (DNS, proxy, firewall, AMP), app discovery resources (applications, protocols, categories), roaming computers, and MSP-specific data (customers, console). No two tools appear to overlap in purpose.

Naming Consistency5/5

All tools follow a consistent cisco_umbrella_<verb>_<noun> pattern with snake_case. The verb varies logically: 'get' for single objects or specific activity endpoints, 'list' for collection endpoints. This is highly predictable.

Tool Count5/5

10 tools is well-scoped for an umbrella security API server: it covers several distinct functional areas (activity events, app discovery, roaming computers, MSP management) without becoming unwieldy. Each tool serves a clear purpose.

Completeness4/5

The set provides broad read-only access to multiple domains: activity reporting, app discovery, roaming computer lists, and MSP summary. It lacks individual item retrieval or management operations (e.g., get by ID, create/update/delete), but for a read-only reporting server this is a minor gap rather than a fatal one.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources