Sophos Central MCP Server
Click on "Install 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 ServerShow me the health of all my tenants"
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
MCP (Model Context Protocol) server for interacting with Sophos Central APIs. Supports partner, organisation, and single-tenant credential types with automatic region routing. 288 tools covering 20 Sophos API namespaces. Install it as a Claude Desktop extension (.mcpb), run it with npx, or host it yourself over streamable HTTP.
Prerequisites
You need these before any of the install options below.
Sophos Central API credentials
Every install method needs a Client ID and Client Secret. The credential type decides what the server can see:
Tenant-level: In Sophos Central, go to Settings > API Credentials Management and create a new credential. The server operates on that one tenant.
Partner-level: In the Sophos Partner Dashboard, create API credentials under Settings > API Credentials. The server can query every tenant the partner manages.
Organisation-level: In Sophos Central Enterprise, use Global Settings > API Credentials Management. Same cross-tenant behaviour as partner credentials.
Node.js 20 or later (npm and self-hosted installs only)
The .mcpb bundle for Claude Desktop does not need Node.js on your machine: Claude Desktop ships its own Node.js runtime and the bundle carries the server and all of its dependencies. Install Node.js 20+ only if you use the Claude Code or self-hosted options.
Related MCP server: SuperOps MCP Server
Install
Pick one:
Option | Best for | Needs Node.js? |
Claude Desktop users who want a two-minute install | No | |
Terminal use with Claude Code | Yes | |
Running the server yourself for any MCP client, over streamable HTTP or stdio | Yes |
Option 1: Claude Desktop extension (.mcpb, recommended)
The .mcpb file is an MCP Bundle: a zip containing the built server, its production dependencies, and a manifest that tells Claude Desktop how to run it and which settings to ask for. No terminal and no config file edits.
Download
sophos-central-mcp-server-<version>.mcpbfrom the latest GitHub release.Open the file with Claude Desktop. Double-clicking it works on macOS and Windows. You can also go to Settings > Extensions > Advanced settings, find the Extension Developer section, click Install Extension... and pick the file.
Claude Desktop shows the extension details and asks for your Sophos Central Client ID and Client Secret. Both fields are marked sensitive in the manifest, so Claude Desktop keeps them in the operating system's secure storage instead of a config file.
Click Install, make sure the extension is enabled, then start a new chat. The
sophos_*tools are available straight away.
To update, download the newer .mcpb and install it the same way. To remove it, open Settings > Extensions and uninstall the extension.
The bundle runs the server in stdio mode and sets TRANSPORT=stdio for you. Which tools you get depends on the credential type, exactly as with the other install options: partner and organisation credentials unlock the cross-tenant tools, tenant credentials do not.
Option 2: Claude Code
Requires Node.js. Run this once in your terminal. The -e flags save the credentials permanently to Claude Code's MCP config so you don't need to re-export them each session:
macOS / Linux:
claude mcp add sophos-central \
-e SOPHOS_CLIENT_ID="your-client-id" \
-e SOPHOS_CLIENT_SECRET="your-client-secret" \
-e TRANSPORT="stdio" \
-- npx -y sophos-central-mcp-serverWindows (Command Prompt):
claude mcp add sophos-central ^
-e SOPHOS_CLIENT_ID="your-client-id" ^
-e SOPHOS_CLIENT_SECRET="your-client-secret" ^
-e TRANSPORT="stdio" ^
-- cmd /c npx -y sophos-central-mcp-serverOption 3: Self-hosted with npm (streamable HTTP or stdio)
Use this when you want to run the server yourself, on a workstation, a jump box, or in a container, for any MCP client that speaks streamable HTTP or can spawn a stdio process. Nothing here depends on the .mcpb bundle.
Install from npm:
npm install -g sophos-central-mcp-serverOr from source:
git clone https://github.com/Aaronjacobs000/sophos-central-mcp.git
cd sophos-central-mcp
npm install
npm run buildConfigure. Either export the variables in your shell or put them in a .env file in the directory you start the server from. The full table is under Configuration.
SOPHOS_CLIENT_ID=your-client-id
SOPHOS_CLIENT_SECRET=your-client-secret
PORT=3100
TRANSPORT=httpRun:
sophos-central-mcp # global npm install
npm start # from a source checkoutWith TRANSPORT=http (the default) the server listens on http://127.0.0.1:3100/mcp and answers GET /health with {"status":"ok"}. The MCP endpoint is stateless: every request gets a fresh transport. Point any streamable HTTP client at it, for example Claude Code:
claude mcp add --transport http sophos-central http://127.0.0.1:3100/mcpWith TRANSPORT=stdio the server speaks MCP over stdin/stdout and is meant to be spawned by the client, which is what Options 1 and 2 do for you.
The HTTP server binds to 127.0.0.1 only and has no authentication of its own. If it needs to be reachable from another host, put it behind something that adds TLS and auth (an SSH tunnel or an authenticating reverse proxy) rather than changing the bind address.
Build the .mcpb yourself (maintainers)
The bundle is produced by scripts/build-mcpb.mjs using the mcpb CLI, which is a dev dependency. From a source checkout:
npm install
npm run build:mcpbThe script:
Compiles TypeScript to
dist/(vianpm run build).Rewrites
manifest.jsonso itsversionmatchespackage.jsonand itstoolslist matches everyregisterToolcall insrc/tools/. Commit the result. The manifest in git is always the one that was last built.Validates the manifest with
mcpb validate.Stages
dist/,package.json,LICENSE, andmanifest.jsoninbuild/mcpb/and runsnpm ci --omit=devthere, so only production dependencies are bundled..mcpbignoreadds a few exclusions on top of the CLI's defaults.Packs the staging directory into
release/sophos-central-mcp-server-<version>.mcpb.
build/ and release/ are git-ignored. To inspect a bundle without installing it, npx mcpb info release/<file>.mcpb prints its size and signature state, and npx mcpb unpack release/<file>.mcpb <dir> extracts it. Signing is optional; npx mcpb sign --self-signed release/<file>.mcpb adds a self-signed signature if you want one.
Cutting a release: bump version in package.json, run npm run build:mcpb, commit package.json, package-lock.json, and manifest.json, tag, and attach the .mcpb from release/ to the GitHub release. Publish to npm as before so the Claude Code and self-hosted options pick up the same version.
Features
Universal caller support: Works with partner, organisation, and tenant-level API credentials
Multi-tenant: Partner/org callers can query across all managed tenants
Partner gap analysis: Single-call sales opportunity report across all managed tenants. Fetches health data in parallel and returns a compact ranked list of security gaps per customer
Auto region routing: Discovers tenant data regions via
/whoami/v1and routes requests to the correct regional API hostToken lifecycle: Automatic OAuth2 token refresh before expiry
Rate limit handling: Retry with backoff on 429 responses
Dual transport: stdio (Claude Desktop, Claude Code, and the
.mcpbbundle) or streamable HTTP (self-hosted)One-click install: Ships as a Claude Desktop extension (
.mcpb) with credentials held in the OS secure storeFull API coverage: 288 tools across endpoints, alerts, policies, firewalls, web filtering, licensing, audit events, email, mobile, XDR, cases, SIEM, and more
Screenshots
Querying tenants and drilling into endpoint status:

