RoboShadow MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AUTH_MODE | No | env (default, reads ROBOSHADOW_REFRESH_TOKEN) or gateway (credential arrives per-request via the X-RoboShadow-Refresh-Token header, injected by the Conduit gateway). | env |
| LOG_LEVEL | No | debug | info (default) | warn | error. | info |
| MCP_TRANSPORT | No | stdio (default) or http. | stdio |
| CONDUIT_S2S_SECRET | No | When set, the HTTP transport requires a valid X-Gateway-S2S header (Conduit sidecar auth) on every /mcp request. | |
| ROBOSHADOW_REFRESH_TOKEN | No | RoboShadow Refresh Token (Reports -> API Token in the portal). |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
| logging | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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. |
| 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. |
| 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. |
| 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. |
| roboshadow_get_scan_summaryA | Get a detailed summary of one external vulnerability scan: scan details, IP vulnerability totals, and web vulnerability findings. |
| 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. |
| 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. |
| roboshadow_get_application_groupB | Get detailed information for one application group by its hashed group ID. |
| roboshadow_get_device_applicationsA | List applications installed on one device, with vendor, version, and last-seen time. |
| 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. |
| roboshadow_get_deviceA | Get detailed information about a single device. PII-bearing - admin-gated. |
| roboshadow_get_device_user_profilesA | List Windows user profiles present on one device, including profile SID and disk path. PII-bearing - admin-gated. |
| 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. |
| roboshadow_get_device_antivirusA | Get antivirus/endpoint-protection state for one device: engine name, real-time/tamper-protection status, and any active threats. |
| roboshadow_get_antivirus_report_by_deviceB | List antivirus/firewall/protection status for every device in the organisation. |
| roboshadow_get_ransomware_reportB | List ransomware-protection status for every device in the organisation. |
| 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. |
| roboshadow_get_antivirus_threatsB | List detected antivirus threats across the organisation, with severity and detection/remediation timing. |
| roboshadow_get_windows_defender_reportB | List Windows Defender configuration status (real-time protection, tamper protection, service state) for every device. |
| roboshadow_get_firewall_reportA | List Windows firewall status (enabled/disabled per profile: domain, private, public) for every device in the organisation. |
| roboshadow_get_device_disksB | List disks (drive letter, size, free space, used %) on one device. |
| roboshadow_get_disk_sharesA | List network shares exposed on one disk of one device. Includes share path and access details. |
| roboshadow_get_disk_reportA | List disk usage across the organisation, grouped by disk (percentage used, encryption status, share count). |
| roboshadow_get_disk_report_by_deviceA | List disk information grouped by device (total disk/share counts, whether any drive is unencrypted). |
| 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. |
| 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. |
| roboshadow_get_hardware_summaryA | Get an organisation-wide hardware summary: total machines, servers, workstations, and machines running an end-of-life OS. |
| roboshadow_get_device_servicesA | List Windows services on one device, including start mode, running state, and whether the service has an unquoted-path vulnerability. |
| roboshadow_get_device_updatesA | List missing Windows updates for one device, with category, KB/package ID, and reboot requirement. |
| 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. |
| 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. |
| 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. |
| roboshadow_get_vulnerable_applicationsB | List applications with known vulnerabilities across the organisation, with per-severity CVE counts and available upgrades. |
| roboshadow_get_cpe_vulnerabilitiesB | List CPE (Common Platform Enumeration) vulnerability findings across the organisation. |
| 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. |
| roboshadow_get_cve_fixesB | List available fixes/patches for one CVE. |
| roboshadow_get_vulnerable_devicesA | List devices with known vulnerabilities, each with per-severity CVE counts and an overall CVSS score. |
| 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. |
| roboshadow_get_remediation_reportB | List detailed vulnerability-remediation attempts across the organisation: action taken, category, target device, and success/failure outcome. |
| roboshadow_get_remediation_attempt_cvesB | List the CVEs addressed by one remediation attempt. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
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.