cisco-pt-mcp.

Let AI clients control a running Cisco Packet Tracer instance. Open source.

Get Started ★ Star on GitHub

18 tools.
One bridge.

Want more tools? Open an issue on GitHub.

addDevice
Drop a router, switch, or PC onto the canvas at a given position.
addModule
Install an interface module into a device slot (e.g. WIC card).
addLink
Connect two devices with straight-through, crossover, serial, or fiber cable.
removeDevice
Delete one or more devices from the topology by name.
removeLink
Delete one or more cables by device and port name.
renameDevice
Rename an existing device. New name must be unique in the workspace.
moveDevice
Reposition a device to new coordinates on the canvas.
setPower
Power a device on or off.
configurePcIp
Set static IP, subnet, gateway, DNS, or enable DHCP on a PC.
configureIosDevice
Run any IOS CLI commands on a router or switch. Multi-line configs supported.
getNetwork
Snapshot of all devices, interfaces, and cable connections in the workspace.
getDeviceInfo
Detailed view of a single device: model, interfaces, and connected neighbours.
setSimulationMode
Switch between simulation mode and realtime mode.
getSimulationStatus
Query current simulation state: mode, elapsed time, and frame count.
stepSimulation
Step the simulation forward, backward, or reset it entirely.
sendPdu
Add an ICMP ping PDU between two devices using PT's native Simple PDU.
getPduResults
Read PDU outcomes: source, destination, traffic type, and status.
getCommandLog
Read the IOS command history logged by Packet Tracer, optionally filtered by device.

Install.

Two components. Five minutes. Works with Claude, Cursor, VS Code, and more.

1. MCP Server

First install uv if you don't have it, then register with your client:

Terminal
claude mcp add cisco-pt-mcp --scope user -- uvx cisco-pt-mcp
%USERPROFILE%\.cursor\mcp.json
{
  "mcpServers": {
    "cisco-pt-mcp": { "command": "uvx", "args": ["cisco-pt-mcp"] }
  }
}
.vscode/mcp.json
{
  "servers": {
    "cisco-pt-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["cisco-pt-mcp"]
    }
  }
}
%USERPROFILE%\.codex\config.toml
[mcp_servers.cisco-pt-mcp]
command = "uvx"
args = ["cisco-pt-mcp"]

2. Packet Tracer Extension

Download cisco-pt-mcp.pts and install it:

  1. Open Packet Tracer.
  2. Go to Extensions → Scripting → Configure PT Script Modules…
  3. Click Add and select the downloaded cisco-pt-mcp.pts file.
  4. Restart Packet Tracer.

3. Run

Click Extensions → Packet Tracer MCP to open the bridge window, then start your MCP client. The status pill flips to connected within a second. Start prompting.

★ GitHub PyPI Issues