Add a network device to the workspace. Call getNetwork first if unsure whether the chosen deviceName is already taken; names must be unique.

Add an interface module to a device. Powers the device off, installs the module, powers it back on.

Connect two devices with a cable. Both interfaces must be free (in_use=false in getNetwork output). If unsure, call getNetwork first.

Remove one or more devices from the workspace.

Remove one or more cables. Each entry identifies one endpoint of the link.

Configure IP settings on a PC or end device.

Execute IOS commands on a router or switch. Commands run from global config and are saved with 'write memory'.

Snapshot of the entire workspace: every device, its interfaces (with in_use flags), and every cable. Call this before addLink or removeDevice when unsure of current state.

Detailed info about one device, including interfaces and incident links.

Switch Packet Tracer between simulation mode and realtime mode. Simulation mode is required before sending PDUs or stepping through traffic.

Query the current simulation state: mode (realtime or simulation), elapsed simulation time, PDU frame count, and current frame index.

Step the simulation forward or backward, or reset it entirely. PT must already be in simulation mode (use setSimulationMode first).

Add an ICMP ping PDU between two devices using PT's native Simple PDU mechanism. Automatically enables simulation mode if not already active. Use stepSimulation to advance and getPduResults to check if the ping succeeded.

Rename an existing device. The new name must be unique in the workspace.

Move a device to new coordinates on the logical workspace canvas.

Power a device on or off.

Read the outcome of PDUs in the current simulation — source, destination, traffic type, and status (accepted/dropped/in_transit/etc). Call after stepSimulation to verify connectivity. Use the types filter to show only ICMP, TCP, etc. and hide STP/DTP background noise.

Read the IOS command history logged by Packet Tracer. Optionally filter by device name and cap the number of returned entries.

Use AI (Gemini) to generate a complete network topology from a natural language description. Returns a full network design including devices, links, IP addressing, and configurations. Requires GEMINI_API_KEY environment variable or ~/.cisco-pt-mcp/config.json with gemini_api_key.

Use AI (Gemini) to generate PTBuilder JavaScript code from a natural language description. Returns executable JavaScript code that can be run in the PTBuilder code editor. Requires GEMINI_API_KEY environment variable or ~/.cisco-pt-mcp/config.json with gemini_api_key.

Execute PTBuilder JavaScript code in Packet Tracer. The code can use PTBuilder functions like addDevice, addLink, configurePcIp, configureIosDevice, etc. This is useful for batch operations and programmatic network building.

Build a complete network in Packet Tracer from a structured design specification. Accepts a JSON design with devices, links, and configurations. Useful for importing designs or building from AI-generated specifications.

Open the PTBuilder code editor interface in Packet Tracer. This provides a web-based code editor where users can write and execute JavaScript code to automate network building.