Sophos Central MCP Server
The Sophos Central MCP Server enables AI-powered security operations management through natural language, covering multi-tenant endpoint protection, threat detection, XDR, email, firewall, and mobile security. Key capabilities include:
Authentication & Identity
Authenticate via OAuth2, discover entity type (partner/organization/tenant), and manage regional routing automatically.
Multi-Tenant & Partner Administration
List, create, update, and delete managed tenants, partner/tenant admins, roles, and permission sets.
Access billing usage, license entitlements, and distributor quotes.
Endpoint Security & Investigation
List, filter, isolate, de-isolate, scan, and delete endpoints (individually or in bulk).
Manage tamper protection, trigger on-demand scans, force software updates, and request forensic logs or memory dumps.
Configure Adaptive Attack Protection (AAP), manage peripheral devices, and migrate endpoints between tenants.
Endpoint Groups & Policy Management
CRUD operations on endpoint groups and manage group membership.
Create, update, clone, and delete endpoint policies (threat-protection, web-control, application-control, device-encryption, server policies, etc.).
Threat Detection & Response
Triage alerts: list, filter, acknowledge, and action them.
Run real-time forensic SQL queries on live endpoints via Live Discover.
Perform historical threat hunting against the Sophos XDR Data Lake.
Query, group, and count behavioral detections; create and manage investigation cases.
Email, Firewall & DNS Security
Manage email quarantine, list mailboxes, and perform post-delivery message clawback.
CRUD operations for firewalls, manage firewall groups, and handle firmware upgrades.
Configure DNS protection policies and custom domain allow/block lists.
Mobile Device Management (MDM)
List, get, create, update, and delete mobile devices (iOS, Android, macOS, Chrome, Windows).
View compliance violations, installed apps, GPS location, assigned policies, and IXM scan results.
Manage mobile device groups and trigger actions (sync, lock, wipe) on up to 50 devices at once.
Reporting, Audit & Compliance
Retrieve audit logs, health reports, and SIEM-ready event/alert exports.
Access user activity reports and session data.
SOC Playbooks & Automation
Built-in incident response, threat hunting, and EDR investigation playbooks.
Read-only mode and explicit gating for destructive operations ensure safe automation.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Sophos Central MCP Server Isolate host 'Server01' for suspected compromise"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Sophos Central MCP Server
For MSP/MSSP teams: Manage endpoint security, email threats, and firewall policy across all your Sophos tenants through natural language. Ask Claude to investigate an alert, isolate a host, run Live Discover queries, and correlate with XDR data — without leaving your AI workflow.
Overview
A Model Context Protocol (MCP) server for the Sophos Central API, enabling AI-powered security operations through Claude and other MCP-compatible clients. Designed for MSP/MSSP environments with Partner Super Admin credentials, it provides multi-tenant management across all customer tenants from a single server instance — covering endpoint protection, threat detection, Live Discover forensics, XDR hunting, email security, firewall management, and more.
Related MCP server: AlertLogic MCP Server
Features
334 tools across 33 API domains — comprehensive Sophos Central API coverage
Multi-tenant MSSP support — enumerate and target any customer tenant via Partner Super Admin credentials
Endpoint isolation and investigation — isolate endpoints, check tamper protection, trigger scans
Alert triage — list, filter, acknowledge, and action Sophos alerts across tenants
Live Discover SQL queries — run real-time forensic SQL queries directly on managed endpoints
XDR Data Lake hunting — historical threat hunting with SQL against the Sophos XDR data lake
Threat detections — query, group, and count behavioral detections
Case management — create and manage investigation cases end-to-end
Email security — quarantine management, mailbox listing, post-delivery message clawback
Firewall management — CRUD operations, group management, firmware upgrades
DNS protection — location policies, custom domain allow/block lists
SOC playbooks — built-in
sophos_playbook_*tools for guided IR and threat hunting workflowsThree transport modes — stdio (Claude Desktop), SSE, and Streamable HTTP (Claude Code)
Automatic OAuth2 token management — token refresh with no manual intervention
Regional routing — requests automatically routed to the correct data region (US, EU, CA, AU, JP, BR)
Prerequisites
Node.js v18 or later (native
fetchsupport required)npm v8 or later
Sophos Central Partner Super Admin API credentials — see Configuration for how to create these
Installation
git clone https://github.com/rijul170/sophos-central-mcp.git
cd sophos-central-mcp
npm install
npm run buildConfiguration
1. Create a .env file
cp .env.example .envEdit .env with your credentials:
# Required
SOPHOS_CLIENT_ID=your-client-id-here
SOPHOS_CLIENT_SECRET=your-client-secret-here
# Optional — transport mode: stdio | sse | streamable-http (default: stdio)
MCP_TRANSPORT=stdio
# Optional — host for HTTP transports (default: 127.0.0.1)
MCP_HOST=127.0.0.1
# Optional — port for HTTP transports (default: 3001)
MCP_PORT=30012. Create API Credentials in Sophos Central
Log in to Sophos Central Partner Dashboard
Navigate to Settings & Policies → API Credentials Management
Click Add Credential
Set the role to Service Principal Super Admin
Copy the Client ID and Client Secret — the secret is displayed only once
Variable | Required | Description |
| Yes | Partner Super Admin Client ID from Sophos Central |
| Yes | Corresponding client secret |
| No | Transport mode: |
| No | Bind host for HTTP transports (default: |
| No | Port for HTTP transports (default: |
| No | Set to |
| No | Destructive tools (deletes, endpoint isolation, Live Discover execution, clawback, ...) are suppressed by default. Set to |
Claude Code Integration (HTTP Mode)
HTTP mode is recommended for Claude Code — it supports concurrent sessions and does not require restarting the server between conversations.
Start the server:
MCP_TRANSPORT=streamable-http MCP_PORT=3001 node build/index.jsOr set MCP_TRANSPORT=streamable-http in your .env and run:
node build/index.jsAdd to your Claude Code MCP configuration (.claude/settings.json or global settings):
{
"mcpServers": {
"sophos-mcp": {
"type": "http",
"url": "http://localhost:3001/mcp"
}
}
}A /health endpoint is available at http://localhost:3001/health for liveness checks.
Claude Desktop Integration (stdio Mode)
stdio mode is the standard transport for Claude Desktop. The server process is managed by Claude Desktop directly.
Add to your Claude Desktop MCP configuration (claude_desktop_config.json):
{
"mcpServers": {
"sophos-mcp": {
"command": "node",
"args": ["/path/to/sophos-central-mcp/build/index.js"],
"env": {
"SOPHOS_CLIENT_ID": "your-client-id",
"SOPHOS_CLIENT_SECRET": "your-client-secret"
}
}
}
}Replace /path/to/sophos-central-mcp with the absolute path to your cloned repository.
SSE Mode
SSE (Server-Sent Events) mode is available for legacy MCP clients that do not support Streamable HTTP.
MCP_TRANSPORT=sse MCP_PORT=3001 node build/index.jsThe SSE endpoint is available at http://localhost:3001/sse.
Tool Domains
Domain | Tools | Description |
Alerts | 5 | List, get, acknowledge, and action Sophos alerts |
Endpoint | 26 | Isolation, tamper protection, scans, migrations, bulk operations |
Detections | 7 | Query-based behavioral detection search, grouping, and counts |
Live Discover | 11 | Real-time forensic SQL queries on managed endpoints |
XDR | 10 | Historical SQL hunting against the Sophos XDR Data Lake |
Cases | 9 | Investigation case create, read, update, close, and evidence management |
Partner | 23 | Tenant enumeration, admins, roles, billing, permission sets |
Organization | 2 | Tenant listing for organization-type accounts |
Policy | 7 | Full CRUD for all Sophos policy types |
Group | 8 | Endpoint group CRUD and member management |
SIEM | 2 | Events and alerts export for SIEM integration |
Firewall | 20 | Firewall CRUD, group management, firmware upgrades |
DNS Protection | 15 | Locations, policies, custom domain allow/block lists |
31 | Quarantine management, mailboxes, post-delivery message clawback | |
Directory | 15 | User and user group full CRUD |
Settings | 16 | Tamper protection, exclusions, web control, endpoint tags |
Allowed/Blocked | 12 | SHA256 hash, certificate, and path allow/block lists |
Exploit Mitigation | 8 | Application-level exploit protection exclusions |
IPS Exclusion | 10 | Network IPS and isolation exclusion management |
Tenant Admin | 14 | Tenant admin CRUD, role assignments, custom roles |
Account Health | 4 | Health check reports, snooze, and historical health scores |
Account Management | 4 | Account-level settings and license management |
Audit Events | 2 | Audit log retrieval for compliance and governance |
Business Automation | 3 | Automation rules and business logic configuration |
Licensing | 2 | License entitlement and usage queries |
Mobile | 38 | Mobile device management — enrollment, policies, device actions |
Cloud Security | 6 | Cloud workload protection posture and findings |
Software | 9 | Installer downloads, software inventory, packages |
Switch | 3 | Network switch management |
WiFi | 3 | Wireless network management |
User Activity | 2 | User activity reporting and session data |
Playbooks | 5 | SOC incident response and threat hunting workflow guides |
Auth | 2 | OAuth2 authentication and WhoAmI identity discovery |
MSSP Multi-Tenant Support
The server is built around Sophos Partner Super Admin credentials, which have visibility across all managed customer tenants.
How it works:
On startup, the server authenticates to Sophos Central using your Partner credentials and discovers your organization type (partner or organization).
Use
sophos_list_tenants(orsophos_list_org_tenantsfor organization accounts) to enumerate all managed tenants and their IDs.Pass the
tenantIdparameter to any tenant-scoped tool to target a specific customer environment.All API calls are automatically routed to the correct regional endpoint (US, EU, CA, AU, JP, BR) based on the tenant's data residency.
Example workflow:
1. sophos_list_tenants → get all tenant IDs and names
2. sophos_list_alerts → pass tenantId for a specific customer
3. sophos_isolate_endpoint → isolate an endpoint in that tenant
4. sophos_live_discover_run_query → run forensic SQL on the isolated hostSOC Playbooks
The server ships with five built-in playbook tools that provide structured, step-by-step guidance for common SOC workflows. These are designed to be invoked at the start of an investigation to orient the response.
Tool | Purpose |
| End-to-end IR playbook: triage → scope → contain → remediate |
| Hypothesis-driven and IOC-based threat hunting workflows |
| MITRE ATT&CK technique-to-Sophos-tool mapping |
| Reference guide for all 334 tools organized by SOC use case |
| EDR-specific investigation playbook for endpoint detections |
SOC Quick Start
Once the server is connected to Claude, you can use natural language to drive security operations. Example prompts:
Alert triage:
"List all critical and high severity open alerts for tenant
<tenant-id>from the last 24 hours, grouped by type."
Endpoint investigation:
"Isolate endpoint
<hostname>in tenant<tenant-id>, then run a Live Discover SQL query to list all running processes and active network connections."
XDR threat hunting:
"Run an XDR Data Lake query against tenant
<tenant-id>to find any PowerShell executions with encoded commands in the last 7 days."
MSSP overview:
"Enumerate all my managed tenants, then show me any tenants with open critical alerts."
Email security:
"Show me all quarantined messages for tenant
<tenant-id>in the last 48 hours and release any flagged as false positives."
Development
# Run with hot-reload (no build step required)
npm run dev
# Build TypeScript to JavaScript
npm run build
# Run the built server
npm start
# Inspect tools interactively with MCP Inspector
npx @modelcontextprotocol/inspector node build/index.jsProject Structure
src/
├── index.ts # Entry point — transport setup, registers all 33 modules
├── config.ts # Environment variable validation
├── auth/
│ └── auth-manager.ts # OAuth2 token management with auto-refresh
├── client/
│ ├── sophos-client.ts # HTTP client (retry, rate limiting, backoff)
│ └── tenant-router.ts # Tenant → regional API host mapping
├── tools/ # 33 tool files, 334 tools total
│ ├── auth-tools.ts # 2 tools
│ ├── partner-tools.ts # 23 tools
│ ├── organization-tools.ts # 2 tools
│ ├── endpoint-tools.ts # 26 tools
│ ├── group-tools.ts # 8 tools
│ ├── policy-tools.ts # 7 tools
│ ├── alert-tools.ts # 5 tools
│ ├── detections-tools.ts # 7 tools
│ ├── siem-tools.ts # 2 tools
│ ├── xdr-tools.ts # 10 tools
│ ├── live-discover-tools.ts # 11 tools
│ ├── firewall-tools.ts # 20 tools
│ ├── dns-protection-tools.ts # 15 tools
│ ├── email-tools.ts # 31 tools
│ ├── directory-tools.ts # 15 tools
│ ├── settings-tools.ts # 16 tools
│ ├── allowed-blocked-tools.ts # 12 tools
│ ├── exploit-mitigation-tools.ts # 8 tools
│ ├── ips-exclusion-tools.ts # 10 tools
│ ├── tenant-admin-tools.ts # 14 tools
│ ├── account-health-tools.ts # 4 tools
│ ├── cases-tools.ts # 9 tools
│ ├── software-tools.ts # 9 tools
│ ├── audit-events-tools.ts # 2 tools
│ ├── business-automation-tools.ts # 3 tools
│ ├── licensing-tools.ts # 2 tools
│ ├── mobile-tools.ts # 38 tools
│ ├── switch-tools.ts # 3 tools
│ ├── wifi-tools.ts # 3 tools
│ ├── cloud-security-tools.ts # 6 tools
│ ├── user-activity-tools.ts # 2 tools
│ ├── account-management-tools.ts # 4 tools
│ └── playbook-tools.ts # 5 tools
└── types/
└── sophos-types.ts # TypeScript interfaces for all Sophos API typesSecurity Considerations
Read-only mode — set
SOPHOS_MCP_READONLY=trueto register only read tools at startup. Write and destructive tools are never exposed to the AI client, regardless of what is asked. XDR Data Lake and detections queries stay available (they are read analytics); Live Discover does not (it executes osquery on managed endpoints).Destructive operation gating — even with writes enabled, destructive tools (endpoint isolation, deletes, email clawback, Live Discover execution, firmware upgrades, ...) are suppressed by default. Arm them explicitly via
SOPHOS_MCP_ALLOW_DESTRUCTIVE. The recommended approach is a comma-separated list of specific tool names rather thantrue:# Enable only endpoint isolation for IR workflows SOPHOS_MCP_ALLOW_DESTRUCTIVE=sophos_isolate_endpoint,sophos_deisolate_endpointTool annotations — every tool carries MCP
readOnlyHint/destructiveHintannotations so compliant clients can apply their own confirmation policies.Credential handling — API credentials are read from environment variables at startup and are never logged or transmitted except to the Sophos authentication endpoint. Do not commit
.envfiles to source control —.envis listed in.gitignore.Partner Super Admin scope — these credentials have read/write access across all managed tenants. Treat them with the same care as privileged service account credentials. Rotate them immediately if compromised.
Read-only operations where possible — where your use case only requires visibility (alert triage, threat hunting, reporting), consider creating a separate credential with a more restricted role. Partner Super Admin is required only for write operations (isolation, policy changes, user management).
Network binding — HTTP transports default to
127.0.0.1. Do not expose the MCP server port publicly. If you need remote access, put it behind an authenticated reverse proxy or use a VPN.Audit trail — all Sophos API calls made through this server are logged in Sophos Central's audit events, attributable to the API credential used.
Related MCP Servers
These three servers cover complementary layers of a security stack — network/log (AlertLogic), endpoint protection (Sophos), and EDR/threat intel (CrowdStrike). Use them together for full-stack AI-powered SOC operations.
Server | Platform | Highlights |
CrowdStrike Falcon | EDR telemetry, RTR, threat intel, MSSP Flight Control, 1,296 tools | |
Sophos Central | Endpoint isolation, Live Discover SQL, XDR, email/firewall/DNS, 334 tools | |
Alert Logic MDR | Incident response, SQL log search, SOAR, vulnerability management, 473 tools |
License
MIT
Available Tools
234 toolssophos_accept_migrationA
Accept an endpoint migration job on the receiving tenant using the job token generated by the sending tenant. This completes the migration transfer.
Inputs: token (required), tenant_id (required), migration_job_id (required), endpoint_ids.
sophos_acknowledge_alertA
Acknowledge a specific alert. Convenience shortcut — equivalent to sophos_take_alert_action with action='acknowledge'.
Inputs: alert_id (required), tenant_id (required), message.
sophos_add_endpoints_to_groupA
Add one or more endpoints to an endpoint group. The endpoints will inherit any policies assigned to the group.
Inputs: group_id (required), tenant_id (required), endpoint_ids (required).
sophos_add_software_packageA
Add a static software package to the tenant's available package set so it can be assigned to endpoints.
Inputs: tenant_id (required), package_id (required).
sophos_add_users_to_groupC
Add one or more users to a directory user group.
Inputs: group_id (required), user_ids (required), tenant_id (required).
sophos_add_user_to_groupsB
Add a user to one or more directory user groups.
Inputs: user_id (required), group_ids (required), tenant_id (required).
sophos_approve_firewallA
Approve a pending firewall for Sophos Central management.
Inputs: tenant_id (required), firewall_id (required).
sophos_authenticateARead-only
Authenticate to Sophos Central using OAuth2 client credentials and obtain a JWT access token. The token is managed automatically and refreshed as needed. Call this first to verify credentials are working. Returns success status and authentication state.
Inputs: no named parameters.
sophos_bulk_add_mailboxesC
Add multiple mailboxes to email protection in a single request.
Inputs: items (required), tenant_id (required).
sophos_cancel_live_query_runA
Cancel a running or pending Live Discover query run. Uses POST to the /cancel sub-resource.
Inputs: run_id (required), tenant_id (required).
sophos_cancel_xdr_query_runB
Cancel a running or pending XDR query run. Uses POST to the /cancel sub-resource.
Inputs: run_id (required), tenant_id (required).
sophos_check_firmware_upgradesBRead-only
Check if firmware upgrades are available for the specified managed firewalls.
Inputs: tenant_id (required), firewall_ids (required).
sophos_create_admin_role_assignmentB
Assign a role to a tenant admin.
Inputs: role_id (required), admin_id (required), tenant_id (required).
sophos_create_allowed_itemB
Add a globally allowed item. For 'sha256' type supply sha256. For 'path' type supply fileName and optionally path. For 'certificateSigner' type supply certificateSigner.
Inputs: type (required), comment (required), tenant_id (required), path, +5 more.
sophos_create_blocked_itemA
Block an item by SHA256 hash globally. Optionally include filename and path for context.
Inputs: sha256 (required), comment (required), tenant_id (required), path, +1 more.
sophos_create_caseB
Create a new investigation case.
Inputs: name (required), tenant_id (required), type, status, +6 more.
sophos_create_cloud_security_profileA
Create a new cloud security runtime detection profile, or create a new version of an existing profile. Provide 'name' when creating a new profile; provide 'profile_id' when adding a new version to an existing profile. Use sophos_list_cloud_security_default_contents to get available content versions.
Inputs: tenant_id (required), content_version (required), name, profile_id, +3 more.
sophos_create_endpoint_groupA
Create a new endpoint group in a tenant. Groups organize endpoints by type (computer or server) and can be used for targeted policy assignment.
Inputs: name (required), type (required), tenant_id (required), description.
sophos_create_exclusionB
Create a new global scanning exclusion. The 'value' is the exclusion path/process/URL. The 'comment' field documents the reason.
Inputs: type (required), value (required), tenant_id (required), comment, +1 more.
sophos_create_exploit_mitigation_appA
Add a custom application to exploit mitigation monitoring. Provide one or more executable paths (supports environment variable prefixes like $programfiles).
Inputs: paths (required), tenant_id (required).
sophos_create_firewall_groupB
Create a new firewall group. At least one firewall UUID must be assigned at creation.
Inputs: name (required), tenant_id (required), assign_firewalls (required), parent_group_id, +1 more.
sophos_create_ips_exclusionA
Create an IPS exclusion to exempt specific traffic from intrusion prevention scanning. Direction must be 'inbound' or 'outbound'. Remote addresses is a comma-separated list of IPs/URLs.
Inputs: direction (required), tenant_id (required), comment, local_ports, +2 more.
sophos_create_isolation_exclusionA
Create an isolation exclusion so specific traffic can pass through even when an endpoint is network-isolated. Direction must be 'inbound' or 'outbound'.
Inputs: direction (required), tenant_id (required), comment, local_ports, +2 more.
sophos_create_mailboxB
Add a single mailbox to email protection.
Inputs: type (required), email (required), tenant_id (required), name.
sophos_create_mdr_threat_feed_indicatorsA
Add threat indicators (IOCs) to a firewall's MDR threat feed. Indicators can be IPv4 addresses, domain names, or URLs.
Inputs: tenant_id (required), indicators (required), firewall_id (required).
sophos_create_mobile_app_groupB
Create a new mobile app group. Provide a name, target platform, and a JSON array of app objects to include in the group.
Inputs: name (required), platform (required), apps_json (required), tenant_id (required).
sophos_create_mobile_deviceC
Register a new mobile device in Sophos Mobile MDM. Requires device name, ownership type (corporate/employee), and platform (iOS, macOS, android, chrome, windows).
Inputs: name (required), platform (required), tenant_id (required), ownership_type (required), +6 more.
sophos_create_mobile_device_propertyA
Add a custom property (key/value pair) to a mobile device. The key must follow the pattern 'custom.'.
Inputs: key (required), value (required), device_id (required), tenant_id (required).
sophos_create_partner_admin_role_assignmentA
Assign a role to a partner admin (add a role to an admin's existing role set).
Inputs: role_id (required), admin_id (required).
sophos_create_partner_roleB
Create a new partner-level role with the specified name and permission sets.
Inputs: name (required), description, permission_set_ids.
sophos_create_policyA
Create a new endpoint policy. Specify the policy type, name, and optionally priority, enabled state, and settings as a JSON string.
Inputs: name (required), type (required), tenant_id (required), enabled, +2 more.
sophos_create_tenantA
Create a new tenant under this Sophos Central Partner account. Requires tenant name, data geography, billing type, and primary contact details.
Inputs: name (required), email (required), last_name (required), first_name (required), +3 more.
sophos_create_tenant_adminA
Create an administrator for a specific managed tenant using the partner-level endpoint. The admin will receive an invitation email.
Inputs: email (required), last_name (required), tenant_id (required), first_name (required), +1 more.
sophos_create_tenant_roleA
Create a custom role in a tenant. Use sophos_list_tenant_permission_sets to discover available permission set IDs.
Inputs: name (required), tenant_id (required), permission_set_ids (required), description.
sophos_create_userB
Create a new directory user in a tenant.
Inputs: email (required), last_name (required), tenant_id (required), first_name (required), +1 more.
sophos_create_user_attestationA
Create a user activity attestation — push a security question to a user's Intercept X for Mobile device. Use this to verify whether suspicious activity (e.g. an unexpected login) was performed by the legitimate user. The user receives the question on their mobile device and selects an answer option. Poll the attestation status using sophos_get_user_attestation. Status values: 'pending' (awaiting response), 'completed' (user answered), 'expired' (timed out).
Inputs: user_id (required), tenant_id (required), title_text (required), question_text (required), +6 more.
sophos_create_user_groupA
Create a new directory user group.
Inputs: name (required), tenant_id (required), description.
sophos_create_web_control_local_siteA
Create a Web Control local site override to allow or block a specific URL/domain. categoryId is an integer from the categories list.
Inputs: url (required), tenant_id (required), category_id (required), comment.
sophos_dns_create_custom_domainA
Create a custom domain list for DNS Protection. The list is assigned as allowed or blocked on a policy (via sophos_dns_create_policy or sophos_dns_update_policy), not typed here.
Inputs: name (required), domains (required), tenant_id (required), description.
sophos_dns_create_locationB
Create a new DNS Protection location. Provide either IP addresses or domain names (combined total max 100).
Inputs: name (required), tenant_id (required), type, label, +6 more.
sophos_dns_create_policyA
Create a new DNS Protection policy with category filtering, allowed/blocked custom domain lists, and safe-search settings.
Inputs: name (required), tenant_id (required), description, location_ids, +8 more.
sophos_dns_get_custom_domainBRead-only
Get a specific custom domain list.
Inputs: tenant_id (required), custom_domain_id (required).
sophos_dns_get_locationBRead-only
Get details for a specific DNS Protection location.
Inputs: tenant_id (required), location_id (required).
sophos_dns_get_policyARead-only
Get details for a specific DNS Protection policy.
Inputs: policy_id (required), tenant_id (required).
sophos_dns_list_custom_domainsBRead-only
List custom domain lists (allowed/blocked) for DNS Protection.
Inputs: tenant_id (required), name, page, sort, +4 more.
sophos_dns_list_locationsARead-only
List all DNS Protection locations for a tenant.
Inputs: tenant_id (required), name, page, sort, +7 more.
sophos_dns_list_policiesBRead-only
List all DNS Protection policies for a tenant.
Inputs: tenant_id (required), name, page, sort, +3 more.
sophos_dns_update_custom_domainB
Update a custom domain list (name, description, or domains).
Inputs: tenant_id (required), custom_domain_id (required), name, domains, +1 more.
sophos_dns_update_locationA
Update a DNS Protection location. Send an empty array for ip_addresses or domain_names to clear them.
Inputs: tenant_id (required), location_id (required), name, type, +7 more.
sophos_dns_update_policyA
Update a DNS Protection policy. For array fields (locationIds, allowedCustomDomainIds, etc.) send a full replacement array, null to clear, or an add/remove object.
Inputs: policy_id (required), tenant_id (required), name, description, +9 more.
sophos_download_post_delivery_quarantine_attachmentsARead-only
Initiate a download job for attachments from a post-delivery quarantined message. Returns a downloadId for status polling.
Inputs: tenant_id (required), message_id (required), attachments (required).
sophos_download_quarantine_attachmentsBRead-only
Initiate a download job for attachments from a pre-delivery quarantined message. Returns a downloadId for status polling.
Inputs: tenant_id (required), message_id (required), attachments (required).
sophos_export_xdr_query_resultsARead-only
Export the full results of a completed XDR query run. Returns a download URL or streamed content for bulk result export.
Inputs: run_id (required), tenant_id (required).
sophos_get_account_healthARead-only
Get account health check report for a tenant. Shows protection coverage, policy compliance, and configuration issues across endpoints and network devices.
Inputs: tenant_id (required), checks, products.
sophos_get_alertARead-only
Get the full details of a specific alert by ID, including its allowedActions list.
Inputs: alert_id (required), tenant_id (required).
sophos_get_allowed_itemARead-only
Get details for a specific globally allowed item.
Inputs: tenant_id (required), allowed_item_id (required).
sophos_get_audit_eventARead-only
Get the full details of a specific audit event by its ID, including the actor, action performed, affected resource, and timestamp.
Inputs: event_id (required), tenant_id (required).
sophos_get_blocked_itemARead-only
Get details for a specific globally blocked item.
Inputs: tenant_id (required), blocked_item_id (required).
sophos_get_caseARead-only
Get full details for a specific case/investigation by ID.
Inputs: case_id (required), tenant_id (required).
sophos_get_case_detectionARead-only
Get a specific detection within a case by detection ID.
Inputs: case_id (required), tenant_id (required), detection_id (required).
sophos_get_case_impacted_entitiesARead-only
Get impacted entities (endpoints, users, etc.) associated with a case.
Inputs: case_id (required), tenant_id (required), name, page, +4 more.
sophos_get_case_mitre_summaryARead-only
Get the MITRE ATT&CK framework summary for a case — tactics and techniques observed across all associated detections.
Inputs: case_id (required), tenant_id (required).
sophos_get_cloud_security_profileARead-only
Get details of a specific cloud security runtime detection profile, including its override settings (rules and lists). Optionally retrieve a specific version of the profile.
Inputs: tenant_id (required), profile_id (required), version.
sophos_get_detected_exploitARead-only
Get details for a specific detected exploit event.
Inputs: tenant_id (required), detected_exploit_id (required).
sophos_get_detection_countsARead-only
Get detection counts grouped by severity and type over a time range. Returns per-hour or per-day buckets.
Inputs: tenant_id (required), type, source, to_date, +8 more.
sophos_get_detections_group_query_statusARead-only
Get the status of a running detection-groups query. Poll until status is 'finished'.
Inputs: run_id (required), tenant_id (required).
sophos_get_detections_group_resultsARead-only
Get results of a completed detection-groups query. Each item represents a group of similar detections with a count, detection rule, MITRE ATT&CK tags, and device info.
Inputs: run_id (required), tenant_id (required), page, page_size.
sophos_get_detections_query_resultsARead-only
Get results of a completed detections query. Only call after sophos_get_detections_query_status returns status='finished'.
Inputs: run_id (required), tenant_id (required), page, page_size.
sophos_get_detections_query_statusARead-only
Get the status of a running detections query. Poll until status is 'finished'. Result will be 'succeeded' or 'failed'.
Inputs: run_id (required), tenant_id (required).
sophos_get_endpoint_groupARead-only
Get details of a specific endpoint group, including its name, description, type, and endpoint count.
Inputs: group_id (required), tenant_id (required).
sophos_get_exclusionARead-only
Get details for a specific global scanning exclusion.
Inputs: tenant_id (required), exclusion_id (required).
sophos_get_exploit_mitigation_appARead-only
Get details for a specific exploit mitigation application, including its protection settings.
Inputs: tenant_id (required), application_id (required).
sophos_get_firewall_groupARead-only
Get details for a specific firewall group.
Inputs: group_id (required), tenant_id (required).
sophos_get_firewall_group_sync_statusB
Get the synchronisation status of firewalls in a firewall group.
Inputs: group_id (required), tenant_id (required), page, page_size, +2 more.
sophos_get_firewall_licensesARead-only
Get firewalls and their licenses for a Sophos Central tenant or partner. Provide either tenant_id (for tenant context) or partner_id (for partner context), but not both.
Inputs: page, sort, page_size, tenant_id, +2 more.
sophos_get_firewall_transactionARead-only
Poll the status/result of an asynchronous firewall-config operation (e.g. MDR threat-feed retrieval). Use the transactionId returned by the originating call.
Inputs: tenant_id (required), firewall_id (required), transaction_id (required), fields.
sophos_get_forensic_log_statusARead-only
Get the status of a forensic log collection request previously initiated with sophos_request_forensic_logs.
Inputs: tenant_id (required), endpoint_id (required), forensic_log_request_id (required).
sophos_get_global_tamper_protectionARead-only
Get the global tamper protection on/off switch for a tenant. For per-endpoint tamper protection passwords, use sophos_get_tamper_protection.
Inputs: tenant_id (required).
sophos_get_health_scores_historyARead-only
Get historical account health check scores for a tenant to track improvement over time.
Inputs: tenant_id (required), end_date, start_date.
sophos_get_installer_downloadsBRead-only
Get available Sophos agent installer download links for specified products and platforms.
Inputs: tenant_id (required), platforms, requested_products.
sophos_get_ips_exclusionBRead-only
Get details for a specific IPS exclusion.
Inputs: tenant_id (required), exclusion_id (required).
sophos_get_isolation_exclusionARead-only
Get details for a specific isolation exclusion.
Inputs: tenant_id (required), exclusion_id (required).
sophos_get_live_query_categoryARead-only
Get details for a specific Live Discover query category by its category ID.
Inputs: tenant_id (required), category_id (required).
sophos_get_live_query_endpoint_statusesARead-only
Get per-endpoint execution status for a Live Discover query run. Shows which endpoints responded, are still running, or failed.
Inputs: run_id (required), tenant_id (required), page, page_size, +1 more.
sophos_get_live_query_resultsARead-only
Retrieve the results of a completed Live Discover query run. Uses key-based pagination: pass the nextKey from the previous response as page_from_key to get the next page.
Inputs: run_id (required), tenant_id (required), page_size, page_total, +1 more.
sophos_get_live_query_statusARead-only
Check the status of a previously submitted Live Discover query run. Status values: pending | started | finished. Result values: notAvailable | succeeded | failed | timedOut.
Inputs: run_id (required), tenant_id (required).
sophos_get_mailboxBRead-only
Get details for a specific mailbox by ID.
Inputs: tenant_id (required), mailbox_id (required).
sophos_get_mdr_threat_feedARead-only
Retrieve the MDR threat-feed configuration for a specific firewall. Returns a transactionId — poll sophos_get_firewall_transaction with that ID to retrieve the result.
Inputs: tenant_id (required), firewall_id (required).
sophos_get_memory_dump_statusARead-only
Get the status of a memory dump request previously initiated with sophos_request_memory_dump.
Inputs: tenant_id (required), endpoint_id (required), memory_dump_request_id (required).
sophos_get_migration_jobARead-only
Get the status and details of a specific endpoint migration job.
Inputs: tenant_id (required), migration_job_id (required).
sophos_get_mobile_actionBRead-only
Get details for a specific MDM action by its ID.
Inputs: action_id (required), tenant_id (required).
sophos_get_mobile_app_groupARead-only
Get details for a specific mobile app group by its ID.
Inputs: tenant_id (required), app_group_id (required).
sophos_get_mobile_deviceARead-only
Get full details for a specific mobile device by its ID, including compliance status, installed apps, platform, and assigned policies.
Inputs: device_id (required), tenant_id (required), fields.
sophos_get_mobile_device_groupARead-only
Get details for a specific mobile device group by its ID.
Inputs: group_id (required), tenant_id (required).
sophos_get_mobile_ixm_enrollmentBRead-only
Get static setup data for IXM (Intercept X for Mobile) auto-enrollment, including the connection code required to enroll the IXM app.
Inputs: tenant_id (required).
sophos_get_mobile_operating_systemARead-only
Get details for a specific mobile operating system by its ID.
Inputs: os_id (required), tenant_id (required).
sophos_get_partner_adminBRead-only
Get details for a specific partner-level administrator.
Inputs: admin_id (required).
sophos_get_partner_levelARead-only
Return partner level information for a distributor's partners. Filters by billing sub-region and optionally by name, update date, or EDI number.
Inputs: distributor_id (required), billing_sub_region (required), name, page, +3 more.
sophos_get_partner_roleARead-only
Get details for a specific partner role.
Inputs: role_id (required).
sophos_get_post_delivery_quarantine_download_statusARead-only
Get the status of a post-delivery quarantine attachment download job.
Inputs: tenant_id (required), download_id (required).
sophos_get_quarantine_download_statusARead-only
Get the status of a quarantine attachment download job initiated by sophos_download_quarantine_attachments.
Inputs: tenant_id (required), download_id (required).
sophos_get_quarantine_messageBRead-only
Get details for a specific pre-delivery quarantined message by ID.
Inputs: tenant_id (required), message_id (required).
sophos_get_quarantine_message_urlsARead-only
Get URLs found in a pre-delivery quarantined message.
Inputs: tenant_id (required), message_id (required).
sophos_get_quoteARead-only
Get full details for a specific Sophos Business Automation quote by proposal number.
Inputs: distributor_id (required), proposal_number (required).
sophos_get_recommended_packagesARead-only
Get the recommended (latest stable) Sophos software package versions for each supported platform.
Inputs: tenant_id (required).
sophos_get_regional_health_scoresARead-only
Get account health score comparisons against regional peers. Useful for benchmarking your tenant's security posture against similar tenants in your region.
Inputs: tenant_id (required).
sophos_get_saved_live_queryARead-only
Get full details of a specific saved Live Discover query by its query ID.
Inputs: query_id (required), tenant_id (required).
sophos_get_siem_alertsARead-only
Retrieve alerts from the Sophos SIEM API for integration with external SIEM systems. Alerts are from the last 24 hours only. Use the cursor from the response (next_cursor) to paginate; check has_more to know if more pages exist.
Inputs: tenant_id (required), limit, cursor, from_date.
sophos_get_siem_eventsARead-only
Retrieve security events from the Sophos SIEM API for integration with external SIEM systems. Events are from the last 24 hours only. Use the cursor from the response (next_cursor) to paginate; check has_more to know if more pages exist.
Inputs: tenant_id (required), limit, cursor, from_date, +1 more.
sophos_get_software_commentARead-only
Get the user comment for a specific static software package.
Inputs: tenant_id (required), package_id (required).
sophos_get_software_packageARead-only
Get details for a specific static software package by ID.
Inputs: tenant_id (required), package_id (required).
sophos_get_switch_mac_filterARead-only
Retrieve the MAC filter settings for a tenant's managed switches. The MAC filter allows or blocks devices connected to the switch by their MAC addresses.
Inputs: tenant_id (required).
sophos_get_tenantARead-only
Get details for a specific managed tenant by ID, including its regional API host.
Inputs: tenant_id (required).
sophos_get_tenant_adminBRead-only
Get details for a specific tenant administrator.
Inputs: admin_id (required), tenant_id (required).
sophos_get_tenant_roleBRead-only
Get details for a specific tenant role.
Inputs: role_id (required), tenant_id (required).
sophos_get_tls_decryption_settingsARead-only
Get Web Control TLS decryption settings (which categories have decryption enabled).
Inputs: tenant_id (required).
sophos_get_userARead-only
Get details for a specific directory user.
Inputs: user_id (required), tenant_id (required).
sophos_get_user_attestationARead-only
Get the current status and details of a user activity attestation by its ID. Poll this after creating an attestation to check whether the user has responded. Status values: 'pending' (user has not answered yet), 'completed' (user selected an option — see 'selectedOption'), 'expired' (user did not respond before the timeout).
Inputs: tenant_id (required), attestation_id (required), fields.
sophos_get_user_groupBRead-only
Get details for a specific user group.
Inputs: group_id (required), tenant_id (required).
sophos_get_web_control_local_siteARead-only
Get details for a specific Web Control local site override.
Inputs: tenant_id (required), local_site_id (required).
sophos_get_wifi_mac_filterARead-only
Retrieve the MAC filter settings for a tenant's managed Wi-Fi access points. The MAC filter allows or blocks devices connecting to access points by their MAC addresses.
Inputs: tenant_id (required).
sophos_get_xdr_queryARead-only
Get details for a specific saved XDR query template by its query ID.
Inputs: query_id (required), tenant_id (required).
sophos_get_xdr_query_resultsARead-only
Retrieve the results of a completed XDR query run. Uses key-based pagination: pass the nextKey from the previous response as page_from_key to get the next page.
Inputs: run_id (required), tenant_id (required), page_size, page_total, +1 more.
sophos_get_xdr_query_statusARead-only
Check the status of a previously submitted XDR query run. Status values: pending | started | finished. Result values: notAvailable | succeeded | failed | timedOut | canceled.
Inputs: run_id (required), tenant_id (required).
sophos_invite_tenant_adminB
Invite a new administrator to a specific tenant via the common API (/common/v1/admins). The admin will receive an invitation email.
Inputs: email (required), role_id (required), last_name (required), tenant_id (required), +1 more.
sophos_list_admin_role_assignmentsBRead-only
List role assignments for a specific tenant admin.
Inputs: admin_id (required), tenant_id (required).
sophos_list_alertsBRead-only
List alerts from Sophos Central for a given tenant, with optional severity, product, category, date range, and pagination filters.
Inputs: tenant_id (required), ids, sort, product, +7 more.
sophos_list_allowed_itemsARead-only
List all globally allowed items (SHA256 hashes, certificate signers, file paths) for a tenant.
Inputs: tenant_id (required), page, page_size.
sophos_list_audit_eventsARead-only
List audit trail events for a Sophos Central tenant. Covers admin actions, policy changes, user logins, and configuration modifications. Supports filtering by date range, category, user, and cursor-based pagination.
Inputs: tenant_id (required), cursor, to_date, user_id, +4 more.
sophos_list_blocked_addressesBRead-only
List globally blocked IP addresses and ranges for a tenant.
Inputs: tenant_id (required), page, sort, page_size.
sophos_list_blocked_itemsARead-only
List all globally blocked items (SHA256 hashes) for a tenant.
Inputs: tenant_id (required), page, page_size.
sophos_list_case_detectionsBRead-only
List all detections associated with a case.
Inputs: case_id (required), tenant_id (required), page, sort, +1 more.
sophos_list_casesARead-only
List all cases/investigations for a tenant with rich filtering options.
Inputs: tenant_id (required), name, page, sort, +11 more.
sophos_list_cloud_security_default_contentsARead-only
List all available default content versions that can be used when creating or versioning a cloud security runtime detection profile. Returns the content ID and version string for each available content package.
Inputs: tenant_id (required).
sophos_list_cloud_security_profilesARead-only
List all cloud security runtime detection profiles for a tenant (latest versions). Profiles define detection rules and allow/block lists applied to cloud workloads.
Inputs: tenant_id (required), page, page_size, search_term.
sophos_list_detected_exploitsARead-only
List exploit attempts detected by exploit mitigation. Optionally exclude specific exploit thumbprints.
Inputs: tenant_id (required), page, page_size, thumbprint_not_in.
sophos_list_downloadsBRead-only
Get available software installer download links for a tenant. Returns URLs for licensed Sophos products. Optionally filter by product name or platform.
Inputs: tenant_id (required), platforms, requested_products.
sophos_list_endpointsARead-only
List endpoints in a Sophos Central tenant with optional filtering by type, health status, tamper protection, hostname, or free-text search. Returns paginated results.
Inputs: tenant_id (required), type, view, fields, +13 more.
sophos_list_exclusionsARead-only
List global scanning exclusions for a tenant. Optionally filter by exclusion type (path, process, web, pua, amsi, behavioral, certificateSigner).
Inputs: tenant_id (required), page, type, page_size.
sophos_list_exploit_mitigation_appsARead-only
List exploit mitigation applications and their protection status. Filter by type ('detected' for auto-detected, 'custom' for manually added) or by modification date.
Inputs: tenant_id (required), page, type, modified, +1 more.
sophos_list_exploit_mitigation_categoriesARead-only
List exploit mitigation categories (the types of exploits that can be individually enabled/disabled per application).
Inputs: tenant_id (required).
sophos_list_firewall_groupsARead-only
List all firewall groups in a tenant.
Inputs: tenant_id (required), page, search, page_size, +3 more.
sophos_list_firewallsBRead-only
List all managed firewalls in a Sophos Central tenant.
Inputs: tenant_id (required), page, search, group_id, +2 more.
sophos_list_ips_exclusionsBRead-only
List intrusion prevention system (IPS) exclusions for a tenant (traffic excluded from IPS scanning).
Inputs: tenant_id (required), page, page_size.
sophos_list_isolation_exclusionsARead-only
List isolation exclusions (IP/port combinations that remain reachable when an endpoint is network-isolated).
Inputs: tenant_id (required), page, page_size.
sophos_list_live_query_categoriesARead-only
List Live Discover query categories available for the tenant.
Inputs: tenant_id (required).
sophos_list_live_query_runsARead-only
List all Live Discover query runs (history) with optional filtering by status, result, or saved query ID.
Inputs: tenant_id (required), result, status, query_id, +3 more.
sophos_list_mailboxesARead-only
List email mailboxes in a tenant with optional filters.
Inputs: tenant_id (required), name, type, email, +7 more.
sophos_list_migration_endpointsARead-only
List the endpoints included in a specific endpoint migration job and their migration status.
Inputs: tenant_id (required), migration_job_id (required).
sophos_list_mobile_app_groupsARead-only
List mobile app groups (managed app collections) in a Sophos Mobile tenant.
Inputs: tenant_id (required), page, search, platform, +1 more.
sophos_list_mobile_device_groupsBRead-only
List mobile device groups in a Sophos Mobile tenant.
Inputs: tenant_id (required), page, sort, search, +1 more.
sophos_list_mobile_device_policiesARead-only
List MDM policies assigned to a specific mobile device.
Inputs: device_id (required), tenant_id (required), page, page_size.
sophos_list_mobile_devicesBRead-only
List mobile devices enrolled in Sophos Mobile for a tenant. Supports filtering by platform, management type, compliance status, health state, ownership, device groups, and date ranges. Returns paginated results.
Inputs: tenant_id (required), page, sort, fields, +15 more.
sophos_list_mobile_operating_systemsARead-only
List mobile operating systems known to Sophos Mobile, with optional filtering by platform or version prefix.
Inputs: tenant_id (required), page, version, platform, +1 more.
sophos_list_policy_endpointsBRead-only
List the endpoints or endpoint groups governed by a specific policy.
Inputs: policy_id (required), tenant_id (required), page_key, page_size.
sophos_list_post_delivery_quarantine_attachmentsBRead-only
List attachments of a post-delivery quarantined message.
Inputs: tenant_id (required), message_id (required).
sophos_list_quarantine_attachmentsARead-only
List attachments of a pre-delivery quarantined message.
Inputs: tenant_id (required), message_id (required).
sophos_list_quotesARead-only
List distributor quotes from the Sophos Business Automation API. Only approved quotes are returned. Requires a Distributor ID.
Inputs: distributor_id (required), page, type, page_size, +10 more.
sophos_list_role_assignmentsBRead-only
List all admins assigned to a specific partner role.
Inputs: role_id (required).
sophos_list_saved_live_queriesBRead-only
List saved Live Discover queries available for the tenant.
Inputs: tenant_id (required), page_size, page_from_key.
sophos_list_software_commentsCRead-only
List user-added comments for all static software packages in a tenant.
Inputs: tenant_id (required).
sophos_list_software_packagesARead-only
List available static (fixed-version) software packages. Supports filtering by endpoint type, platform, package type, and date ranges.
Inputs: tenant_id (required), sort, type, platform, +5 more.
sophos_list_switch_tasksARead-only
List management tasks for the tenant's switches, with optional filtering by policy type and pagination. Tasks represent configuration changes pushed to managed switches.
Inputs: tenant_id (required), page, type, fields, +2 more.
sophos_list_tenant_adminsBRead-only
List all administrators for a specific managed tenant using the partner-level endpoint. For tenant-scoped admin management (common/v1), use the tenant admin tools instead.
Inputs: tenant_id (required).
sophos_list_tenant_admins_pagedARead-only
List administrators for a specific tenant with pagination support. Alias of sophos_list_tenant_admins that exposes pageSize and pageFromKey.
Inputs: tenant_id (required), page_key, page_size.
sophos_list_tenant_permission_setsARead-only
List all permission sets available at the tenant level. Use the returned IDs when creating custom roles.
Inputs: tenant_id (required).
sophos_list_tenant_rolesARead-only
List all roles available in a tenant.
Inputs: tenant_id (required).
sophos_list_tenantsARead-only
List all tenants managed by this Sophos Central Partner account. Returns tenant ID, name, data region, billing type, and regional API host for each tenant.
Inputs: page_size.
sophos_list_tls_excluded_websitesARead-only
List websites excluded from TLS decryption inspection.
Inputs: tenant_id (required), page, page_size.
sophos_list_user_groupsARead-only
List user groups in a tenant's directory.
Inputs: tenant_id (required), search, page_key, page_size.
sophos_list_usersBRead-only
List directory users in a Sophos Central tenant.
Inputs: tenant_id (required), search, page_key, page_size, +1 more.
sophos_list_users_in_groupARead-only
List all users that are members of a specific directory user group.
Inputs: group_id (required), tenant_id (required), page_key, page_size.
sophos_list_web_control_categoriesARead-only
List all Web Control categories available for URL filtering. Category IDs are used when creating local site overrides.
Inputs: tenant_id (required).
sophos_list_web_control_local_sitesARead-only
List Web Control local site overrides (custom URL allow/block entries) for a tenant.
Inputs: tenant_id (required), page, page_size.
sophos_list_wifi_tasksARead-only
List management tasks for the tenant's Wi-Fi access points, with optional filtering by policy type and pagination. Tasks represent configuration changes pushed to managed access points.
Inputs: tenant_id (required), page, type, fields, +2 more.
sophos_list_xdr_queriesBRead-only
List saved XDR query templates available for the tenant.
Inputs: tenant_id (required), page_size, page_from_key.
sophos_list_xdr_query_categoriesARead-only
List XDR query categories available for the tenant.
Inputs: tenant_id (required).
sophos_manage_mailbox_aliasesB
Add or remove email aliases for a mailbox.
Inputs: tenant_id (required), mailbox_id (required), add, remove.
sophos_manage_mailbox_delegatesB
Add or remove delegate access for a mailbox.
Inputs: tenant_id (required), mailbox_id (required), add, remove.
sophos_manage_mailbox_dl_ownersB
Add or remove distribution list owners for a mailbox.
Inputs: tenant_id (required), mailbox_id (required), add, remove.
sophos_mitre_attack_guideARead-only
Get Sophos-specific detection and hunting guidance for MITRE ATT&CK techniques. Returns detection capability, Live Discover SQL queries, policy settings, and escalation guidance.
Inputs: technique_id (required).
sophos_mobile_action_get_logsBRead-only
Request log collection from up to 50 mobile devices for investigation purposes.
Inputs: tenant_id (required), endpoint_ids (required).
sophos_mobile_action_locateA
Trigger a GPS location request on up to 50 mobile devices. A reason is required and will be logged in the Sophos Mobile privacy log.
Inputs: reason (required), tenant_id (required), endpoint_ids (required).
sophos_mobile_action_send_messageA
Send a push message to up to 50 mobile devices. The message is displayed as a notification on the device.
Inputs: message (required), tenant_id (required), endpoint_ids (required).
sophos_mobile_action_syncA
Trigger a sync action on up to 50 mobile devices — forces devices to check in with Sophos Mobile and apply pending policies.
Inputs: tenant_id (required), endpoint_ids (required).
sophos_org_get_tenantBRead-only
Get details for a specific tenant under this Sophos Central Organization account.
Inputs: tenant_id (required).
sophos_playbook_incident_responseARead-only
Get SOC incident response playbook for Sophos endpoint incidents. Returns step-by-step guidance referencing exact Sophos MCP tool names.
Inputs: incident_type (required).
sophos_playbook_malware_triageBRead-only
Get malware triage guidance for specific detection types. Returns containment decisions, evidence collection steps, recovery procedures, and IOC extraction guide.
Inputs: detection_type (required).
sophos_playbook_threat_huntARead-only
Get threat hunting playbook for Sophos Live Discover and XDR. Returns SQL queries, MITRE mappings, and isolation decision trees.
Inputs: hunt_hypothesis (required).
sophos_preview_post_delivery_quarantine_messageARead-only
Preview the content of a post-delivery quarantined message.
Inputs: tenant_id (required), message_id (required).
sophos_preview_quarantine_messageARead-only
Preview the content (headers, body snippet) of a pre-delivery quarantined message.
Inputs: tenant_id (required), message_id (required).
sophos_reattach_quarantine_attachmentsB
Reattach previously stripped attachments to a quarantined message.
Inputs: tenant_id (required), message_id (required), attachments (required), for_recipients.
sophos_request_bulk_sender_privilegeB
Request bulk sender privilege for a mailbox that needs to send high volumes of email.
Inputs: count (required), period (required), purpose (required), tenant_id (required), +1 more.
sophos_request_memory_dumpA
Request a memory dump from an endpoint for forensic investigation. Requires specifying the dump mode and expiry time. Returns a memoryDumpRequestId to poll for status.
Inputs: mode (required), expires (required), tenant_id (required), endpoint_id (required), +3 more.
sophos_run_saved_xdr_queryARead-only
Run a saved XDR query (from the query library) by its query ID. Returns a run ID to poll for status and results.
Inputs: query_id (required), tenant_id (required), to_date, from_date, +3 more.
sophos_run_xdr_queryARead-only
Run an ad-hoc XDR (Extended Detection and Response) SQL query against the Sophos data lake. Returns a run ID to poll for status and results.
Inputs: query (required), tenant_id (required), to_date, from_date, +3 more.
sophos_search_alertsARead-only
Search alerts using a POST request body. Equivalent to sophos_list_alerts but filters are sent in a JSON body — useful for filtering by multiple IDs or long lists of categories/products.
Inputs: tenant_id (required), ids, sort, fields, +9 more.
sophos_search_mdr_threat_feed_indicatorsARead-only
Search for specific indicators in a firewall's MDR threat feed by their values.
Inputs: tenant_id (required), firewall_id (required), indicator_values (required).
sophos_search_post_delivery_quarantineARead-only
Search post-delivery quarantine messages (messages that were delivered but later quarantined). Use this for clawback/post-delivery remediation workflows.
Inputs: tenant_id (required), page, sort, end_date, +7 more.
sophos_search_quarantineBRead-only
Search pre-delivery quarantine messages with structured filters. This is the primary way to list quarantined messages.
Inputs: tenant_id (required), sort, end_date, page_size, +9 more.
sophos_set_tamper_protectionB
Enable or disable tamper protection on an endpoint. When enabled, Sophos agent settings cannot be changed without the tamper protection password. Optionally regenerate the password.
Inputs: enabled (required), tenant_id (required), endpoint_id (required), regenerate_password.
sophos_snooze_health_checkA
Snooze specific health check findings for endpoint or network device categories. The snooze body mirrors the health-check response structure — specify the categories/sub-categories you want to snooze.
Inputs: tenant_id (required), endpoint, networkDevice.
sophos_soc_tool_guideARead-only
Get a guide to all Sophos MCP tools organized by SOC workflow. Includes purpose, when to use, key output fields, and warnings.
Inputs: category (required).
sophos_start_detections_group_queryARead-only
Start an async detection-groups query run. Groups detections by detection rule and device for a summary view. Returns a run ID to poll.
Inputs: tenant_id (required), sort, to_date, severity, +2 more.
sophos_start_detections_queryARead-only
Start an async detections query run. Returns a run ID. Poll sophos_get_detections_query_status until status is 'finished', then retrieve results with sophos_get_detections_query_results.
Inputs: tenant_id (required), sort, to_date, severity, +2 more.
sophos_start_migrationA
Start an endpoint migration job on the sending tenant. Generates a migration job token that the receiving tenant uses to accept the migration via sophos_accept_migration.
Inputs: tenant_id (required), from_tenant (required), endpoint_ids (required).
sophos_take_alert_actionA
Perform an action on a specific alert. Valid actions depend on the alert type and are listed in the alert's allowedActions field. Common actions include: 'acknowledge', 'cleanPua', 'authPua', 'clearThreat', 'clearHmpa', 'sendMsgPua', 'sendMsgThreat'.
Inputs: action (required), alert_id (required), tenant_id (required), message.
sophos_unblock_addresses_bulkB
Remove multiple blocked IP address entries by their IDs in a single call.
Inputs: ids (required), tenant_id (required).
sophos_update_account_access_tokenA
Update an existing account-level access token. Supports updating the token's label and/or expiry date. At least one of label or expires_at must be provided.
Inputs: token_id (required), tenant_id (required), label, expires_at.
sophos_update_adaptive_attack_protectionA
Enable or disable Adaptive Attack Protection (AAP) on an endpoint. When enabled with an expiry duration, AAP automatically disables after that period.
Inputs: enabled (required), tenant_id (required), endpoint_id (required), expires_after.
sophos_update_allowed_itemB
Update the comment/reason on an existing globally allowed item.
Inputs: comment (required), tenant_id (required), allowed_item_id (required).
sophos_update_caseB
Update an existing case (name, type, severity, status, assignee, overview).
Inputs: case_id (required), tenant_id (required), name, type, +4 more.
sophos_update_cloud_security_profile_nameB
Rename a cloud security runtime detection profile.
Inputs: name (required), tenant_id (required), profile_id (required).
sophos_update_exclusionA
Update an existing global scanning exclusion (value, comment, and/or scanMode).
Inputs: tenant_id (required), exclusion_id (required), value, comment, +1 more.
sophos_update_exploit_mitigation_appA
Update exploit mitigation settings for an application. Can update executable paths, toggle overall protection, and enable/disable individual exploit mitigations (ASLR, DEP, SEHOP, etc.).
Inputs: tenant_id (required), application_id (required), paths, protected, +1 more.
sophos_update_firewallA
Update a firewall's attributes (name and/or geolocation). Note: name must be 3–40 characters.
Inputs: tenant_id (required), firewall_id (required), name, latitude, +1 more.
sophos_update_firewall_groupA
Update a firewall group — rename it and/or add/remove firewalls.
Inputs: group_id (required), tenant_id (required), name, assign_firewalls, +1 more.
sophos_update_ips_exclusionB
Update an IPS exclusion (direction, remote addresses, ports, or comment).
Inputs: tenant_id (required), exclusion_id (required), comment, direction, +3 more.
sophos_update_isolation_exclusionB
Update an isolation exclusion (direction, remote addresses, ports, or comment).
Inputs: tenant_id (required), exclusion_id (required), comment, direction, +3 more.
sophos_update_mailboxB
Update a mailbox's display name.
Inputs: name (required), tenant_id (required), mailbox_id (required).
sophos_update_mdr_threat_feed_settingsB
Update the MDR threat-feed settings for a specific firewall (enable/disable, action mode).
Inputs: tenant_id (required), firewall_id (required), action, enabled.
sophos_update_mobile_app_groupA
Update a mobile app group's name or apps list (PATCH — only provided fields are updated).
Inputs: tenant_id (required), app_group_id (required), name, apps_json.
sophos_update_mobile_device_groupA
Update a mobile device group. This is a full PUT replacement — all required fields must be provided.
Inputs: name (required), group_id (required), tenant_id (required), employee_compliance_policy_id (required), +4 more.
sophos_update_policyA
Update an existing endpoint policy. You can modify its name, enabled state, priority, and/or settings.
Inputs: policy_id (required), tenant_id (required), name, enabled, +2 more.
sophos_update_software_commentA
Set or update the user comment for a specific static software package (full replace with PUT).
Inputs: comment (required), tenant_id (required), package_id (required).
sophos_update_switch_mac_filterA
Update the MAC filter settings for a tenant's managed switches. Provide a list of MAC addresses to allow or block on switch ports. Replaces the existing MAC address list. Maximum 256 entries.
Inputs: tenant_id (required), mac_addresses (required).
sophos_update_tenant_adminB
Update a tenant administrator's details (name or email).
Inputs: admin_id (required), tenant_id (required), email, last_name, +1 more.
sophos_update_tenant_roleB
Update a tenant-level custom role's name or description.
Inputs: role_id (required), tenant_id (required), name, description.
sophos_update_tls_decryption_settingsB
Update Web Control TLS decryption settings. Pass a JSON array of category objects with id and decryptionEnabled fields.
Inputs: tenant_id (required), categories (required).
sophos_update_tls_excluded_websitesA
Add or remove websites from TLS decryption exclusions in a single call. Pass JSON arrays for 'add' and/or 'remove'.
Inputs: tenant_id (required), add, remove.
sophos_update_userB
Update a directory user's details.
Inputs: user_id (required), tenant_id (required), email, last_name, +2 more.
sophos_update_user_groupB
Update a directory user group's name or description.
Inputs: group_id (required), tenant_id (required), name, description.
sophos_update_web_control_local_siteB
Update a Web Control local site override (URL, categoryId, and/or comment).
Inputs: tenant_id (required), local_site_id (required), url, comment, +1 more.
sophos_update_wifi_mac_filterA
Update the MAC filter settings for a tenant's managed Wi-Fi access points. Provide a list of MAC addresses to allow or block. Replaces the existing MAC address list. Maximum 256 entries.
Inputs: tenant_id (required), mac_addresses (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 234 tools
Most tools target distinct resources, but there are deliberate aliases/equivalents such as sophos_search_alerts vs sophos_list_alerts, sophos_list_tenant_admins_paged vs sophos_list_tenant_admins, and sophos_acknowledge_alert vs sophos_take_alert_action. Near-identical quarantine, mailbox, and role tools also require careful reading, though descriptions generally do enough to resolve ambiguity.
The sophos_ verb_noun pattern dominates and is mostly readable, but conventions are mixed: sophos_mobile_action_sync inverts the usual verb-first style, sophos_playbook_* and *_guide tools are noun-style, and variants like add_user_to_groups vs add_users_to_group vs manage_mailbox_aliases break consistency. The universal sophos_ prefix keeps the set navigable despite these deviations.
At 234 tools, this is an extreme mismatch for a single MCP server and far exceeds the 50+ threshold. Even for a broad security platform, the surface should be split into focused servers by domain such as endpoints, email, firewall, mobile, and administration to remain practically usable by agents.
Coverage is broad across many Sophos Central domains, but lifecycle coverage has significant gaps: there is no way to start/run a Live Discover query despite having status, results, and cancel tools, and many resources like exclusions, allowed/blocked items, endpoint groups, mailboxes, users, and roles lack delete/remove operations. Some surfaces also lack basic list operations, notably policies and endpoint groups, creating agent dead ends.
Maintenance
Related MCP Connectors
Microsoft 365, CRM, Partner Center and tenant operations for organisations and MSPs.
SOAR security playbooks for AI agents: fetch, full-text search, and count. Metered via Stripe.
Query your team's drift, vulnerability, and upgrade data from any AI assistant. OAuth 2.1, 51 tools.
Compliance frameworks (SOC 2, ISO 27001, CMMC, NIST, more) delivered to AI agents as MCP tools.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants and automation tools to manage Microsoft 365, Entra ID, and Intune resources through 32 tools for user/device/file management and infrastructure monitoring.8MIT
- AlicenseNot gradedqualityCmaintenanceBrings the full AlertLogic MDR platform into AI assistants, exposing 473+ tools for incident response, log search, SOAR automation, and multi-account security operations at MSSP scale.19 PyPIMIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to manage MSP-multi-tenant email security: organizations, domains, users, licensing, features, subscription packages, and email flow reporting.Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables security analysts and engineers to triage incidents, audit vulnerabilities, query multi-cloud telemetry, inspect network infrastructure, and automate ITSM remediations through natural language.MIT