---
name: device-management
description: Manage device adoption and onboarding, maintain device inventory, and monitor device configurations across your UniFi network infrastructure.
---
# Device Management Skill
Manage device adoption, maintain inventory, and monitor device configurations.
## What this skill does
This skill enables you to:
- Manage device adoption and onboarding process
- Maintain comprehensive device inventory
- Monitor device configurations and status
- Track pending devices awaiting adoption
- Plan device upgrades and replacements
- Monitor UniFi controller status and versions
## When to use this skill
Use this skill when you need to:
- Adopt new devices into the UniFi network
- Create and maintain device inventory
- Check device adoption status
- Monitor controller versions and updates
- Plan hardware refreshes
- Track device models and specifications
- Verify device configuration compliance
## Available Tools
- `get_pending_devices` - List devices pending adoption
- `get_network_devices` - List all adopted devices
- `get_network_device_stats` - Get device specifications and status
- `get_network_info` - Get controller info and system status
## Understanding Site IDs
**Important Note:** Your UniFi site ID may appear as an empty string (`""`) in API responses. This is normal and should be handled as follows:
- When querying via tools, pass an empty string or use "default" for the default site
- The MCP server automatically resolves empty site IDs to your first available site
- In curl commands, you'll see endpoints like `/sites//devices` (double slashes) when the site ID is empty
**Example curl with empty site ID:**
```bash
curl -k -H "X-API-KEY: $UNIFI_API_KEY" \
"$UNIFI_BASE_URL/proxy/network/integration/v1/sites//devices"
```
## Typical Workflows
### New Device Adoption
1. Use `get_pending_devices` to find devices awaiting adoption
2. Review device details (MAC address, IP, model)
3. Plan adoption by site and function
4. Document adoption process completion
### Device Inventory Management
1. Use `get_network_devices` to get current inventory
2. Use `get_network_device_stats` for specifications
3. Organize devices by type and location
4. Create inventory reports
5. Plan upgrade cycles based on age and performance
### System Monitoring
1. Use `get_network_info` to check controller status
2. Monitor controller version and uptime
3. Track system health metrics
4. Plan maintenance windows
5. Verify backup status
## Example Questions
- "Show all devices pending adoption"
- "List the device inventory"
- "What's the controller version and status?"
- "Get specifications for all network devices"
- "Create a device inventory report by type"
- "Plan a device upgrade strategy"
## Response Format
When using this skill, I provide:
- Device listings with MAC addresses and IP information
- Device specifications (model, firmware version)
- Adoption status and pending device details
- System health and version information
- Inventory organization by type/location
- Upgrade recommendations based on age/performance
- Hardware planning suggestions
## Best Practices
- Adopt devices in logical groups (by site/function)
- Maintain up-to-date device inventory
- Document device purpose and location
