UniFi MCP Server

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,