Illumio MCP Server

A Model Context Protocol (MCP) server that provides an interface to interact with Illumio PCE (Policy Compute Engine). This server enables

Remote serverstreamable-httpPython

What is the Illumio MCP Server?

A Model Context Protocol (MCP) server that provides an interface to interact with Illumio PCE (Policy Compute Engine). This server enables programmatic access to

Configuration

  • Python 3.8+ - Access to an Illumio PCE instance - Valid API credentials for the PCE

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get-workloadsRetrieve workloads with optional filtering by name, hostname, IP, labels, and max results
create-workloadCreate an unmanaged workload with name, IP addresses, and labels
update-workloadUpdate an existing workload's properties
delete-workloadRemove a workload from PCE
get-labelsRetrieve labels with optional filtering by key, value, and max results
create-labelCreate a new label with key-value pair
update-labelUpdate an existing label
delete-labelRemove a label
get-rulesetsGet rulesets with optional filtering by name, description, and enabled status
create-rulesetCreate a new ruleset with scopes
update-rulesetUpdate ruleset properties
delete-rulesetRemove a ruleset
create-deny-ruleCreate a deny rule (regular or override deny) in a ruleset
update-deny-ruleUpdate an existing deny rule
delete-deny-ruleRemove a deny rule
get-iplistsGet IP lists with optional filtering by name, description, FQDN, and max results
create-iplistCreate a new IP list
update-iplistUpdate an existing IP list
delete-iplistRemove an IP list
get-servicesGet services with optional filtering by name, port, protocol, and max results
create-serviceCreate a new service definition
update-serviceUpdate an existing service
delete-serviceRemove a service
get-traffic-flowsGet detailed traffic flow data with filtering by date range, source/destination, service, policy decision, and more
get-traffic-flows-summaryGet aggregated traffic summaries grouped by app, env, port, and protocol
create-ringfenceAutomated app-to-app segmentation policy creation. Analyzes traffic flows to discover which remote apps communicate with a target app, then creates a ruleset wi
Intrascope allow rule — all workloads within the app can communicate freely
Extrascope allow rules — each discovered remote app gets an allow rule on All Services
anydefault) — IP list Any (0.0.0.0/0) as consumer, deny only at destination. Safest.
amsAll Workloads as consumer, deny pushed to every managed workload. Broader.
ams_and_anyBoth. Maximum coverage.
Merge-safedetects existing rulesets and rules, never creates duplicates
Dryrun support — preview what would be created without making changes
identify-infrastructure-servicesDiscover which apps are infrastructure services by analyzing traffic patterns. Builds an app-to-app communication graph and uses dual-pattern scoring to recogni
provision-policyProvision pending draft changes to move them from draft to active state. Can provision all pending changes or specific items by href. Includes change descriptio
compare-draft-activeCompare draft vs active policy to preview what would change on provisioning. Shows created, updated, and deleted rulesets, rules, IP lists, and services.
enforcement-readinessAssess whether an app is ready for enforcement. Analyzes traffic flows, existing policy coverage, enforcement modes, and ringfence status. Returns a readiness s
ringfence-batchRingfence multiple apps at once. Optionally uses identify-infrastructure-services to auto-order apps by infrastructure score (infrastructure first, then standar
get-workload-enforcement-statusGet enforcement mode status across workloads, grouped by app and environment. Shows counts per mode (idle, visibility_only, selective, full) and identifies apps
get-policy-coverage-reportGenerate a policy coverage report for an app showing what traffic is covered by existing rules vs what would be blocked. Breaks down by inbound/outbound, identi
find-unmanaged-trafficFind traffic involving unmanaged workloads or IP addresses. These are sources/destinations without app/env labels, representing policy blind spots. Filters by d
detect-lateral-movement-pathsDetect potential lateral movement paths by analyzing app-to-app traffic patterns. Identifies articulation points (bridge nodes) whose compromise would provide a
compliance-checkCheck policy compliance against frameworks (PCI-DSS, NIST 800-53, CIS Controls, or general best practices). Evaluates segmentation, enforcement modes, high-risk
get-eventsGet PCE events with optional filtering by event type, severity, status, and result limits
check-pce-connectionVerify PCE connectivity and credentials

How to install the Illumio MCP Server

{
  "mcpServers": {
    "illumio-mcp-docker": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--init",
        "--rm",
        "-v",
        "/Users/YOUR_USERNAME/tmp:/var/log/illumio-mcp",
        "-e",
        "DOCKER_CONTAINER=true",
        "-e",
        "PYTHONWARNINGS=ignore",
        "--env-file",
        "/Users/YOUR_USERNAME/.illumio-mcp.env",
        "illumio-mcp:latest"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Python 3.8+ - Access to an Illumio PCE instance - Valid API credentials for the PCE

Frequently asked questions

A Model Context Protocol (MCP) server that provides an interface to interact with Illumio PCE (Policy Compute Engine). This server enables programmatic access to Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.