get_vm_power_state
Check the power state of a specific virtual machine in VMware Fusion. Input the VM ID to verify if it is powered on, off, or suspended.
Instructions
Get the power state of a specific VM.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| vm_id | Yes |
Implementation Reference
- vmware_fusion_mcp/server.py:61-64 (registration)Registration of the 'get_vm_power_state' tool using the @mcp.tool decorator. This function serves as the entry point for the MCP tool.@mcp.tool async def get_vm_power_state(vm_id: str) -> Dict[str, Any]: """Get the power state of a specific VM.""" return await _get_vm_power_state_impl(vm_id)
- vmware_fusion_mcp/server.py:54-59 (handler)Core handler implementation for the get_vm_power_state tool. Creates a VMwareClient instance and calls its get_vm_power_state method to fetch the VM power state.async def _get_vm_power_state_impl(vm_id: str) -> Dict[str, Any]: """Get the power state of a specific VM.""" async with VMwareClient(username=VMREST_USER, password=VMREST_PASS) as client: state = await client.get_vm_power_state(vm_id) return state # type: ignore[no-any-return]
- Supporting VMwareClient method that performs the HTTP GET request to the Fusion REST API endpoint /api/vms/{vm_id}/power to retrieve the power state.async def get_vm_power_state( self, vm_id: str, vm_password: Optional[str] = None ) -> Dict[str, Any]: """Get the power state of a specific VM. Args: vm_id: The ID of the VM vm_password: The password for the VM (if required) Returns: Dictionary with the VM's power state """ try: url = f"{self.base_url}/api/vms/{vm_id}/power" params = {} if vm_password: params["vmPassword"] = vm_password response = await self._client.get( url, headers=self._auth_header, params=params or None, ) response.raise_for_status() return response.json() # type: ignore[no-any-return] except httpx.RequestError as e: raise Exception(f"Failed to connect to VMware Fusion API: {e}") except httpx.HTTPStatusError as e: if e.response.status_code == 404: raise Exception(f"VM with ID '{vm_id}' not found") raise Exception( f"VMware Fusion API error: {e.response.status_code} - " f"{e.response.text}" )