unifi_power_cycle_port · UniFi Network MCP Server MCP

WHAT IT DOES

What unifi_power_cycle_port does on UniFi Network MCP Server

AI agents invoke unifi_power_cycle_port to trigger actions in UniFi Network MCP Server. What it does depends on the arguments the agent supplies, and its effects often reach beyond the immediate call — builds kicked off, notifications sent, workflows started.

WHY IT NEEDS A POLICY

Why unifi_power_cycle_port needs a policy

This tool triggers an external hardware operation — cutting and restoring power to a physical switch port. It is an Execute action because it performs a real-world side effect (power interruption) on network infrastructure. The severity is high because misuse could temporarily take down cameras, access points, or other critical PoE-powered devices, causing service disruption across a site.

From the tool's definition Power-cycle PoE on a specific switch port (briefly drops then restores power)

Attacks that exploit this kind of access

Recommended rule Ready

Verdict

unifi_power_cycle_port Rate-limited

unifi_power_cycle_port stays usable, but rate-capped — a runaway agent can't fire it dozens of times a minute. Everything else on the server is denied unless you say otherwise.

View as policy code

policy.json

{
  "version": "1",
  "default": "deny",
  "tools": {
    "unifi_power_cycle_port": {
      "limits": [
        {
          "counter": "unifi_power_cycle_port_rate",
          "window": "minute",
          "max": 10,
          "scope": "grant"
        }
      ]
    }
  }
}

RATE-LIMIT THIS TOOL →

Instant setup, no code required.

PolicyLayer is an MCP gateway: every tool call is checked against your rule before it reaches UniFi Network MCP Server, so you can run agents against it safely.

FAQ

Questions about unifi_power_cycle_port

What does the unifi_power_cycle_port tool do? +

Power-cycle PoE on a specific switch port (briefly drops then restores power). portIdx is the port number (1-based) as shown in unifi_get_device interfaces.ports[].idx. Use for: rebooting a PoE-powered camera/AP without touching the device. It is categorised as a Execute tool in the UniFi Network MCP Server MCP Server, which means it can trigger actions or run processes. Use rate limits and argument validation.

How do I enforce a policy on unifi_power_cycle_port? +

Register the UniFi Network MCP Server MCP server in PolicyLayer and add a rule for unifi_power_cycle_port: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches UniFi Network MCP Server. Nothing to install.

What risk level is unifi_power_cycle_port? +

unifi_power_cycle_port is a Execute tool with high risk. Execute tools should be rate-limited and have argument validation enabled.

Can I rate-limit unifi_power_cycle_port? +

Yes. Add a rate_limit block to the unifi_power_cycle_port rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block unifi_power_cycle_port completely? +

Set action: deny in the PolicyLayer policy for unifi_power_cycle_port. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides unifi_power_cycle_port? +

unifi_power_cycle_port is provided by the UniFi Network MCP Server MCP server (owine/unifi-network-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.