Tenant health audit with full category breakdown:


Configuration
Applies to the Claude Code and self-hosted options. The Claude Desktop extension asks for the credentials in its install dialog and sets TRANSPORT=stdio itself.
Copy .env.example to .env and set your credentials:
SOPHOS_CLIENT_ID=your-client-id
SOPHOS_CLIENT_SECRET=your-client-secret
PORT=3100
TRANSPORT=httpVariable | Required | Default | Description |
| Yes | - | OAuth2 client ID |
| Yes | - | OAuth2 client secret |
| No | 3100 | HTTP server port |
| No | http |
|
| No | 50000 | Maximum characters per tool response before truncation (minimum 10000) |
Tools
Partner & Organisation (18 tools)
These tools are only available with partner or organisation-level credentials. They operate across all managed tenants.
Tool | Description |
| List all managed tenants with IDs, names, and data regions |
| Bulk health scores for all tenants, ranked worst-first |
| Security gap and upsell opportunity report across all tenants |
| Create a new managed tenant |
| Get managed tenant details |
| List partner-level roles |
| Get partner role detail |
| Create a partner role |
| Delete a partner role |
| List available partner permission sets |
| List partner administrators |
| Get partner admin detail |
| Create a partner admin |
| Delete a partner admin |
| List admin role assignments |
| Add role assignment to admin |
| Remove role assignment |
| Get billing usage for a specific month |
Alerts (4 tools)
Tool | Description |
| List alerts with severity/category/product/date filters |
| Get full alert detail with allowed actions |
| Mark an alert as reviewed |
| Advanced search with structured filters and sorting |
Endpoints (18 tools)
Tool | Description |
| List endpoints with health/OS/hostname/isolation filters |
| Get full endpoint detail |
| Trigger an on-demand scan |
| Network-isolate a compromised endpoint |
| Release an endpoint from isolation |
| Delete a specific endpoint |
| Bulk delete multiple endpoints |
| Get tamper protection status and password |
| Enable/disable tamper protection |
| Get adaptive attack protection status |
| Enable/disable adaptive attack protection |
| Trigger a software update check |
| Request forensic log upload |
| Get forensic log request status |
| Request memory dump from endpoint |
| Get memory dump request status |
| Bulk isolate/release multiple endpoints |
| Get endpoint isolation status |
Endpoint Settings (30 tools)
Tool | Description |
| List available installer packages |
| Get specific installer download link |
| List blocked network addresses |
| Add a blocked network address |
| Delete a blocked address |
| List web control local site definitions |
| Add a local site for web control |
| Update a local site |
| Delete a local site |
| List web control categories |
| Get TLS decryption settings |
| Update TLS decryption settings |
| Get global tamper protection settings |
| Update global tamper protection |
| List detected exploits |
| Get exploit detail |
| List exploit mitigation categories |
| Get category detail |
| List exploit mitigation applications |
| Get application detail |
| Add application to exploit mitigation |
| Update exploit mitigation application |
| List IPS exclusions |
| Add IPS exclusion |
| Delete IPS exclusion |
| List isolation exclusions |
| Add isolation exclusion |
| Delete isolation exclusion |
| Get server lockdown settings |
| Update server lockdown settings |
Endpoint Migrations (7 tools)
Tool | Description |
| List endpoint migration jobs |
| Get migration job details |
| Create a new migration job |
| Delete a migration job |
| List endpoints in a migration |
| List recommended software packages |
| List static software packages |
Policies (6 tools)
Tool | Description |
| List endpoint policies with optional type filter |
| Get full policy detail including all settings |
| Create a new endpoint policy |
| Clone an existing policy under a new name |
| Update policy name, enabled state, priority, or settings |
| Delete a policy |
Endpoint Groups (7 tools)
Tool | Description |
| List endpoint groups |
| Get group detail with optional member list |
| Create a new endpoint group |
| Rename or update a group |
| Delete an endpoint group |
| Add endpoints to a group |
| Remove an endpoint from a group |
Exclusions & Allow/Block Lists (9 tools)
Tool | Description |
| List global scanning exclusions |
| Add a scanning exclusion |
| Delete a scanning exclusion |
| List globally allowed items |
| Allow an item by SHA256, path, or certificate |
| Remove an allowed item |
| List globally blocked items |
| Block an item by SHA256, path, or certificate |
| Remove a blocked item |
Account Health (3 tools)
Tool | Description |
| Get tenant health check scores |
| Bulk health scores for all tenants (partner/org only) |
| Gap analysis across all tenants (partner/org only) |
Directory Users & Groups (17 tools)
Tool | Description |
| List directory users |
| Get user detail |
| Create a directory user |
| Update a user |
| Delete a user |
| List directory user groups |
| Get user group detail |
| Create a user group |
| Update a user group |
| Delete a user group |
| List members of a user group |
| Add users to a group |
| Remove a user from a group |
| List endpoints in a user group |
| List policies assigned to a user group |
| List admin accounts and roles |
| List available admin roles |
Admin Management (13 tools)
Tool | Description |
| Get admin detail |
| Create an admin account |
| Delete an admin account |
| List admin's role assignments |
| Add role assignment to admin |
| Remove role assignment |
| Get specific role assignment |
| Create an admin role |
| Get role detail |
| Update a role |
| Delete a role |
| List available permission sets |
| Reset an admin's password |
Cases (9 tools)
Tool | Description |
| List investigation cases |
| Get full case details |
| Create a new investigation case |
| Update case status, severity, assignee |
| Delete a case |
| List detections linked to a case |
| Get specific detection detail |
| List impacted entities for a case |
| Get MITRE ATT&CK breakdown for a case |
Detections (6 tools)
Async API — start a query, poll for completion, then fetch results.
Tool | Description |
| Start async query for individual detections |
| Poll detection query status |
| Fetch completed detection query results |
| Start async query for grouped detections |
| Poll detection groups query status |
| Fetch completed detection groups results |
SIEM (2 tools)
Tool | Description |
| Stream security events (cursor-based, last 24h default) |
| Stream security alerts (cursor-based, last 24h default) |
XDR Data Lake (9 tools)
Async API — submit SQL queries against historical telemetry.
Tool | Description |
| Start async SQL query against the Data Lake |
| Poll XDR query run status |
| Fetch completed XDR query results |
| List XDR query runs |
| Cancel a running XDR query |
| List XDR query categories |
| Get XDR query category detail |
| List saved XDR queries |
| Get saved XDR query detail |
Live Discover (4 tools)
Async API — run OSquery SQL on live endpoints. Rate limited to 10 runs/minute, 500/day.
Tool | Description |
| List available saved OSquery queries |
| Run a saved or ad hoc query on live endpoints |
| Poll Live Discover run status |
| Fetch Live Discover results |
Firewall (21 tools)
Tool | Description |
| List managed firewalls |
| Update firewall properties |
| Delete a firewall |
| Perform an action (approveManagement, the only documented action) |
| Check firmware upgrades for a set of firewalls |
| Start or schedule firmware upgrades |
| Cancel scheduled firmware upgrades |
| List firewall groups |
| Get firewall group detail |
| Create a firewall group |
| Update a firewall group |
| Delete a firewall group |
| Get sync status of the firewalls in a group |
| Get a firewall's MDR threat feed |
| Update a firewall's MDR threat feed settings |
| Search a firewall's MDR threat feed indicators |
| Poll a per-firewall transaction (threat feed ops) |
| Start a config export (backup) of a firewall |
| Poll an export/import transaction |
| Download a finished backup archive to a local file |
| Upload and import a config archive into firewalls |
Config import/export requires the firewall to run SFOS v22 MR2 or later, be
managed by Sophos Central, and hold an active license. On an HA pair, target
the primary node (the auxiliary rejects config operations). The exported
archive can appear in storage a couple of minutes after the transaction
reports finished; sophos_download_firewall_backup retries automatically
for about 3 minutes to cover that window.
Email Protection (29 tools)
Tool | Description |
| Search quarantined emails |
| Preview quarantined email content |
| Get URLs in quarantined email |
| Get quarantined email attachment info |
| Release quarantined email to recipient |
| Permanently delete quarantined email |
| Strip attachments and release |
| Reattach stripped attachments |
| Download specific attachment |
| Search post-delivery quarantine |
| Preview post-delivery quarantined message |
| Get post-delivery attachment info |
| Release post-delivery message |
| Delete post-delivery message |
| Download post-delivery attachment |
| Clawback/recall a delivered message |
| Get clawback action status |
| List mailboxes |
| Create a mailbox |
| Bulk create mailboxes |
| Get mailbox detail |
| Update a mailbox |
| Delete a mailbox |
| List mailbox aliases |
| Add a mailbox alias |
| Delete a mailbox alias |
| List mailbox delegates |
| Add a mailbox delegate |
| Remove a mailbox delegate |
Mobile Device Management (32 tools)
Tool | Description |
| Get auto-enrollment settings |
| Update auto-enrollment settings |
| List supported mobile OS platforms |
| List mobile devices with filters |
| Get device detail |
| Enroll a new mobile device |
| Update device properties |
| Delete/unenroll a device |
| Get device properties |
| Get compliance status |
| Get scan results |
| Get assigned policies |
| Get installed apps |
| Get device location |
| List device groups |
| Get device group detail |
| Create a device group |
| Update a device group |
| Delete a device group |
| Sync a device |
| Request device logs |
| Trigger device scan |
| Unenroll a device |
| Send message to device |
| Request device location update |
| Lock device remotely |
| Wipe device remotely |
| List app groups |
| Get app group detail |
| Create an app group |
| Update an app group |
| Delete an app group |
DNS Protection (5 tools)
Tool | Description |
| List DNS protection locations |
| Get location detail |
| Create a DNS location |
| Update a DNS location |
| Delete a DNS location |
Cloud Security (5 tools)
Tool | Description |
| List cloud security profiles |
| Get profile detail |
| Create a cloud security profile |
| Update a profile |
| Delete a profile |
Wi-Fi (3 tools)
Tool | Description |
| List Wi-Fi MAC filtering entries |
| Add a MAC filter entry |
| Delete a MAC filter entry |
User Activity (2 tools)
Tool | Description |
| Create a user attestation/sign-off |
| Get attestation detail |
Audit Events (1 tool)
Tool | Description |
| List Sophos Central audit events (who did what, 90-day window) |
Licensing (2 tools)
Tool | Description |
| List a tenant's product licenses, usage, and entitlements |
| List firewall license details (tenant or partner-wide) |
Web Filtering (16 tools)
Tool | Description |
| List web filtering profiles |
| Get a web filtering profile |
| Create a web filtering profile |
| Update (replace) a web filtering profile |
| Delete a web filtering profile |
| Clone a web filtering profile |
| Get categories, groups, and presets |
| List site lists |
| Get a site list |
| Create a site list |
| Update (replace) a site list |
| Delete a site list |
| Clone a site list |
| List the sites in a site list |
| Add a site to a site list |
| Delete a site from a site list |
Switch Management (3 tools)
Tool | Description |
| Get global switch MAC filtering settings |
| Replace the switch MAC filtering address list |
| List switch configuration tasks |
Accounts / Access Tokens (4 tools)
Tool | Description |
| List repository access tokens |
| Create a repository access token (Sophos Linux Sensor) |
| Update a token's label or expiry |
| Revoke a token |
Business Automation (4 tools)
Distributor-scoped: requires distributor-entitled credentials and an X-Distributor-ID.
Tool | Description |
| List distributor quotes (new, amendment, renewal) |
| Get a quote by proposal number |
| Partner program levels for a billing sub-region |
| Price a set of product lines for a reseller |
Tenant context
For partner/org callers, every tenant-scoped tool requires a tenant_id parameter. Use sophos_list_tenants first to discover available tenant IDs.
For tenant-level callers, tenant_id is optional and defaults to the authenticated tenant.
Architecture
Authenticate (OAuth2 client credentials)
|
v
/whoami/v1 -> Discover identity type (partner | organization | tenant)
|
v
If partner/org: enumerate tenants, cache {tenantId -> apiHost}
|
v
Register tools based on identity type
|
v
Per tool call: resolve tenant -> regional API host -> execute requestKey decisions
Dynamic tool registration: Only tools valid for the caller type are exposed to the LLM
Explicit tenant context: Partner/org callers must specify
tenant_idto prevent cross-tenant accidentsStateless HTTP: Each MCP request creates a fresh transport instance (no session affinity)
Localhost binding: HTTP server binds to
127.0.0.1only
Project Structure
src/
├── index.ts # Entry point, server bootstrap
├── config/config.ts # Environment config
├── auth/token-manager.ts # OAuth2 token lifecycle
├── client/
│ ├── sophos-client.ts # HTTP client with region routing
│ └── tenant-resolver.ts # Whoami + tenant cache
├── tools/
│ ├── helpers.ts # Shared response formatting
│ ├── tenants.ts # Tenant listing (partner/org only)
│ ├── partner.ts # Partner admin, roles, billing (partner/org only)
│ ├── alerts.ts # Alert list, get, acknowledge, search
│ ├── endpoints.ts # Endpoint CRUD, scan, isolate, tamper, forensics
│ ├── endpoint-settings.ts # Installer, web control, exploit mitigation, IPS, etc.
│ ├── endpoint-migrations.ts # Migration jobs, software packages
│ ├── health.ts # Account health, gap analysis
│ ├── directory.ts # Users, user groups, group membership
│ ├── admin-management.ts # Admin CRUD, roles, permission sets
│ ├── policies.ts # Policy CRUD, clone
│ ├── groups.ts # Endpoint group CRUD, membership
│ ├── exclusions.ts # Scanning exclusions, allowed/blocked items
│ ├── cases.ts # Investigation cases, detections, MITRE
│ ├── detections.ts # Detection queries (async)
│ ├── siem.ts # SIEM events and alerts
│ ├── xdr.ts # XDR Data Lake queries (async)
│ ├── live-discover.ts # Live Discover queries (async)
│ ├── firewall.ts # Firewall CRUD, firmware, groups, threat feed, config import/export
│ ├── email.ts # Quarantine, mailboxes, message actions
│ ├── mobile.ts # Mobile devices, groups, actions, policies
│ ├── dns-protection.ts # DNS locations
│ ├── cloud-security.ts # Cloud security profiles, assets
│ ├── wifi.ts # Wi-Fi MAC filtering
│ └── user-activity.ts # User attestations
└── types/sophos.ts # Sophos API response typesPackaging files at the repo root: manifest.json (MCPB manifest, regenerated by the build), scripts/build-mcpb.mjs (bundle builder), and .mcpbignore (extra exclusions applied when packing).
Security
Credentials are read from environment variables only, never logged
JWT tokens are held in memory with automatic refresh
HTTP server binds to
127.0.0.1(localhost only)Write actions have
destructiveHintannotations so clients can warn usersPartner/org callers require explicit
tenant_idon every callWith the
.mcpbinstall, Claude Desktop holds the credentials in the OS secure store (they aresensitiveinmanifest.json) and hands them to the server as environment variables when it starts the process
License
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
MCP server for Pentest-Tools.com: run scans, manage findings and reports via your preffered LLM.
- SupabaseOAuthcom.supabase
MCP server for interacting with the Supabase platform
Related MCP Servers
- AlicenseCqualityCmaintenanceA read-only MCP server that provides 60+ tools to query Sophos XGS firewall configurations via the XML API, covering firewall rules, NAT, VPN, web filtering, and more.63AGPL 3.0
- AlicenseAqualityCmaintenanceMCP server for interacting with the SuperOps.ai PSA/RMM platform, providing tools for managing clients, tickets, assets, and technicians via GraphQL API.21Apache 2.0
- FlicenseAqualityCmaintenanceMCP server for Kaseya SaaS Alerts, providing 30 tools to manage security events, customers, users, devices, billing, and reports via the SaaS Alerts API.30-
- AlicenseNot gradedqualityBmaintenanceMCP server for managing Microsoft Intune and Entra ID via the Microsoft Graph API, offering 34 tools for device, app, compliance, security, identity, and reporting operations.1MIT