Auvik Lifecycle

Auvik Device Lifecycle

Assess the end-of-life posture, warranty and service contract coverage, and configuration backup history of Auvik-managed devices. Supports hardware refresh planning, renewal pipeline management, and QBR lifecycle reporting across MSP tenants.

MCP Server

• Server: auvik-mcp (NetClaw MCP, Feature 036)
• Command: python3 mcp-servers/auvik-mcp/auvik_mcp_server.py (stdio transport)
• Auth: Basic auth via AUVIK_USERNAME + AUVIK_API_KEY
• Read-only: GET operations only — no lifecycle record modifications

Available Tools

Key Concepts

Tenants = MSP clients. All three tools accept an optional tenants parameter (name or domain prefix). Omit it to query all visible tenants; provide it to scope to a single client.

Identifier resolution. The device parameter on all three tools accepts a hostname, IP address, partial name, or Auvik numeric ID. The server resolves names and IPs to internal IDs automatically. Ambiguous matches return ResolutionCandidate[].

Lifecycle status fields. auvik_list_device_lifecycle surfaces four independent status dimensions:

• sales_availability — whether the device is still sold by the vendor
• software_maintenance_status — whether the OS/firmware receives updates
• security_software_maintenance_status — whether security patches are still released
• last_support_status — whether the vendor still provides any support

Warranty vs. service. auvik_list_device_warranty distinguishes between manufacturer warranty (covered_under_warranty) and service contracts such as SMARTnet or NBD (covered_under_service). A device may have one, both, or neither.

Configuration backups. auvik_list_configurations returns a list of backup records. Retrieve the full configuration text by passing the config_id of a specific record. Use is_running=true to filter for running-config backups vs. startup-config. Combine backup_time_after and backup_time_before (ISO-8601) to bound a review window.

Cursor pagination. List tools auto-aggregate all pages up to AUVIK_MAX_PAGES. Narrow filters (e.g., a specific tenant + device) to manage response size on large inventories.

Workflow

Hardware Refresh Planning

1. Start GAIT branch: gait_branch with name like auvik-lifecycle-review-<client>-2026-06-21
2. List all lifecycle data: auvik_list_device_lifecycle with tenants=<client> — no status filter to capture full picture
3. Identify at-risk devices: re-run with last_support_status=endOfLife to isolate unsupported hardware
4. Check warranty gaps: auvik_list_device_warranty with covered_under_warranty=false, covered_under_service=false to find completely uncovered devices
5. Cross-reference inventory: auvik-inventory (auvik_list_devices) with detail_level=detail to get make/model, install location, and online status
6. Record in GAIT: commit a refresh candidate list with device names, EoL dates, and warranty status

QBR Lifecycle Report for an MSP Client

1. Pull lifecycle posture: auvik_list_device_lifecycle with tenants=<client> — all devices
2. Pull warranty summary: auvik_list_device_warranty with tenants=<client> — coverage per device
3. Identify immediate risk: filter last_support_status=endOfLife + covered_under_service=false — highest-priority refresh candidates
4. Identify upcoming risk: filter software_maintenance_status=endOfSoftwareMaintenance — devices losing patch support soon
5. Record in GAIT: commit QBR lifecycle data with client name and report date

Configuration Backup Audit

1. List recent backups: auvik_list_configurations with tenants=<client>, backup_time_after=<7-days-ago> — verify backups are occurring
2. Check running config: auvik_list_configurations with device=<hostname>, is_running=true — list running-config backup records
3. Retrieve backup body: auvik_list_configurations with config_id=<id> — retrieve full configuration text for a specific backup
4. Spot-check after a change window: narrow backup_time_after and backup_time_before around a maintenance window to confirm configs were captured
5. Record in GAIT: commit backup verification results with timestamps

Integration with Other Skills

Environment Variables

Important Rules

• Read-only — this skill cannot update lifecycle records, warranty data, or trigger configuration backups. All data reflects what Auvik has already collected.
• Refer to devices by name or IP, not by Auvik internal IDs. Pass device=<hostname-or-IP> and let the resolver do the lookup.
• Scope to a tenant in MSP environments to avoid mixing lifecycle data across clients.
• config_id is required to retrieve backup content — auvik_list_configurations without config_id returns metadata only (timestamps, device, backup type); the full configuration text is only returned when a specific config_id is provided.
• Record every session in GAIT — refresh planning decisions, QBR data pulls, and configuration audit results all go to the audit trail.

Failure Behavior

• If a tool call fails with an authentication or connection error, check that AUVIK_API_KEY, AUVIK_BASE_URL, AUVIK_USERNAME are set and valid before assuming a data or device problem.
• On a tool error (timeout, unreachable host, malformed response), report the failure and its error message directly to the user rather than fabricating or guessing at results.
• For a confirmed read-only call, check connectivity and retry once if appropriate. For any call that changes state or sends a message, a timeout does not prove the action failed: inspect current state or delivery status before retrying, preserve the required approval/change gates, and do not repeat an action whose outcome is unknown.