Skip to main content
Glama
MSPbotsAI

cisco-umbrella-mcp

by MSPbotsAI
OverviewSchemaRelated ServersScoreDiscussions
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)

Capabilities

Features and capabilities supported by this server

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

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/MSPbotsAI/cisco-umbrella-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server