unifi-channel-planning

UniFi Channel Planning

Use this skill to produce a deterministic channel plan from MCP output.

Primary intent:

• Reduce overlap and co-channel contention.
• Keep assignments reproducible and explainable.
• Provide safe change rollout with validation.

Required MCP Inputs

Tool	Purpose
list_sites	Select target site
list_devices_by_type	Get managed AP inventory (type=uap)
list_site_internal_ap_neighbors_v2	Build internal AP-to-AP graph for one site in one call

Conditional / Optional MCP Inputs

Tool	When to use
list_neighboring_aps	Optional external RF tie-breaker or explanation; do not fetch by default
list_ap_neighbors_v2	Per-AP drill-down, debugging, or partial-result validation
get_device_details	When radio configuration, current channel, width, or regulatory capabilities are not available from inventory

Optional execution tool:

Tool	Purpose
set_ap_radio_channel	Apply proposed channel per AP/radio

Data Contract For Planning

Expected fields from neighbor observations:

• ap_mac: AP that observed the neighbor
• bssid or mac: observed AP/BSSID identity
• channel: observed neighbor channel number
• signal: RSSI (dBm)
• last_seen: freshness indicator
• radio or band: required radio/band dimension (ng/2.4 GHz or na/5 GHz)
• channel_width or ht: channel width, required when available for 5 GHz

If any field is missing:

• Drop records without ap_mac, channel, or signal.
• Do not use records without a band/radio dimension for channel assignment.
• Keep records without width only for a conservative 20 MHz fallback and mark the affected recommendation medium-confidence.
• Keep processing with partial data and log dropped count.

Correct Data Source Split (Critical)

Use two distinct datasets and do not mix them:

1. Internal AP-to-AP graph (for channel assignment):

• Primary source: list_site_internal_ap_neighbors_v2(site_id, start_ms, end_ms, min_rssi)
• The tool already executes v2 per-AP neighbor queries and keeps only rows where neighbor mac is a managed AP MAC from the same site.
• Optional fallback/debug: list_ap_neighbors_v2 per AP.
• This is the authoritative input for "which site AP sees which other site AP and how strong".