RoboShadow MCP Server
This server provides 40 read-only tools for querying RoboShadow's Rubicon Platform Data API, covering endpoint security, asset inventory, and vulnerability data for a given organisation.
Organisations & users: list organisations visible to the token (
roboshadow_list_organisations) and organisation users (roboshadow_list_organisation_users).MFA/identity: paged MFA status report with registered methods and Global Administrator flags (
roboshadow_get_mfa_report).Vulnerability scanning: list external VScanner scan statuses, get a scan summary, and per-IP CVE/port breakdowns.
Applications: list application groups organisation-wide, get one group's detail, and list apps installed on a device.
Devices: list all devices, get device detail, and retrieve Windows user profiles and local/AD users.
Antivirus/Defender: per-device AV state, organisation-wide AV report, ransomware report, AV summary, detected threats, and Windows Defender config report.
Firewall: Windows firewall status per profile for every device.
Disks: device disks, disk shares, disk usage by disk or by device, and organisation-wide disk summary (low space, unencrypted, USB).
Hardware: hardware inventory by device and organisation-wide hardware summary.
Services: Windows services on a device, including unquoted-service-path vulnerability flags.
Updates: missing Windows updates for a device, paginated missing-updates report by device, and organisation-wide update summary.
Vulnerabilities: per-device vulnerability summary, vulnerable applications, CPE and CVE findings, fixes for a CVE, vulnerable devices, and organisation-wide vulnerability summary.
Remediation: vulnerability-remediation attempts organisation-wide and the CVEs addressed by one attempt.
All tools are read-only and admin-gated; most require an
organisationId(and often adeviceId,scanId,cveId, orattemptId), with common pagination/filter/sort parameters on list tools.
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., "@RoboShadow MCP Server list all unpatched vulnerabilities and their remediation status"
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.
RoboShadow MCP Server
MCP server for RoboShadow's Rubicon Platform Data API - endpoint security (antivirus, Windows Defender, firewall), asset/hardware inventory, applications, users, vulnerabilities, and remediation status, for AI assistants and the WYRE Conduit gateway.
Scope: every documented operation is read-only (deliberate, not a filtered subset)
RoboShadow's Rubicon Platform Data API (https://cdn.development.roboshadow.com/publicapi/openapi.yaml, fetched directly) defines 40 GET paths across 15 tags (Antivirus, Applications, Defender, Devices, Disks, Firewall, Hardware, Identity, MFA, Remediation, Services, Updates, Users, Vulnerabilities, Vulnerability Scanner) and exactly one non-GET operation in the entire spec: POST /identity/bearertoken. That single POST is the vendor's own documented credential-refresh mechanism (OpenAPI tag: Authentication) - it exchanges a Refresh Token for a short-lived Bearer Token and mutates no organisation data. There is no create/update/delete/remediation-trigger endpoint anywhere in the published spec to exclude - unlike this session's other connectors, this one has no write surface to carve away from.
This connector implements all 40 GET operations, one tool each, and calls POST /identity/bearertoken internally (never as an exposed tool) purely to keep its own access token fresh. See Authentication below for why that call exists and why it isn't a tool.
Related MCP server: OpenCTI MCP Server
Authentication
RoboShadow's Rubicon Platform Data API authenticates with a Bearer token (components.securitySchemes.BearerAuth, bearerFormat: JWT in the vendor's own spec). Generate credentials at your RoboShadow portal under Reports -> API Token, which shows three values together: an Organisation ID, a Bearer Token, and a Refresh Token.
The Bearer Token itself is short-lived - RoboShadow's own BearerTokenResponse schema documents expiresIn in seconds (~1 hour in the vendor's example). A token pasted into a long-running connector would go stale within the hour, so this connector stores the Refresh Token instead and exchanges it for a fresh Bearer Token internally (POST /identity/bearertoken) before every data call, caching the result in-process until shortly before it expires. The Organisation ID is not stored as a credential - pass it as the organisationId argument to any tool (discover it with roboshadow_list_organisations if you don't already have it), since a Refresh Token can resolve to more than one organisation on an MSP/reseller account.
Two separate claims here, at deliberately different confidence levels - the two-tier split established across this batch of connectors:
Structurally verified (checked directly, stated with full confidence): this connector's own code makes zero mutating calls against RoboShadow's data API. Every function in
client.tsthat reads organisation data calls one of the 40 dedicated GET operations in the published spec; the only non-GET call anywhere insrc/is the bearer-token exchange itself, and it is never exposed as an MCP tool.Vendor-documented, not independently verified (hedged deliberately): RoboShadow's own OpenAPI spec defines no write/mutate endpoint for organisation data anywhere - there is no scoped, read-only variant of the Bearer/Refresh Token to request instead, because the full token grants exactly the same access the vendor's own spec grants: reads only. Whether some other, undocumented part of the RoboShadow platform (outside this Organisation-Endpoints spec) accepts write calls under the same token has not been tested by WYRE - only that this spec, and this connector, expose none.
In gateway mode the refresh token arrives per-request via the X-RoboShadow-Refresh-Token header and a missing header is rejected; the server does not fall back to ROBOSHADOW_REFRESH_TOKEN. In local/stdio mode that variable is read from the environment. HTTP mode also requires the X-Gateway-S2S signature described below.
Configuration
Env var | Description |
| RoboShadow Refresh Token (Reports -> API Token in the portal). Required for stdio and for |
|
|
|
|
| Required to start the HTTP transport. HMAC secret checked against |
| Set to exactly |
| Bind address when |
| HTTP port. Defaults to |
|
|
/health stays unauthenticated and does not read credentials. The stdio transport does not use CONDUIT_S2S_SECRET.
X-Gateway-S2S
With MCP_TRANSPORT=http and CONDUIT_S2S_SECRET set, every /mcp request must include a gateway-signed X-Gateway-S2S header:
X-Gateway-S2S: t=<unix seconds>,v1=<hex hmac-sha256>v1 is HMAC-SHA256 of the literal string t=<unix seconds> (the same t= prefix and value that appear in the header), keyed with CONDUIT_S2S_SECRET, and encoded as lowercase hex. The timestamp must be within 300 seconds of the server clock. A missing or invalid header returns 401 and the handler does not read vendor credentials.
In AUTH_MODE=gateway, /mcp also requires X-RoboShadow-Refresh-Token. A missing or empty header returns 401. The server does not fall back to ROBOSHADOW_REFRESH_TOKEN in the process environment.
Request limits
HTTP request bodies are capped at 256 KiB (262144 bytes). After the
X-Gateway-S2Scheck passes, aContent-Lengthabove the cap returns 413 with a JSON-RPC error; bodies withoutContent-Lengthare capped by the MCP SDK transport. Unauthenticated requests still get 401 first.tools/callarguments are capped at 10,000 elements (every array item and object key at any depth). Larger inputs return anisErrortool result and are never dispatched.
These limits address CVE-2026-111768 / GHSA-46jr-4wx8-v453 (memory exhaustion during validation) and GHSA-f897-62hf-6gxq (no request body / batch cap).
Tools
40 read-only tools, one per GET operation in the Rubicon Platform Data API's published spec. Every tool that reads organisation-scoped data takes organisationId - discover it with roboshadow_list_organisations.
Identity
roboshadow_list_organisations- list every organisation visible to this refresh token.roboshadow_list_organisation_users- list an organisation's users (display name, email, permission level). PII - admin-gated.
MFA
roboshadow_get_mfa_report- paged MFA status report (registered methods, MFA status, Global Administrator flag) for a Microsoft-identity-linked organisation. PII/identity data - admin-gated.
Vulnerability Scanner
roboshadow_list_scan_status- status of every external vulnerability scan (VScanner), filterable by schedule/status.roboshadow_get_scan_summary- detailed summary of one scan (IP + web vulnerability totals).roboshadow_get_scan_ips_overview- per-target CVE/port breakdown for one scan.
Applications
roboshadow_list_application_groups- applications grouped across the organisation, with install/device/version counts.roboshadow_get_application_group- detail for one application group.roboshadow_get_device_applications- applications installed on one device.
Devices
roboshadow_list_devices- every device in the organisation, with hardware/OS identity, network address, health scores, and CVE/update counts. PII (IP/MAC address, logged-on user, serial number) - admin-gated.roboshadow_get_device- detail for one device. PII - admin-gated.roboshadow_get_device_user_profiles- Windows user profiles on one device (includes SID). PII - admin-gated.roboshadow_get_device_users- local/AD users on one device (email, employee ID, admin flag). PII - admin-gated.
Antivirus / Defender
roboshadow_get_device_antivirus- antivirus/endpoint-protection state for one device.roboshadow_get_antivirus_report_by_device- antivirus status for every device.roboshadow_get_ransomware_report- ransomware-protection status for every device.roboshadow_get_antivirus_summary- organisation-wide antivirus summary.roboshadow_get_antivirus_threats- detected antivirus threats across the organisation.roboshadow_get_windows_defender_report- Windows Defender configuration status for every device.
Firewall
roboshadow_get_firewall_report- Windows firewall status (per profile) for every device.
Disks
roboshadow_get_device_disks- disks on one device.roboshadow_get_disk_shares- network shares exposed on one disk.roboshadow_get_disk_report- disk usage across the organisation, grouped by disk.roboshadow_get_disk_report_by_device- disk information grouped by device.roboshadow_get_disk_summary- organisation-wide disk-usage summary (low-space devices, unencrypted drives, shares, USB disks).
Hardware
roboshadow_get_hardware_report_by_device- hardware inventory grouped by device.roboshadow_get_hardware_summary- organisation-wide hardware summary.
Services
roboshadow_get_device_services- Windows services on one device, including unquoted-service-path vulnerability flag.
Updates
roboshadow_get_device_updates- missing Windows updates for one device.roboshadow_get_updates_report_by_device- paginated missing-updates report grouped by device.roboshadow_get_updates_summary- organisation-wide update summary and top devices needing attention.
Vulnerabilities
roboshadow_get_device_vulnerability_summary- per-application CVE detail and severity rollup for one device.roboshadow_get_vulnerable_applications- applications with known vulnerabilities across the organisation.roboshadow_get_cpe_vulnerabilities- CPE vulnerability findings across the organisation.roboshadow_get_cve_vulnerabilities- CVEs affecting the organisation (CVSS/EPSS, known-exploited flag).roboshadow_get_cve_fixes- available fixes/patches for one CVE.roboshadow_get_vulnerable_devices- devices with known vulnerabilities.roboshadow_get_vulnerabilities_summary- organisation-wide vulnerability summary and top-5 critical apps/CVEs/devices.
Remediation
roboshadow_get_remediation_report- vulnerability-remediation attempts across the organisation (action, target, outcome).roboshadow_get_remediation_attempt_cves- CVEs addressed by one remediation attempt.
Sensitivity
RoboShadow is an endpoint-security and vulnerability-management platform - even as plain reads, most of this connector's 40 tools surface data that is PII (device users' SIDs, employee IDs, and email addresses; a device's logged-on user, IP/MAC address, and serial number), identity/MFA posture, or security-assessment data (vulnerabilities, threats, remediation outcomes, external scan results). Per this session's convention for vendors of this class (the same posture as Cork, CyberQP, Cisco Duo, and Slide in this same wave), every tool in this connector is isAdmin: true in the Conduit wiring, regardless of verb - this is a deliberate, vendor-wide design decision documented once in vendor-config.ts's roboshadow entry, not a per-tool sensitive-read escalation.
Development
npm install
npm run build
npm test
npm run lint # tsc --noEmitDocker
The image listens on 0.0.0.0 inside the container (MCP_HTTP_HOST) and defaults to AUTH_MODE=gateway. Startup still refuses to run unless CONDUIT_S2S_SECRET is a real secret. Publish the port on loopback. In gateway mode the refresh token arrives on each request as X-RoboShadow-Refresh-Token; it is not read from the environment.
docker build -t roboshadow-mcp .
docker run \
-e CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" \
-p 127.0.0.1:8080:8080 \
roboshadow-mcpCompose refuses to start when CONDUIT_S2S_SECRET is unset, defaults AUTH_MODE to gateway, publishes 127.0.0.1:8080:8080, and does not set ROBOSHADOW_REFRESH_TOKEN:
CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" docker compose upSingle-tenant HTTP (AUTH_MODE=env) still requires the S2S secret, then uses ROBOSHADOW_REFRESH_TOKEN:
docker run \
-e CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" \
-e AUTH_MODE=env \
-e ROBOSHADOW_REFRESH_TOKEN="$ROBOSHADOW_REFRESH_TOKEN" \
-p 127.0.0.1:8080:8080 \
roboshadow-mcpLocal HTTP without a secret is development-only. It binds 127.0.0.1 even if MCP_HTTP_HOST is 0.0.0.0, and logs a warning:
MCP_TRANSPORT=http MCP_ALLOW_INSECURE_DEV=1 npm run start:httpLicense
Apache-2.0
Available Tools
40 toolsroboshadow_get_antivirus_report_by_deviceB
List antivirus/firewall/protection status for every device in the organisation.
Inputs: organisationId (required), page, itemsPerPage.
roboshadow_get_antivirus_summaryA
Get an organisation-wide antivirus summary: active-threat count, devices missing antivirus/on-access/real-time protection, third-party vs. Windows Defender coverage, and open-firewall count.
Inputs: organisationId (required).
roboshadow_get_antivirus_threatsB
List detected antivirus threats across the organisation, with severity and detection/remediation timing.
Inputs: organisationId (required), page, itemsPerPage.
roboshadow_get_application_groupB
Get detailed information for one application group by its hashed group ID.
Inputs: group_id (required), organisationId (required).
roboshadow_get_cpe_vulnerabilitiesB
List CPE (Common Platform Enumeration) vulnerability findings across the organisation.
Inputs: organisationId (required), page, itemsPerPage.
roboshadow_get_cve_fixesB
List available fixes/patches for one CVE.
Inputs: cveId (required), organisationId (required).
roboshadow_get_cve_vulnerabilitiesA
List CVEs affecting the organisation, each with CVSS/EPSS score, known-exploited-in-the-wild flag, and affected-OS/app/device counts.
Inputs: organisationId (required), days, page, itemsPerPage.
roboshadow_get_deviceA
Get detailed information about a single device. PII-bearing - admin-gated.
Inputs: deviceId (required), organisationId (required).
roboshadow_get_device_antivirusA
Get antivirus/endpoint-protection state for one device: engine name, real-time/tamper-protection status, and any active threats.
Inputs: deviceId (required), organisationId (required).
roboshadow_get_device_applicationsA
List applications installed on one device, with vendor, version, and last-seen time.
Inputs: deviceId (required), organisationId (required), page, search, +1 more.
roboshadow_get_device_disksB
List disks (drive letter, size, free space, used %) on one device.
Inputs: deviceId (required), organisationId (required).
roboshadow_get_device_servicesA
List Windows services on one device, including start mode, running state, and whether the service has an unquoted-path vulnerability.
Inputs: deviceId (required), organisationId (required), page, search, +1 more.
roboshadow_get_device_updatesA
List missing Windows updates for one device, with category, KB/package ID, and reboot requirement.
Inputs: deviceId (required), organisationId (required), page, other, +5 more.
roboshadow_get_device_user_profilesA
List Windows user profiles present on one device, including profile SID and disk path. PII-bearing - admin-gated.
Inputs: deviceId (required), organisationId (required).
roboshadow_get_device_usersA
List local/Active-Directory user accounts on one device, including email address, employee ID, and admin flag. PII-bearing - admin-gated.
Inputs: deviceId (required), organisationId (required).
roboshadow_get_device_vulnerability_summaryA
Get the vulnerability summary for one device: per-application CVE lists (with CVSS scores and available WinGet upgrades) and an overall severity rollup.
Inputs: deviceId (required), organisationId (required).
roboshadow_get_disk_reportA
List disk usage across the organisation, grouped by disk (percentage used, encryption status, share count).
Inputs: organisationId (required), page, itemsPerPage.
roboshadow_get_disk_report_by_deviceA
List disk information grouped by device (total disk/share counts, whether any drive is unencrypted).
Inputs: organisationId (required), page, itemsPerPage.
roboshadow_get_disk_summaryA
Get an organisation-wide disk-usage summary: low-disk-space devices, unencrypted laptops/servers/workstations, shared-folder and USB-disk counts.
Inputs: organisationId (required).
roboshadow_get_firewall_reportA
List Windows firewall status (enabled/disabled per profile: domain, private, public) for every device in the organisation.
Inputs: organisationId (required), page, itemsPerPage.
roboshadow_get_hardware_report_by_deviceA
List hardware inventory grouped by device: processor, memory, serial number, system manufacturer/model, and end-of-life OS flag.
Inputs: organisationId (required), page, itemsPerPage.
roboshadow_get_hardware_summaryA
Get an organisation-wide hardware summary: total machines, servers, workstations, and machines running an end-of-life OS.
Inputs: organisationId (required).
roboshadow_get_mfa_reportA
Get a paged multi-factor-authentication report for a Microsoft-identity-linked organisation: each user's registered MFA methods, MFA status, and whether they hold the Global Administrator role. Results page in blocks of 5000 users - pass skipPages to page through until hasMoreData is false. PII-bearing identity data - admin-gated.
Inputs: organisationId (required), skipPages.
roboshadow_get_ransomware_reportB
List ransomware-protection status for every device in the organisation.
Inputs: organisationId (required), page, itemsPerPage.
roboshadow_get_remediation_attempt_cvesB
List the CVEs addressed by one remediation attempt.
Inputs: attemptId (required), organisationId (required).
roboshadow_get_remediation_reportB
List detailed vulnerability-remediation attempts across the organisation: action taken, category, target device, and success/failure outcome.
Inputs: organisationId (required), days, page, search, +1 more.
roboshadow_get_scan_ips_overviewA
Get a per-target breakdown of one external vulnerability scan: CVE counts by severity, open-port counts, and component scan statuses for each scanned IP.
Inputs: scanId (required), organisationId (required).
roboshadow_get_scan_summaryA
Get a detailed summary of one external vulnerability scan: scan details, IP vulnerability totals, and web vulnerability findings.
Inputs: scanId (required), organisationId (required).
roboshadow_get_updates_report_by_deviceA
List a paginated missing-updates report grouped by device across the organisation, filterable by update category, workstation/server, and reboot-required status.
Inputs: organisationId (required), days, page, other, +11 more.
roboshadow_get_updates_summaryA
Get organisation-wide update summary statistics (devices needing critical/security/driver/rollup updates, reboot-pending count) plus the top devices requiring attention.
Inputs: organisationId (required), days.
roboshadow_get_vulnerabilities_summaryA
Get an organisation-wide vulnerability summary: devices by severity, top-5 most critical apps/CVEs/devices, and the single most critical server/workstation.
Inputs: organisationId (required), days.
roboshadow_get_vulnerable_applicationsB
List applications with known vulnerabilities across the organisation, with per-severity CVE counts and available upgrades.
Inputs: organisationId (required), days, page, itemsPerPage.
roboshadow_get_vulnerable_devicesA
List devices with known vulnerabilities, each with per-severity CVE counts and an overall CVSS score.
Inputs: organisationId (required), days, page, itemsPerPage.
roboshadow_get_windows_defender_reportB
List Windows Defender configuration status (real-time protection, tamper protection, service state) for every device.
Inputs: organisationId (required), page, itemsPerPage.
roboshadow_list_application_groupsA
List applications grouped across the organisation (by application identity, not per-install), each with install/device counts, distinct version counts, and a best-matching WinGet package if one exists.
Inputs: organisationId (required), page, search, sortBy, +2 more.
roboshadow_list_devicesA
List every device in a RoboShadow organisation, with hardware/OS identity, network address, health scores, and pending-update/CVE counts. PII-bearing (IP/MAC address, logged-on user, serial number) - admin-gated.
Inputs: organisationId (required), page, search, sortBy, +2 more.
roboshadow_list_organisationsA
List every RoboShadow organisation visible to this connector's refresh token, with each organisation's ID, name, and the caller's permission level. Start here to discover the organisationId every other tool needs.
Inputs: no named parameters.
roboshadow_list_organisation_usersA
List the users belonging to a RoboShadow organisation, with each user's display name, email, and permission level. PII-bearing - admin-gated.
Inputs: organisationId (required).
roboshadow_list_scan_statusA
List the status of every external vulnerability scan (VScanner) for an organisation, with per-IP and per-domain scan status. Filter by isScheduled or status.
Inputs: organisationId (required), page, sortBy, status, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 40 tools
Most tools target a distinct resource or aggregation level, and the descriptions are precise about scope. However, the many report/summary/by-device variants for antivirus, disk, updates, and vulnerabilities create moderate risk of an agent selecting the wrong one.
Every tool follows the same roboshadow_verb_noun pattern with lowercase snake_case, using get for detail and list for collection-style operations. The naming is highly predictable across all 40 tools.
40 tools is well above the 25+ threshold and feels heavy for the domain. Many tools are report variants that could be consolidated into parameterised endpoints, though each does map to a distinct data view.
The tool surface provides broad read-only coverage of organisations, devices, vulnerabilities, updates, disks, and remediation history. It lacks write/action capabilities such as initiating scans or applying fixes, but that appears consistent with a read-only security reporting server.
Maintenance
Related MCP Connectors
Query your team's drift, vulnerability, and upgrade data from any AI assistant. OAuth 2.1, 51 tools.
Ask your AI assistant about your logs, traces, security events, robot runs and video. Read-only.
1Deltabridge brings an AI-native cyber threat intelligence platform into your AI agent. Search a knowledge graph of 400,000+ threat actors, malware families, vulnerabilities, indicators and campaigns, mapped to MITRE ATT&CK. Look up and enrich IOCs, trace links between entities and read living briefs built from 300+ open sources. Read-only, scoped to your organisation, with OAuth sign-in or an API key. Included on Researcher, Business and Enterprise plans.
Read-only AI access to Osboon business card analytics, viewers, links, connections and contacts.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceProvides AI assistants with read-only access to Secureframe's compliance data, enabling querying of security controls, tests, users, vendors, and more across frameworks like SOC 2 and ISO 27001.8MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to query and manage OpenCTI threat intelligence data, including indicators, observables, reports, malware, and more, with read-only and optional write operations.1MIT
- AlicenseBqualityBmaintenanceProvides AI assistants with read-only access to Cisco Umbrella's NextGen REST API for deployment, admin, policy, reporting, and investigate visibility, enabling DNS and cloud security monitoring through natural language.31Apache 2.0
- AlicenseAqualityBmaintenanceProvides read-only visibility into CyberQP privileged access management data, including customer and account metadata, tenant event logs, and Just-In-Time account status and policies, for AI assistants.10Apache 2.0