Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Mats2208/MCP-Packet-Tracer/llms.txt

Use this file to discover all available pages before exploring further.

MCP Packet Tracer is a Model Context Protocol server that bridges any LLM — GitHub Copilot, Claude, Codex, Cursor — to Cisco Packet Tracer. Describe a network in plain English and the server plans, validates, generates IOS configs, and deploys the topology directly into a running Packet Tracer instance in real time.

Quickstart

Install the server and build your first topology in under five minutes.

How It Works

Understand the planning, validation, and live-deploy pipeline.

MCP Tools Reference

Browse all 33 MCP tools across planning, generation, and topology interaction.

Live Deploy Setup

Configure the HTTP bridge to stream commands directly into Packet Tracer.

What You Can Do

MCP Packet Tracer covers the complete network automation workflow — from a single natural-language prompt to a fully configured, running topology.

Plan Topologies

Generate complete TopologyPlan objects with automatic IP addressing, DHCP pools, and routing from a prompt.

Routing Protocols

Full IOS command generation for Static, OSPF, EIGRP, and RIP v2.

ACL & NAT

Apply standard, extended, and named ACLs plus Static NAT, Dynamic NAT, and PAT to live routers.

Expansion Modules

Hot-install HWIC, NIM, NM, and WIC modules on routers already placed in the canvas.

Device Catalog

74 device models, 151 expansion modules, and 15 cable types across 34 categories.

Client Setup

Connect Claude Code, Claude Desktop, VS Code Copilot, Cursor, or any MCP client.

At a Glance

CapabilityDetails
MCP Tools33 tools — planning, validation, generation, deploy, ACL, NAT, modules
MCP Resources5 read-only catalog resources (pt://catalog/…)
Device Models74 models across 34 categories
Expansion Modules151 modules (HWIC, NIM, NM, WIC, SFP, and more)
Cable Types15 cable types with automatic inference
Routing ProtocolsStatic, OSPF, EIGRP, RIP v2
Transportstdio (desktop clients) or streamable-HTTP on :39000
Live DeployReal-time HTTP bridge on :54321 — no copy-paste

Get Started in 3 Steps

1

Install the server

Clone the repo and install it as an editable Python package:
git clone https://github.com/Mats2208/MCP-Packet-Tracer
cd MCP-Packet-Tracer
pip install -e .
2

Connect your MCP client

Register the server with your preferred AI client. For Claude Code:
claude mcp add --scope user --transport stdio packet-tracer -- python -m packet_tracer_mcp --stdio
See Client Setup for VS Code, Cursor, Claude Desktop, and Codex CLI.
3

Ask your LLM to build a network

"Create a network with 3 routers, OSPF routing, DHCP on each LAN, and 2 PCs per router"
The server plans → validates → generates → deploys the topology automatically.
Live deploy into a running Packet Tracer instance requires a one-time bridge setup. See Live Deploy Setup for the bootstrap snippet. The MCP tools work without the bridge too — you can plan, generate scripts, and export configs to disk.

Build docs developers (and LLMs) love