restart_device
Restart UniFi network devices to resolve connectivity issues or apply configuration changes. This tool helps maintain network stability by rebooting access points, switches, and gateways through the UniFi MCP Server.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/tools/devices.js:83-104 (handler)Primary MCP tool handler and schema for 'restart_device'. Validates input with Zod schema requiring hostId, deviceId, and confirm flag. Checks confirmation before calling unifi.restartDevice and returns formatted response.restart_device: { description: 'Restart a UniFi device (access point, switch, etc.)', schema: z.object({ hostId: z.string().describe('The host ID'), deviceId: z.string().describe('The device ID'), confirm: z.boolean().describe('Confirm you want to restart the device') }), handler: async ({ hostId, deviceId, confirm }) => { if (!confirm) { return { content: [{ type: 'text', text: 'Device restart cancelled. Set confirm=true to proceed.' }] }; } const result = await unifi.restartDevice(hostId, deviceId); return { content: [{ type: 'text', text: `Device restart initiated. ${JSON.stringify(result, null, 2)}` }] }; } },
- src/unifi-client.js:187-190 (helper)Core helper function that executes the UniFi Cloud API POST request to restart the specified device on the given host.export async function restartDevice(hostId, deviceId) { const response = await cloudApi.post(`/v1/hosts/${hostId}/devices/${deviceId}/restart`); return response.data; }
- src/server.js:28-32 (registration)Registration point where deviceTools (containing restart_device) is registered on the MCP server via registerToolsFromModule.registerToolsFromModule(networkTools); registerToolsFromModule(deviceTools); registerToolsFromModule(clientTools); registerToolsFromModule(protectTools); registerToolsFromModule(accessTools);
- src/unifi-client.js:409-409 (helper)Export of the restartDevice helper function as part of the default unifi module export.restartDevice,