omada-mcp

Adopt a pending device by its MAC address into the site.

Batch set names on multiple switch ports. Each entry specifies a port number and name (1-128 chars).

Batch enable or disable PoE on multiple switch ports. 1=on (802.3at/af), 0=off.

Batch enable or disable profile override on multiple switch ports.

Batch enable or disable multiple switch ports. 0=off, 1=on.

Block a client device by its MAC address, preventing it from accessing the network.

Create a new LAN network with VLAN, gateway/subnet, and DHCP settings.

Create a new LAN profile with native/tagged network assignments and port settings.

Delete a firewall ACL rule by its ID.

Delete a LAN network by its network ID.

Get cable test results for a switch. Run startCableTest first.

Fetch details for a specific Omada client.

Fetch detailed information for a specific Omada device.

Query statistics for global adopted devices with pagination and filtering. Supports fuzzy search by MAC address, name, model, or serial number, and filtering by tag or device series type (0: basic, 1: pro).

Get firewall configuration and rules for a site, including ACL rules, IP groups, and security policies.

Get firmware information for a device including current version and available updates.

Get internet configuration information for a site, including WAN settings and connectivity details.

Get the list of LAN networks configured in a site, including VLAN settings, IP ranges, and DHCP configuration.

Get the list of LAN profiles configured in a site. LAN profiles define network settings that can be applied to switch ports.

Get port forwarding status and rules for a site. Retrieves either User-configured or UPnP-discovered port forwarding rules. Both page and pageSize parameters are required by the API. Call this tool twice (once with type="User" and once with type="UPnP") to get complete port forwarding information.

Get detailed information for a specific SSID (wireless network), including security settings, rate limits, scheduling, and advanced configurations. Requires wlanId (from getWlanGroupList) and ssidId (from getSsidList).

Get the list of SSIDs (wireless networks) configured in a WLAN group. Requires wlanId which can be obtained from getWlanGroupList. Use the ssidId from this list to call getSsidDetail.

Get full switch info including portList array by MAC address.

Get switch networks / VLAN trunking configuration for a switch.

Get all ports for a switch by its MAC address, including status, profile, PoE, link speed, and STP state.

Fetch detailed information for a specific switch stack.

Get the global view threat management list. Returns paginated threat information including severity, source/destination IPs, countries, classification, and more.

Get the list of WLAN groups configured in a site. WLAN groups contain SSIDs and define wireless network settings. Use the wlanId from this list to call getSsidList.

List network clients connected to a site.

Get client activity statistics over time from the dashboard. Returns time-series data showing new, active, and disconnected clients (both wireless/EAP and wired/switch) for each time snapshot. Useful for monitoring client connection trends and activity patterns.

Get client past connection list with historical connection data. Returns information about clients that have previously connected to the network, including connection timestamps, traffic data, duration, and device details. Supports pagination, filtering by time range and guest status, sorting by las…

List provisioned network devices for a specific site.

List paginated events for a site (alerts, warnings, system events).

List firewall ACL rules for a site (access control lists for inter-VLAN traffic, etc.).

List paginated logs for a site (system logs, configuration changes).

Get the most active clients in a site, sorted by total traffic. Returns client name, MAC address, type, model, wireless status, and total traffic. This is a dashboard endpoint that provides a quick overview of top clients by traffic usage.

List static routes configured for a site.

List all sites configured on the Omada controller.

Reboot a network device by its MAC address.

Force a client to reconnect to the network by its MAC address.

Search for devices globally across all sites the user has access to. Returns devices matching the search key.

Set the LED on/off/site-default for a device by its MAC address.

Connect or disconnect a gateway WAN port.

Set switch networks / VLAN trunking configuration for a switch.

Set the name of a single switch port (1-128 characters).

Enable or disable PoE on a single switch port. 1=on (802.3at/af), 0=off.

Assign a LAN profile to a single switch port.

Enable or disable profile override on a single switch port.

Enable or disable a single switch port. 0=off, 1=on.

Start a cable test on a switch. Use getCableTestResults to retrieve results after completion.

Start a firmware upgrade for a device. Use getFirmwareDetails first to check for available updates.

Unblock a previously blocked client device by its MAC address, restoring network access.

Update client settings such as display name, static IP, and rate limits.

Update an existing LAN network configuration including VLAN, gateway/subnet, and DHCP settings.

Update an existing LAN profile configuration including network assignments and port settings.

Update a switch port configuration (profile, PoE, speed, STP, isolation, etc.).