get_device
Retrieve detailed information about UniFi network devices to monitor status, configure settings, and manage network infrastructure.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/tools/devices.js:53-58 (handler)Handler function that executes the 'get_device' tool logic: calls unifi.getDevice with hostId and deviceId, then returns the device data as JSON-formatted text content.
handler: async ({ hostId, deviceId }) => { const device = await unifi.getDevice(hostId, deviceId); return { content: [{ type: 'text', text: JSON.stringify(device, null, 2) }] }; } - src/tools/devices.js:49-52 (schema)Zod input schema validation for the 'get_device' tool requiring hostId and deviceId as strings.
schema: z.object({ hostId: z.string().describe('The host ID'), deviceId: z.string().describe('The device ID or MAC address') }), - src/server.js:28-32 (registration)Registration of the deviceTools module (containing get_device) via registerToolsFromModule in the MCP server setup.
registerToolsFromModule(networkTools); registerToolsFromModule(deviceTools); registerToolsFromModule(clientTools); registerToolsFromModule(protectTools); registerToolsFromModule(accessTools); - src/unifi-client.js:113-116 (helper)Helper function getDevice that makes the actual UniFi Cloud API request to retrieve specific device details.
export async function getDevice(hostId, deviceId) { const response = await cloudApi.get(`/v1/hosts/${hostId}/devices/${deviceId}`); return response.data; }