list_switch_ports

What list_switch_ports does on API-Central

AI agents call list_switch_ports to retrieve information from API-Central without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.

Why list_switch_ports is rated Low

This tool retrieves information about switch ports/interfaces from the network infrastructure. It supports optional filtering but performs no modifications, deletions, or code execution. The read-only nature with query capabilities places it clearly in the Read category with low severity, as it poses minimal risk if accessed by an AI agent—the worst outcome is exposure of network topology information.

From the tool's definition Tool name 'list_switch_ports' and description 'List switch interfaces with optional OData filtering' indicate data retrieval without modification. The verb 'list' is explicitly a Read operation per the category definitions.

The rule that runs list_switch_ports safely

PolicyLayer is an MCP gateway: it sits between your AI agents and API-Central, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For list_switch_ports, this is the rule to start with:

{
  "version": "1",
  "default": "deny",
  "tools": {
    "list_switch_ports": {}
  }
}

Questions about list_switch_ports