Parallels RAS

You can query Parallels RAS infrastructure in real time using a lightweight, read-only MCP server. It connects to your RAS REST API to provide visibility into infrastructure, site settings, policies, publishing, sessions, and support without permitting any changes. This makes it ideal for AI assistants and automation tools to read from your environment securely.

How to use

You run the MCP server locally and connect your MCP client to it over stdio. The server exposes read-only access to your Parallels RAS data via the REST API. In practice, you configure your MCP client with the appropriate command to start the local MCP process and supply the required credentials. Once connected, you can query for infrastructure status, sites, publishing items, sessions, and support information.

How to install

Prerequisites: Install Node.js 18 or later and npm. Ensure you have access to a Parallels RAS server with the REST API enabled on port 20443.

Step 1: Clone the MCP server repository and install dependencies.

git clone https://github.com/RMITBLOG/ParallelsRAS_MCP.git
cd ParallelsRAS_MCP
npm install
npm run build

Step 2: Run the MCP server locally using the standard Node command pattern shown in the configuration examples. The server requires the following environment variables to connect to your RAS instance: RAS_HOST, RAS_USERNAME, RAS_PASSWORD. Optionally you can specify RAS_PORT (default 20443) and RAS_IGNORE_TLS (default true) if you use a self-signed certificate.

Configuration and usage notes

You configure the MCP client to start the local server by using the Node command and pointing to the built index. The common setup patterns shown use an environment block and the command to execute the MCP index script.

# Example command to start the MCP server via Node
node /path/to/RAS_MCP/build/index.js

Environment variables you need to provide are: RAS_HOST with the RAS server hostname or IP, RAS_USERNAME with an administrator user, and RAS_PASSWORD with the corresponding password. You may also supply RAS_PORT to override the REST API port and RAS_IGNORE_TLS to skip TLS verification for self-signed certificates.

Security and access considerations

The MCP server provides read‑only access to your RAS data. Ensure you protect the environment variables that carry credentials and run the MCP server in a trusted environment. Use network controls to restrict MCP client access to this local process and rotate credentials regularly.

Troubleshooting tips

If you cannot connect to the RAS REST API, verify that REST API is enabled on the Parallels RAS server and that the host/port settings in your environment variables are correct. Check that TLS settings align with your certificate configuration and that the administrator credentials are valid.

Available tools

ras_infra_get_agents

List all RAS agents and their status

ras_infra_get_connection_brokers

Connection broker status and priority

ras_infra_get_providers

Cloud/hypervisor providers (AVD, AWS, Azure, Hyper-V, etc.)

ras_infra_get_rds_hosts

RDS session hosts

ras_infra_get_rds_hostpools

RDS host pools

ras_infra_get_certificates

Certificate inventory

ras_infra_get_halb_status

HALB device status

ras_infra_get_enrollment_status

Enrollment server status

ras_infra_get_vdi_hostpools

VDI host pools

ras_infra_get_vdi_templates

VDI templates

ras_infra_get_gateway_status

Secure Client Gateway status

ras_infra_get_sites

Farm sites and their status

ras_infra_get_saml_idps

SAML identity providers for SSO

ras_infra_get_themes

User portal themes and branding

ras_site_get_ad_integration

Active Directory integration config

ras_site_get_connection_settings

Connection and authentication settings

ras_site_get_fslogix

FSLogix profile container config

ras_site_get_load_balancing

Load balancing settings

ras_site_get_mfa

MFA provider configuration

ras_site_get_printing

Printing settings

ras_site_get_tenant_broker

Tenant broker status

ras_site_get_notifications

Notification event configuration

ras_site_get_url_redirection

URL redirection rules

ras_site_get_cpu_optimization

CPU optimization settings

ras_policies_list

List all client policies

ras_farm_get_administrators

Admin accounts and roles

ras_farm_get_config

Farm configuration

ras_farm_get_licensing

Licensing status and seat usage

ras_farm_get_version

Web service version

ras_farm_get_performance

Performance monitor configuration

ras_farm_get_mailbox

SMTP mailbox settings

ras_farm_get_reporting

Reporting configuration

ras_pub_get_rds_apps

Published RDS applications

ras_pub_get_vdi_apps

Published VDI applications

ras_pub_get_avd_apps

Published AVD applications

ras_pub_get_desktops

Published desktops

ras_pub_get_folders

Resource folders

ras_pub_get_status

Publishing service status

ras_pub_get_all_items

All published items (combined view)

ras_sessions_list

Active remote desktop sessions

ras_support_info

Support information