cisco-pt-mcp

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

Demo

Install

Two components. Five minutes.

1. MCP Server

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

Claude Code

claude mcp add cisco-pt-mcp --scope user -- uvx cisco-pt-mcp

Cursor (~/.cursor/mcp.json or .cursor/mcp.json per project)

{
  "mcpServers": {
    "cisco-pt-mcp": { "command": "uvx", "args": ["cisco-pt-mcp"] }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "cisco-pt-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": ["cisco-pt-mcp"]
    }
  }
}

Codex CLI (~/.codex/config.toml)

[mcp_servers.cisco-pt-mcp]
command = "uvx"
args = ["cisco-pt-mcp"]

2. Packet Tracer Extension

Open Packet Tracer.
Go to Extensions → Scripting → Configure PT Script Modules…
Click Add and select cisco-pt-mcp.pts.
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.

Tools

Tool	Description
`addDevice`	Drop a router, switch, or PC onto the canvas
`addModule`	Install an interface module into a device slot
`addLink`	Connect two devices with a cable
`removeDevice`	Delete one or more devices
`removeLink`	Delete one or more cables
`renameDevice`	Rename an existing device
`moveDevice`	Reposition a device on the canvas
`setPower`	Power a device on or off
`configurePcIp`	Set IP, subnet, gateway, DNS, or enable DHCP on a PC
`configureIosDevice`	Run IOS CLI commands on a router or switch
`getNetwork`	Snapshot of all devices, interfaces, and cables
`getDeviceInfo`	Detailed view of a single device
`setSimulationMode`	Switch between simulation and realtime mode
`getSimulationStatus`	Query simulation state and frame count
`stepSimulation`	Step the simulation forward, backward, or reset
`sendPdu`	Add an ICMP ping PDU between two devices
`getPduResults`	Read PDU outcomes after stepping the simulation
`getCommandLog`	Read the IOS command history logged by Packet Tracer

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cisco_pt_mcp-0.1.6.tar.gz (11.6 kB view details)

Uploaded Aug 12, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

cisco_pt_mcp-0.1.6-py3-none-any.whl (11.7 kB view details)

Uploaded Aug 12, 2026 Python 3

File details

Details for the file cisco_pt_mcp-0.1.6.tar.gz.

File metadata

Download URL: cisco_pt_mcp-0.1.6.tar.gz
Upload date: Aug 12, 2026
Size: 11.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for cisco_pt_mcp-0.1.6.tar.gz
Algorithm	Hash digest
SHA256	`e51c9c817a8cec05cc2e9ab82d40794f48f19f4c71c4779fb5c4625f912e32c0`
MD5	`67efc0db740fbdbe786e7d2b773aeef4`
BLAKE2b-256	`de6bdca740e803e4e2fb28f487f999ded084e6c841553355016df9d8bc6b4e40`

See more details on using hashes here.

Provenance

The following attestation bundles were made for cisco_pt_mcp-0.1.6.tar.gz:

Publisher: publish.yml on muhammadbalawal/cisco-pt-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: cisco_pt_mcp-0.1.6.tar.gz
- Subject digest: e51c9c817a8cec05cc2e9ab82d40794f48f19f4c71c4779fb5c4625f912e32c0
- Sigstore transparency entry: 2429916776
- Sigstore integration time: Aug 12, 2026
Source repository:
- Permalink: muhammadbalawal/cisco-pt-mcp@4b277cba5d6ef5cee2d4fc6fa1768206eb841e8e
- Branch / Tag: refs/tags/v0.1.6
- Owner: https://github.com/muhammadbalawal
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@4b277cba5d6ef5cee2d4fc6fa1768206eb841e8e
- Trigger Event: push