Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| RAS_HOST | Yes | RAS server hostname or IP address | |
| RAS_PORT | No | REST API port | 20443 |
| RAS_PASSWORD | Yes | Administrator password | |
| RAS_USERNAME | Yes | Administrator username | |
| RAS_IGNORE_TLS | No | Skip TLS certificate verification (for self-signed certs) | true |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ras_infra_get_agents | List all Parallels RAS agents deployed across the farm, including their hostname, IP, OS, agent version, and current status. Use this to verify agent deployment, diagnose connectivity issues, or check agent versions. |
| ras_infra_get_connection_brokers | Get connection broker status, priority, and configuration. Connection brokers handle user session brokering and load distribution. Use this to check broker health, verify primary/secondary priority, or diagnose session routing issues. |
| ras_infra_get_providers | List all cloud and hypervisor providers configured in the RAS farm, including AVD, AWS EC2, Azure, Hyper-V, Nutanix, vCenter, and VMware ESXi. Use this to verify provider connectivity, check provider types, or audit multi-cloud config. |
| ras_infra_get_rds_hosts | List RDS (Remote Desktop Services) session hosts and their details including hostname, IP, agent status, active sessions, CPU/RAM usage, and OS version. Use this to monitor host health, check capacity, or troubleshoot RDS issues. |
| ras_infra_get_rds_hostpools | 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. |
| ras_infra_get_certificates | List the certificate inventory for the RAS farm, including certificate names, expiration dates, issuers, and usage. Use this to audit SSL/TLS certificates, check for upcoming expirations, or verify certificate assignments. |
| ras_infra_get_halb_status | Get the status of HALB (High Availability Load Balancer) devices in the farm. Returns device health, IP addresses, and operational state. Use this to monitor load balancer availability or diagnose gateway connectivity issues. |
| ras_infra_get_enrollment_status | Get enrollment server status. Enrollment servers handle SCEP certificate enrollment for device management. Use this to check enrollment server health or troubleshoot certificate enrollment failures. |
| ras_infra_get_vdi_hostpools | List VDI host pool configuration, including pool members, provisioning settings, and capacity. Use this to review VDI pool composition, check desktop provisioning status, or verify pool sizing. |
| ras_infra_get_vdi_templates | 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 status, or provisioning settings. |
| ras_infra_get_gateway_status | Get the status of RAS Secure Client Gateways, including connection state, IP addresses, and tunnel mode. Gateways provide external user access to published resources. Use this to monitor gateway health or troubleshoot external connectivity issues. |
| ras_infra_get_sites | 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 site configuration, or audit the farm topology. |
| ras_infra_get_saml_idps | List SAML identity providers configured for single sign-on (SSO). Returns provider names, metadata URLs, and configuration details. Use this to audit SSO configuration or troubleshoot SAML authentication issues. |
| ras_infra_get_themes | List user portal themes configured in the RAS farm, including branding, logos, and customisation settings. Use this to review portal appearance configuration or verify theme assignments. |
| ras_site_get_ad_integration | Get Active Directory integration configuration, including domain settings, forest trust relationships, and OU mappings. Use this to verify AD connectivity, check domain join status, or troubleshoot authentication issues. |
| ras_site_get_connection_settings | Get connection and authentication settings, including session timeouts, client connection policies, and authentication methods. Use this to review security posture or troubleshoot client connection issues. |
| ras_site_get_fslogix | Get FSLogix profile container configuration, including VHD location paths, size limits, and redirection settings. Use this to verify profile management setup, check storage paths, or troubleshoot profile loading issues. |
| ras_site_get_load_balancing | Get load balancing settings, including balancing method, resource weights, and session limits. Use this to review how sessions are distributed across RDS hosts or diagnose uneven load distribution. |
| ras_site_get_mfa | Get multi-factor authentication provider configuration, including enabled MFA providers (TOTP, RADIUS, Deepnet, SafeNet, Email OTP), criteria rules, and bypass conditions. Use this to audit MFA security posture or troubleshoot MFA login failures. |
| ras_site_get_printing | Get printing configuration settings, including printer redirection, universal printing options, and driver policies. Use this to troubleshoot print redirection issues or review printing policy configuration. |
| ras_site_get_tenant_broker | Get 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. |
| ras_site_get_notifications | Get notification event configuration, including alert triggers, email notifications, and event thresholds. Use this to review which events trigger admin notifications or verify alerting is properly configured. |
| ras_site_get_url_redirection | Get 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. |
| ras_site_get_cpu_optimization | Get 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. |
| ras_policies_list | List all Parallels RAS client policies, including policy names, settings, and assignment status. Client policies control user experience settings such as display, audio, printing, and device redirection. Use this to audit policy configuration or troubleshoot client behaviour issues. |
| ras_farm_get_administrators | List RAS farm administrator accounts, including usernames, roles, permissions, and group membership. Use this to audit admin access, verify role assignments, or review who has administrative control of the farm. |
| ras_farm_get_config | Get RAS farm configuration settings, including farm name, domain, backup settings, and global options. Use this to review the overall farm setup, verify domain configuration, or check backup scheduling. |
| ras_farm_get_licensing | Get RAS licensing status, including license type (subscription/perpetual), expiration date, seat count, usage, and activation status. Use this to check license compliance, verify capacity, or diagnose licensing issues. |
| ras_farm_get_version | Get the 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. |
| ras_farm_get_performance | Get performance monitor configuration and counters for the RAS farm. Includes resource utilisation thresholds and monitoring settings. Use this to review performance baselines or check monitoring configuration. |
| ras_farm_get_mailbox | Get the SMTP mailbox configuration used for RAS email notifications, including server address, port, and sender details. Use this to verify email notification settings or troubleshoot notification delivery failures. |
| ras_farm_get_reporting | Get reporting configuration for the RAS farm, including report scheduling, data retention, and database connection settings. Use this to verify reporting is enabled and properly configured. |
| ras_pub_get_rds_apps | List published RDS (Remote Desktop Services) applications, including app names, executable paths, server associations, and user filter assignments. Use this to review which applications are published via RDS, check app configurations, or troubleshoot application launch issues. |
| ras_pub_get_vdi_apps | List published VDI (Virtual Desktop Infrastructure) 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. |
| ras_pub_get_avd_apps | List published Azure Virtual Desktop (AVD) applications. AVD apps are delivered from Azure-hosted session hosts. Use this to review AVD app assignments or verify Azure-based application publishing. |
| ras_pub_get_desktops | List published desktop resources, including full desktops available to users via RDS, VDI, or AVD. Use this to review desktop assignments, check which desktop types are published, or verify user access. |
| ras_pub_get_folders | List published resource folders that organise applications and desktops into logical groups for end users. Use this to review the folder hierarchy, check resource organisation, or verify folder-level access settings. |
| ras_pub_get_status | Get the 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. |
| ras_pub_get_all_items | 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, or to search across all resource types. |
| ras_sessions_list | List all active remote desktop sessions across the RAS farm, including username, client IP address, device name, session state, screen resolution, and connected server. Use this to monitor active users, check session counts, troubleshoot user connectivity, or identify idle/disconnected sessions. |
| ras_support_info | Get Parallels RAS support information, including support contact details, product version, build number, and support entitlement. Use this to check the installed RAS version, verify support status, or gather information for a support ticket. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |