Parallels RAS MCP Server
The Parallels RAS MCP Server provides read-only visibility into a Parallels Remote Application Server (RAS) environment, allowing AI assistants to query infrastructure, settings, policies, publishing, and session data without making any changes.
Infrastructure Monitoring (14 tools)
List RAS agents, connection brokers, and farm sites
View cloud/hypervisor providers (AVD, AWS, Azure, Hyper-V, Nutanix, vCenter, VMware ESXi)
Monitor RDS session hosts (CPU/RAM usage, active sessions, host pool membership)
Review VDI templates, host pools, and provisioning settings
Audit SSL/TLS certificate inventory and expiration dates
Check HALB (High Availability Load Balancer) device status
View enrollment server health (SCEP), Secure Client Gateway status, SAML identity providers, and user portal themes
Site Settings (9 tools)
Inspect Active Directory integration, connection/authentication settings, and FSLogix profile configuration
Audit load balancing methods, MFA providers (TOTP, RADIUS, Email OTP, etc.), and printing/redirection policies
Review tenant broker connectivity, notification event triggers, URL redirection rules, and CPU optimization settings
Policy & Farm Management (8 tools)
List all client policies controlling user experience (display, audio, printing)
Audit farm administrator accounts, roles, and permissions
Review farm configuration, licensing status/seat usage/expiration, and REST API version info
Inspect performance monitor thresholds, SMTP mailbox settings, and reporting configuration
Publishing (9 tools)
List published RDS, VDI, and AVD applications and desktops
Review resource folder hierarchy and overall publishing service health
Get a combined view of all published items across all resource types
Session Monitoring (1 tool)
List all active remote desktop sessions with username, client IP, device name, session state, and connected server
Support (1 tool)
Retrieve support contact details, product version, build number, and support entitlement
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., "@Parallels RAS MCP Server Check the current license status and seat usage"
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.
Parallels RAS MCP Server
A community-maintained Model Context Protocol (MCP) server for Parallels Remote Application Server (RAS) via the RAS REST API. Queries are read-only by default. Administrators can opt in to write support.
Gives AI assistants visibility into your RAS infrastructure, site settings, policies, publishing, and sessions. Use it as an MCP server or import the standalone skill for a local agent.
Not affiliated with Parallels International GmbH. "Parallels" is a trademark of its respective owner.
See it in 65 seconds
https://github.com/user-attachments/assets/6a2753c8-0882-4ae0-bc92-1f35232c6ed7
A short film of what this project does. It shows an agent auditing a lab farm from one request and rating the findings red, amber and green, then covers what the server can read and how writes stay off until you opt in. It has narration, and the on-screen text carries the same message if you watch it muted.
Related MCP server: Dell SC Series MCP Server
Scope and intended use
Two transports are supported, selected via the MCP_TRANSPORT environment variable:
stdio(default): Launched as a local subprocess by the MCP client (Claude Desktop, Claude Code, Cursor, etc.). Intended for an individual administrator on their own workstation, or for development and test environments. Credentials come from the launching process's environment; there is no network listener.http: A streamable HTTP listener with a required bearer token. Intended for trusted network deployments where one server is shared by multiple clients (e.g. behind a reverse proxy that adds TLS). Defaults to binding127.0.0.1:3000; binding to all interfaces is opt-in.
In either mode this server holds a RAS administrator session and exposes 41 read-only RAS tools plus two documentation tools. The standalone skill exposes the same 43 read tools. Setting RAS_ENABLE_WRITE=true also exposes a write-operation discovery tool and one request tool in both options. This enables potentially destructive changes, including session actions and configuration changes. There is no multi-tenancy or per-client rate limiting. Treat access as admin-equivalent and protect it accordingly.
API compatibility: the read-only paths were verified against the Parallels RAS v21 REST API. The opt-in write catalog comes from the official v21.2 REST API guide. Parallels lists REST API 21.2.1.1 as the latest v21 patch in its release notes. Check the endpoint documentation and your farm version before writing; this project has not run live write tests against a RAS farm.
Current source version: v1.3.0 adds the portable direct-API skill and MCP security hardening. See History and CHANGELOG.md for details.
Prerequisites
Node.js 18.14.1 or later
Access to a Parallels RAS server with the REST API enabled (port 20443 by default)
npm, only when building the MCP server or skill from source
Install the MCP server from source
git clone https://github.com/RMITBLOG/ParallelsRAS_MCP.git
cd ParallelsRAS_MCP
npm install
npm run buildEnvironment Variables
Connection to RAS
Variable | Required | Default | Description |
| Yes | - | RAS server hostname or IP address |
| Yes | - | Administrator username |
| Yes | - | Administrator password |
| No |
| REST API port |
| No |
| Skip TLS certificate verification for self-signed RAS deployments. See the security tradeoff below. |
| No | - | PEM bundle containing the private CA that issued the RAS certificate. Set this when using |
| No |
| Register the two write tools in the MCP server and standalone skill. This grants access to documented POST, PUT, and DELETE operations using the configured administrator account. |
Transport
Variable | Required | Default | Description |
| No |
|
|
| HTTP only | - | Bearer token clients must present in |
| No |
| Bind address. Set to |
| No |
| Listen port. |
Self-signed RAS certificates
RAS_IGNORE_TLS=true remains the default for compatibility with RAS deployments
that use a self-signed certificate. This is an explicit security tradeoff: Node's
NODE_TLS_REJECT_UNAUTHORIZED=0 setting is process-wide, so it disables certificate
verification for both the RAS API connection and the Parallels documentation HTTPS
connection. An attacker able to intercept internal network traffic could impersonate
either service and obtain RAS administrator credentials or session tokens. The server
prints a warning whenever this mode is active. With writes enabled, interception can
also alter administrator requests and responses. Prefer certificate verification
for write-capable deployments.
This setting concerns verification of the remote HTTPS server certificate. It is unrelated to signing a locally built copy of this MCP server.
For a secure self-signed or private-CA deployment, export the issuing CA certificate
as PEM, ensure the certificate's Subject Alternative Name matches RAS_HOST, and
start Node with verification enabled:
{
"env": {
"RAS_HOST": "ras-server.example.com",
"RAS_IGNORE_TLS": "false",
"NODE_EXTRA_CA_CERTS": "C:\\certificates\\ras-ca.pem"
}
}NODE_EXTRA_CA_CERTS is read when Node starts. Do not place the RAS private key in
this file; it should contain only the public CA certificate chain.
Configuration
The examples below cover the stdio transport, which is the default and what most users want. For the HTTP transport, see Running over HTTP further down.
Skill option for local agents
The repository also includes an importable Parallels RAS skill and a Claude Code project entry point. Its bundled JavaScript runner exposes the same 41 RAS read queries and two documentation lookups, plus opt-in writes. The ZIP also includes focused RAS architecture and troubleshooting guidance and an administration workflow guide based on Parallels' v21 manuals. The skill requires Node.js 18.14.1 or later and RAS_* environment variables for farm queries, but needs no npm install, source checkout, MCP server, or MCP client configuration. Documentation lookups do not need RAS credentials.
Download the standalone skill ZIP and extract its single parallels-ras/ folder into ~/.claude/skills/ for Claude Code or ~/.codex/skills/ for Codex. The resulting path should be ~/.claude/skills/parallels-ras/SKILL.md or ~/.codex/skills/parallels-ras/SKILL.md. Set RAS_HOST, RAS_USERNAME, and RAS_PASSWORD in the local agent's environment; the agent must be able to reach the RAS API. From source, regenerate the folder and ZIP with npm install followed by npm run package:skill.
When working in this repository, invoke $parallels-ras in Codex or /parallels-ras in Claude Code, or ask the agent to inspect the RAS farm. For a direct local check:
node .agents/skills/parallels-ras/scripts/ras-query.mjs list
node .agents/skills/parallels-ras/scripts/ras-query.mjs call ras_farm_get_versionFor writes through the skill, set RAS_ENABLE_WRITE=true, use ras_write_operations to find a documented method and path, and pass the ras_write_request JSON on standard input with node <skill-directory>/scripts/ras-query.mjs call ras_write_request -. Keep passwords and certificate material out of command arguments and committed files.
The existing stdio and HTTP MCP configurations below remain available when your client supports MCP tool connections.
Claude Desktop
Edit your claude_desktop_config.json (typically at %APPDATA%\Claude\claude_desktop_config.json on Windows or ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"parallels-ras": {
"command": "node",
"args": ["/path/to/ParallelsRAS_MCP/build/index.js"],
"env": {
"RAS_HOST": "ras-server.example.com",
"RAS_USERNAME": "administrator",
"RAS_PASSWORD": "your-password",
"RAS_PORT": "20443",
"RAS_IGNORE_TLS": "true"
}
}
}
}Claude Code
claude mcp add parallels-ras -- node /path/to/ParallelsRAS_MCP/build/index.jsSet environment variables in your shell or in the Claude Code MCP configuration.
Cursor
In Cursor settings, go to Features > MCP Servers and add:
Name:
parallels-rasCommand:
node /path/to/ParallelsRAS_MCP/build/index.jsEnvironment:
RAS_HOST,RAS_USERNAME,RAS_PASSWORD
Other MCP-compatible clients
For any client supporting MCP over stdio, point it at:
node /path/to/ParallelsRAS_MCP/build/index.jswith the required environment variables set in the client's MCP server configuration.
Running over HTTP
The HTTP transport implements MCP Streamable HTTP and runs as a long-lived process. Use it when you want one server shared by multiple clients on a trusted network, typically behind a reverse proxy that terminates TLS.
Start the server
export RAS_HOST=ras-server.example.com
export RAS_USERNAME=administrator
export RAS_PASSWORD=your-password
export MCP_TRANSPORT=http
export MCP_HTTP_BEARER_TOKEN=$(openssl rand -hex 32) # required
# export MCP_HTTP_HOST=127.0.0.1 # default; set 0.0.0.0 to expose
# export MCP_HTTP_PORT=3000
npm run start:httpThe server logs the listen address on startup. The MCP endpoint is POST /mcp. Requests must include Authorization: Bearer <MCP_HTTP_BEARER_TOKEN>; missing or wrong tokens return 401.
HTTP mode accepts request bodies up to 1 MiB, JSON-RPC batches of up to 25 items,
and 16 concurrent authenticated requests by default. With RAS_ENABLE_WRITE=true,
the body ceiling is 12 MiB and the concurrency ceiling is four to accommodate
bounded file uploads. Requests beyond these bounds receive 413 or 503
responses. Each stateless request receives a fresh MCP server and transport context.
Connect a client
For clients that support a streamable-HTTP MCP server, point them at http://<host>:<port>/mcp with the bearer token in the Authorization header. For example, the Claude Code CLI:
claude mcp add parallels-ras --transport http \
--header "Authorization: Bearer $MCP_HTTP_BEARER_TOKEN" \
http://your-server:3000/mcpProduction checklist
Always front this with TLS through a reverse proxy (nginx, Caddy, Traefik) that terminates HTTPS. Bind the MCP server to
127.0.0.1and reach it only through the proxy.Treat
MCP_HTTP_BEARER_TOKENas a credential with at least 32 bytes of entropy. Store it in a secret manager and rotate it when staff leave.Restrict network reachability (firewall, VPN, private subnet). The bearer check is the only auth layer in the server itself.
The RAS admin credentials sit on the same host as the listener. Anyone with shell access on that host can read them. Do not run this on a multi-tenant box.
If writes are enabled, anyone holding the HTTP bearer token can attempt every documented write operation permitted to the configured RAS administrator. Use a RAS account with only the permissions needed for the deployment. MCP clients may apply their own approval prompts; the server's write gate is the
RAS_ENABLE_WRITEconfiguration setting.HTTP write mode refuses to start with a bearer token shorter than 32 bytes. Generate a random token such as
openssl rand -hex 32; token length alone does not establish entropy.HTTP clients share one RAS administrator session. Coordinate staged changes and
Settings/applycalls because an apply operation can activate changes staged by another client.
Available read tools (41 RAS tools + 2 documentation tools)
These tools are read-only and annotated with readOnlyHint: true for automatic approval in compatible clients.
List tools (sessions, hosts, certs, agents, published items, etc.) accept three optional inputs for narrowing large responses:
fields: string[]: Keep only these top-level keys on each row.filter: Record<string, string|number|boolean>: Match top-level fields by equality (AND across keys; strings are case-insensitive).limit: number: Cap rows after filtering. Default 50, hard max 200.
Responses lead with a one-line NOTE: header summarising total rows, filter matches, and truncation. A 64 KB byte safety net applies to every response.
Infrastructure (14)
Tool | Description |
| List all RAS agents and their status |
| Connection broker status and priority |
| Cloud/hypervisor providers (AVD, AWS, Azure, Hyper-V, etc.) |
| RDS session hosts |
| RDS host pools |
| Certificate inventory |
| HALB device status |
| Enrollment server status |
| VDI host pools |
| VDI templates |
| Secure Client Gateway status |
| Farm sites and their status |
| SAML identity providers for SSO |
| User portal themes and branding |
Site Settings (9)
Tool | Description |
| Active Directory integration config |
| Connection and authentication settings |
| Load balancing settings |
| MFA provider configuration |
| Printing settings |
| Tenant broker status |
| Notification event configuration |
| URL redirection rules |
| CPU optimization settings |
FSLogix is not exposed at site scope by the REST API. It is configured per host pool, per AVD template, or via PowerShell.
Policies (1)
Tool | Description |
| List all client policies |
Farm Settings (7)
Tool | Description |
| Admin accounts and roles |
| Farm configuration |
| Licensing status and seat usage |
| Web service version |
| Performance monitor configuration |
| SMTP mailbox settings |
| Reporting configuration |
Publishing (9)
Tool | Description |
| Published RDS applications |
| Published VDI applications |
| Published AVD applications |
| Published RDS desktops |
| Published VDI desktops |
| Published AVD desktops |
| Resource folders |
| Publishing service status |
| All published items (combined view) |
RD Sessions (1)
Tool | Description |
| Active remote desktop sessions |
Documentation (2)
Tool | Description |
| Search the official Parallels documentation; returns excerpts with titles and links |
| Fetch one documentation page in full as Markdown |
These two query Parallels' public documentation rather than your farm. ras_docs_get_page accepts HTTPS docs.parallels.com URLs only.
Optional write support
Set RAS_ENABLE_WRITE=true in the MCP server or standalone skill environment to expose two additional tools. When unset, no write tool is registered or listed. The setting grants configuration-level access; the server does not implement a separate per-action confirmation step.
Tool | Description |
| Search the v21.2 catalog of 814 documented POST, PUT, and DELETE method/path pairs. Accepts |
| Send one catalog-matched write request. Accepts |
The client's own session logon and logoff endpoints are handled internally and are not exposed as write operations. ras_write_request rejects paths outside the documented catalog, paths outside /api/, redirects, mixed body formats, and bodies larger than 8 MiB. It does not retry a write after an error or timeout. Response output remains capped at 64 KiB. A successful request may still need a separate documented POST /api/Settings/apply operation before the change becomes active. Check the relevant endpoint in the official API guide for required fields and the apply workflow. File uploads and responses were tested with mocks, not a live farm.
Extending
Most tools follow one of two shapes: a list tool (the API returns an array of rows) or a single-object tool (config/status blob). Both are registered through factories in src/tools/_format.ts, so adding a new tool is a small ToolDef record plus one factory call.
To add a new tool:
Open the appropriate file in
src/tools/(e.g.,infrastructure.tsfor a new infra resource), or create a new one.Add a
ToolDefrecord to the file'sLIST_TOOLSorOBJECT_TOOLSarray:{ name: "ras_infra_get_widgets", title: "Widgets", description: "List widgets in the farm. Supports `fields`, `filter`, `limit`.", path: "/api/Widget", errorContext: "Failed to retrieve widgets", }If you created a new file, export a
register(server)function that loops over yourToolDefarrays callingregisterListTooland/orregisterObjectTool, then import and call it fromsrc/index.ts.Check the new
path:against the v21 REST API reference, then runnpm run buildandnpm test. The current build compiles TypeScript; it does not automatically verify new API paths against the OpenAPI spec.
registerListTool automatically wires the fields / filter / limit schema and routes the response through formatList. registerObjectTool skips the schema but still applies the 64 KB byte safety net.
Module file names (infrastructure.ts, site-settings.ts, etc.) group related tools internally. They do not correspond to URL segments. The real RAS API is flat under /api/<PascalCaseResource> (e.g. /api/Agent, /api/License, /api/MFA).
API reference
Browser reference: https://docs.parallels.com/landing/ras-rest-api-guide
API base URL:
https://<ras-host>:20443/api/
Roadmap
OAuth / OIDC for the HTTP transport: The server currently uses a single shared bearer token. Per-user identity would let multiple clients share a deployment without sharing credentials.
Contributing
Issues and pull requests are welcome. Please open an issue first for anything beyond a small fix so we can agree on the approach.
History
See CHANGELOG.md for the full release log. Recent highlights:
v1.3.0: Portable standalone skill ZIP for Claude Code and Codex, plus hardened RAS requests, HTTP request limits, output handling, and secret redaction. The self-signed certificate compatibility default remains documented.
v1.2.0: Efficiency pass across all 41 tools:
fields/filter/limitinputs on every list tool, default row cap of 50, 64 KB byte safety net on every response, shared registration factories. Backward-compatible at the MCP protocol level.v1.1.0: Opt-in streamable HTTP transport with bearer-token auth, alongside the existing stdio transport.
v1.0.1: Corrects all 41 tool paths against the Parallels RAS v21 REST API and adds a build-time path verifier.
License
Available Tools
43 toolsras_docs_get_pageGet Parallels Documentation PageARead-onlyIdempotent
Fetch the full markdown content of a specific Parallels documentation page. Use after ras_docs_search when you need the complete page (prerequisites, full procedure, all options) rather than excerpts. Accepts a full https://docs.parallels.com/... URL.
Inputs: url (required).
ras_docs_searchSearch Parallels DocumentationARead-onlyIdempotent
Search the official Parallels documentation for relevant pages, code examples, API references, and feature guides. Use this to validate configuration found via the RAS API tools, look up the documented behaviour of a feature, or find the right page before fetching it in full with ras_docs_get_page. Returns one or more excerpts with titles and direct links.
Inputs: query (required).
ras_farm_get_administratorsFarm AdministratorsARead-onlyIdempotent
List RAS farm administrator accounts — usernames, roles, permissions, group membership. Use this to audit admin access, verify role assignments, or review who has administrative control of the farm.
Inputs: limit, fields, filter.
ras_farm_get_configFarm ConfigurationARead-onlyIdempotent
RAS farm configuration settings — farm name, domain, backup settings, global options. Use this to review the overall farm setup, verify domain configuration, or check backup scheduling.
Inputs: no named parameters.
ras_farm_get_licensingLicensingARead-onlyIdempotent
RAS licensing status — license type (subscription/perpetual), expiration date, seat count, usage, activation status. Use this to check compliance, verify capacity, or diagnose licensing issues.
Inputs: no named parameters.
ras_farm_get_mailboxMailbox SettingsARead-onlyIdempotent
SMTP mailbox configuration used for RAS email notifications — server address, port, sender details. Use this to verify email notification settings or troubleshoot delivery failures.
Inputs: no named parameters.
ras_farm_get_performancePerformance MonitorARead-onlyIdempotent
Performance monitor configuration and counters for the RAS farm — resource utilisation thresholds and monitoring settings. Use this to review performance baselines or check monitoring configuration.
Inputs: no named parameters.
ras_farm_get_reportingReportingARead-onlyIdempotent
Reporting configuration for the RAS farm — report scheduling, data retention, database connection. Use this to verify reporting is enabled and properly configured.
Inputs: no named parameters.
ras_farm_get_versionWeb Service VersionARead-onlyIdempotent
RAS web service (REST API) version information. Returns the current API version and build number. Use this to verify the API version is compatible or check which features are available.
Inputs: no named parameters.
ras_infra_get_agentsRAS AgentsARead-onlyIdempotent
List all Parallels RAS agents deployed across the farm — hostname, IP, OS, agent version, and current status. Use this to verify agent deployment, diagnose connectivity, or check agent versions. Supports fields, filter, and limit to narrow large result sets.
Inputs: limit, fields, filter.
ras_infra_get_certificatesCertificatesARead-onlyIdempotent
Certificate inventory for the RAS farm — names, expiration dates, issuers, and usage. Use this to audit SSL/TLS certificates, check for upcoming expirations, or verify assignments.
Inputs: limit, fields, filter.
ras_infra_get_connection_brokersConnection BrokersARead-onlyIdempotent
Connection broker status, priority, and configuration. Brokers handle user session brokering and load distribution. Use this to check broker health, verify primary/secondary priority, or diagnose session routing.
Inputs: limit, fields, filter.
ras_infra_get_enrollment_statusEnrollment ServersARead-onlyIdempotent
Enrollment server status. Enrollment servers handle SCEP certificate enrollment for device management. Use this to check enrollment server health or troubleshoot certificate enrollment failures.
Inputs: limit, fields, filter.
ras_infra_get_gateway_statusGateway StatusARead-onlyIdempotent
Status of RAS Secure Client Gateways — connection state, IP addresses, tunnel mode. Gateways provide external user access to published resources. Use this to monitor gateway health or troubleshoot external connectivity.
Inputs: limit, fields, filter.
ras_infra_get_halb_statusHALB StatusARead-onlyIdempotent
Status of HALB (High Availability Load Balancer) devices in the farm — device health, IP addresses, operational state. Use this to monitor load balancer availability or diagnose gateway connectivity.
Inputs: limit, fields, filter.
ras_infra_get_providersProvidersARead-onlyIdempotent
List all cloud and hypervisor providers configured in the RAS farm — AVD, AWS EC2, Azure, Hyper-V, Nutanix, vCenter, VMware ESXi. Use this to verify provider connectivity, check provider types, or audit multi-cloud config.
Inputs: limit, fields, filter.
ras_infra_get_rds_hostpoolsRDS Host PoolsBRead-onlyIdempotent
List RDS host pool membership and configuration. Host pools group RDS servers for load balancing and resource allocation. Use this to review pool composition, check host assignments, or verify pool settings.
Inputs: limit, fields, filter.
ras_infra_get_rds_hostsRDS HostsARead-onlyIdempotent
List RDS session hosts — hostname, IP, agent status, active sessions, CPU/RAM usage, OS version. Use this to monitor host health, check capacity, or troubleshoot RDS issues. On large farms, narrow with filter (e.g. {status: 'online'}) or fields to keep responses small.
Inputs: limit, fields, filter.
ras_infra_get_saml_idpsSAML Identity ProvidersARead-onlyIdempotent
List SAML identity providers configured for SSO — provider names, metadata URLs, configuration details. Use this to audit SSO configuration or troubleshoot SAML authentication.
Inputs: limit, fields, filter.
ras_infra_get_sitesSitesARead-onlyIdempotent
List all sites configured in the RAS farm and their status. Multi-site deployments distribute infrastructure across locations. Use this to check site connectivity, verify configuration, or audit farm topology.
Inputs: limit, fields, filter.
ras_infra_get_themesThemesARead-onlyIdempotent
List user portal themes configured in the RAS farm — branding, logos, customisation settings. Use this to review portal appearance configuration or verify theme assignments.
Inputs: limit, fields, filter.
ras_infra_get_vdi_hostpoolsVDI Host PoolsARead-onlyIdempotent
List VDI host pool configuration — pool members, provisioning settings, capacity. Use this to review VDI pool composition, check desktop provisioning status, or verify pool sizing.
Inputs: limit, fields, filter.
ras_infra_get_vdi_templatesVDI TemplatesARead-onlyIdempotent
List VDI templates, their status, and configuration. Templates define the base image and settings for provisioned VDI desktops. Use this to check template versions, maintenance mode, or provisioning settings.
Inputs: limit, fields, filter.
ras_policies_listClient PoliciesARead-onlyIdempotent
List all Parallels RAS client policies — policy names, settings, and assignment status. Client policies control user experience settings (display, audio, printing, device redirection). Use this to audit policy configuration or troubleshoot client behaviour. Policies can be deeply nested — use fields to project only top-level metadata when you don't need every rule.
Inputs: limit, fields, filter.
ras_pub_get_all_itemsAll Published ItemsARead-onlyIdempotent
List all published items across all resource types (RDS, VDI, AVD apps and desktops) in a single view. Use this for a complete overview of everything published in the farm. Large farms can return thousands of items — narrow with filter (e.g. {type: 'App'}) or project with fields to keep responses small.
Inputs: limit, fields, filter.
ras_pub_get_avd_appsPublished AVD AppsARead-onlyIdempotent
List published Azure Virtual Desktop applications. AVD apps are delivered from Azure-hosted session hosts. Use this to review AVD app assignments or verify Azure-based application publishing.
Inputs: limit, fields, filter.
ras_pub_get_avd_desktopsPublished AVD DesktopsBRead-onlyIdempotent
List published Azure Virtual Desktop resources. AVD desktops are delivered from Azure-hosted session hosts. Use this to review AVD desktop assignments or verify Azure-based desktop publishing.
Inputs: limit, fields, filter.
ras_pub_get_foldersPublishing FoldersARead-onlyIdempotent
List published resource folders that organise applications and desktops into logical groups for end users. Use this to review folder hierarchy, check resource organisation, or verify folder-level access.
Inputs: limit, fields, filter.
ras_pub_get_rds_appsPublished RDS AppsARead-onlyIdempotent
List published RDS applications — app names, executable paths, server associations, user filter assignments. Use this to review which apps are published via RDS, check app configurations, or troubleshoot launch issues.
Inputs: limit, fields, filter.
ras_pub_get_rds_desktopsPublished RDS DesktopsARead-onlyIdempotent
List published RDS desktop resources. RDS desktops deliver full Windows desktops from shared session hosts. Use this to review RDS desktop assignments or troubleshoot launch issues.
Inputs: limit, fields, filter.
ras_pub_get_statusPublishing StatusARead-onlyIdempotent
Overall publishing service status and health. Returns whether the publishing agent is operational and any pending changes. Use this to verify publishing is functioning or diagnose why resources are unavailable.
Inputs: no named parameters.
ras_pub_get_vdi_appsPublished VDI AppsARead-onlyIdempotent
List published VDI applications. VDI apps run on dedicated virtual machines rather than shared RDS hosts. Use this to review VDI-published applications or compare with RDS app assignments.
Inputs: limit, fields, filter.
ras_pub_get_vdi_desktopsPublished VDI DesktopsARead-onlyIdempotent
List published VDI desktop resources. VDI desktops deliver dedicated virtual machines per user. Use this to review assignments or verify per-user desktop allocation.
Inputs: limit, fields, filter.
ras_sessions_listActive RD SessionsARead-onlyIdempotent
List active remote desktop sessions across the RAS farm — username, client IP, device name, state, screen resolution, and connected server. Use this to monitor active users, check session counts, troubleshoot connectivity, or identify idle/disconnected sessions. Supports fields, filter, and limit — prefer narrowing over fetching everything on large farms.
Inputs: limit, fields, filter.
ras_site_get_ad_integrationAD IntegrationARead-onlyIdempotent
Active Directory integration configuration — domain settings, forest trust relationships, OU mappings. Use this to verify AD connectivity, check domain join status, or troubleshoot authentication issues.
Inputs: no named parameters.
ras_site_get_connection_settingsConnection SettingsARead-onlyIdempotent
Connection and authentication settings — session timeouts, client connection policies, authentication methods. Use this to review security posture or troubleshoot client connection issues.
Inputs: no named parameters.
ras_site_get_cpu_optimizationCPU OptimizationARead-onlyIdempotent
CPU optimization settings for the site. Controls how CPU resources are allocated across user sessions. Use this to review resource management policies or troubleshoot performance issues.
Inputs: no named parameters.
ras_site_get_load_balancingLoad BalancingARead-onlyIdempotent
Load balancing settings — balancing method, resource weights, session limits. Use this to review how sessions are distributed across RDS hosts or diagnose uneven load distribution.
Inputs: no named parameters.
ras_site_get_mfaMFA ConfigurationARead-onlyIdempotent
Multi-factor authentication provider configuration — enabled MFA providers (TOTP, RADIUS, Deepnet, SafeNet, Email OTP), criteria rules, bypass conditions. Use this to audit MFA security posture or troubleshoot MFA login failures.
Inputs: no named parameters.
ras_site_get_notificationsNotification EventsARead-onlyIdempotent
Notification event configuration — alert triggers, email notifications, event thresholds. Use this to review which events trigger admin notifications or verify alerting is configured.
Inputs: limit, fields, filter.
ras_site_get_printingPrinting SettingsARead-onlyIdempotent
Printing configuration — printer redirection, universal printing options, driver policies. Use this to troubleshoot print redirection issues or review printing policy configuration.
Inputs: no named parameters.
ras_site_get_tenant_brokerTenant Broker StatusARead-onlyIdempotent
Tenant broker status and join information. The tenant broker enables multi-tenant RAS deployments. Use this to verify tenant broker connectivity or check join status for managed sites.
Inputs: no named parameters.
ras_site_get_url_redirectionURL RedirectionARead-onlyIdempotent
URL redirection rules configured for the site. URL redirection allows specific URLs opened on RDS hosts to be redirected to the client device browser. Use this to review redirection rules or troubleshoot URL handling.
Inputs: limit, fields, filter.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 43 tools
Tools are mostly organized by distinct RAS domains (farm, site, infra, pub) and resource types, making purposes clear. However, ras_pub_get_all_items overlaps with the specialized app, desktop, and folder listing tools, creating some ambiguity about when to use the aggregate versus targeted getters.
All tools use a consistent ras_<domain>_<verb>_<resource> pattern with snake_case, which is highly predictable. The minor inconsistency is that listing operations sometimes use get (e.g., ras_infra_get_agents) and sometimes list (e.g., ras_sessions_list, ras_policies_list).
43 tools is well above the typical 3-15 range and exceeds the 25+ threshold where count becomes a usability concern. Many granular getters for individual settings could be consolidated or parameterized without losing functionality.
The tool surface is entirely read-only: every tool is a get, list, or search operation. There are no create, update, delete, or action tools for any RAS resource, so agents cannot perform lifecycle management or remediation tasks, leaving significant gaps for an administration-focused server.
Maintenance
Related MCP Connectors
Read-only MCP for AI usage profiles, leaderboards, stats, and docs; no writes or private data.
Read-only MCP server for RZ AI Labs — query its services, workshops, and contact info.
Read-only Google Analytics 4 MCP server for AI assistants.
Read-only MCP server for AIStatusDashboard status, incidents, metrics, and fallback recommendations.
Related MCP Servers
AlicenseAqualityDmaintenanceRead-only MCP server that allows AI assistants to query and monitor KVM Fleet devices, audit logs, and console sessions through the official REST API.58 npm1MIT- AlicenseNot gradedqualityCmaintenanceA read-only MCP server that lets AI assistants diagnose Dell SC Series storage arrays through the array's own REST API.MIT
- AlicenseNot gradedqualityDmaintenanceA read-only MCP server that provides tools to list and read devices, MDM servers, blueprints, configurations, apps, packages, users, and other resources from Apple Business Manager and Apple School Manager.MIT
- AlicenseAqualityDmaintenanceA read-only MCP server for Proxmox VE that provides AI assistants with structured visibility into cluster nodes, guests, storage, and Docker workloads. It is designed to prevent any mutating operations by construction.12MIT