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.

The device catalog is the authoritative list of every hardware model MCP Packet Tracer can place on a Packet Tracer canvas. Each entry records the model’s pt_type identifier, device category, and the exact port names that PT’s Script Engine expects — for example GigabitEthernet0/0 rather than the shorthand Gig0/0. When you submit a topology request the orchestrator resolves every device name or alias against this catalog, selects the right model, and emits addDevice() calls using these exact strings. The catalog contains 74 models spanning 34 categories; the default router is the 2911 (3× GigabitEthernet) and the default switch is the 2960-24TT (24× FastEthernet + 2× GigabitEthernet).

Routers (15 models)

No router ships with Serial ports by default. Serial WAN links require HWIC or NIM expansion modules installed after device placement.
ModelPortsInterface Name Format
18412× FastEthernetFa0/0, Fa0/1
19412× GigabitEthernetGig0/0, Gig0/1
2620XM1× FastEthernetFa0/0
2621XM2× FastEthernetFa0/0, Fa0/1
28112× FastEthernetFa0/0, Fa0/1
29012× GigabitEthernetGig0/0, Gig0/1
29113× GigabitEthernetGig0/0, Gig0/1, Gig0/2 — Default
819HG-4G-IOX1× Gig + 1× FaGig0, Fa0
819HGW1× Gig + 1× FaGig0, Fa0
8292× GigabitEthernetGig0, Gig1
CGR12402× GigabitEthernetGig0/0, Gig0/1
ISR43212× GigabitEthernetGig0/0/0, Gig0/0/1
ISR43313× GigabitEthernetGig0/0/0, Gig0/0/1, Gig0/0/2
Router-PT2× FastEthernetFa0/0, Fa0/1 — Generic
Router-PT-EmptynoneNo ports (add via modules)
The 2911 is the recommended default for most topologies because it provides three GigabitEthernet interfaces natively — one for each adjacent LAN or inter-router link — without requiring modules.

Switches — Layer 2 (5 models)

ModelPortsNotes
2950-2424× Fa0/1–Fa0/24Basic L2
2950T-2424× Fa0/1–Fa0/24 + 2× Gig0/1–Gig0/2
2960-24TT24× Fa0/1–Fa0/24 + 2× Gig0/1–Gig0/2Default switch
Switch-PT8× Fa0/1–Fa0/8Generic
Switch-PT-EmptynoneNo ports (add via modules)

Switches — Layer 3 (3 models)

ModelPortsNotes
3560-24PS24× Fa0/1–Fa0/24 + 2× Gig0/1–Gig0/2L3 routing capable
3650-24PS24× Fa0/1–Fa0/24 + 2× Gig0/1–Gig0/2L3 routing capable
IE-20008× Fa0/1–Fa0/8 + 2× Gig0/1–Gig0/2Industrial Ethernet

End Devices (12 models)

ModelCategoryPortNotes
PC-PTpcFastEthernet0
Server-PTserverFastEthernet0
Laptop-PTlaptopFastEthernet0
TabletPC-PTpcFastEthernet0
SMARTPHONE-PTpcFastEthernet0
Printer-PTpcFastEthernet0
WirelessEndDevice-PTwireless_end_deviceWireless-only end device
WiredEndDevice-PTwired_end_deviceFastEthernet0
TV-PTtvFastEthernet0
Home-VoIP-PTvoipFastEthernet0Home VoIP phone
Analog-Phone-PTanalog_phonePhone0
Embedded-Server-PTembedded_serverFastEthernet0

Access Points & Wireless (8 models)

ModelCategoryPortsNotes
AccessPoint-PTaccesspointPort 0Standard AP
AccessPoint-PT-AaccesspointPort 0802.11a
AccessPoint-PT-NaccesspointPort 0802.11n
AccessPoint-PT-ACaccesspointPort 0802.11ac
LAP-PTaccesspointPort 0Lightweight AP (managed by WLC)
3702iaccesspointGigabitEthernet0Cisco 3702i AP
802accesspointFa0Cisco 802 Wireless Bridge
803accesspointFa0Cisco 803 Wireless Bridge

Security / Firewalls (2 models)

ModelCategoryPortsNotes
5505firewall8× Fa0/0–Fa0/7Cisco ASA 5505
5506-Xfirewall8× Gig1/0–Gig1/7Cisco ASA 5506-X — Default

Wireless LAN Controllers (3 models)

ModelCategoryPortsNotes
WLC-PTwlcGig1–Gig8Generic WLC
WLC-2504wlcGig1–Gig4Cisco WLC 2504
WLC-3504wlcGig1–Gig4Cisco WLC 3504

Cloud / WAN (2 models)

ModelCategoryPortsNotes
Cloud-PTcloudEthernet6WAN simulation node
Cloud-PT-EmptycloudnoneEmpty cloud (add via modules)

Network Connectivity (4 models)

ModelCategoryPortsNotes
Hub-PThubPort 0–Port 7 (8 ports)Layer 1 hub
Bridge-PTbridgePort 0, Port 1
Repeater-PTrepeaterPort 0, Port 1
CoAxialSplitter-PTsplitterCoaxial0–Coaxial34-port coaxial splitter

Modems (2 models)

ModelCategoryPortsNotes
DSL-Modem-PTmodemEthernet0, Coaxial0
Cable-Modem-PTmodemEthernet0, Coaxial0

Home / Consumer Routers (2 models)

ModelCategoryPortsNotes
Linksys-WRT300Nwireless_routerInternet + 4× EthernetLinksys WRT300N
HomeRouter-PT-AChome_gatewayInternet + 4× EthernetHome Router AC

IP Phone (1 model)

ModelCategoryPortsNotes
7960ip_phonePort 0 (switch), PC PortCisco IP Phone 7960

Meraki / SDN (2 models)

ModelCategoryPortsNotes
Meraki-MX65Wmeraki12× GigabitEthernetMeraki MX65W
Meraki-ServermerakiGig0Meraki Dashboard Server

Network Controllers (2 models)

ModelCategoryPortsNotes
NetworkControllernetwork_controllerGig0Generic SDN controller
DLC100network_controllerFa0DWDM DLC-100

Telecom / Special (3 models)

ModelCategoryPortsNotes
Cell-Towercell_towerCoaxial0Cellular tower
Central-Office-Servercentral_officeEthernet0Telco central office
SniffersnifferFastEthernet0Packet capture

Embedded / IoT (3 models)

ModelCategoryPortsNotes
MCU-PTmcuMicrocontroller (no fixed ports)
SBC-PTsbcFastEthernet0Single Board Computer
ThingiotGeneric IoT device (represents ~80 IoT types)

Physical Infrastructure (5 models)

ModelCategoryPortsNotes
Copper Patch Panelpatch_panel24× FastEthernet
Fiber Patch Panelpatch_panel24× Fiber
Copper Wall Mountwall_mountFa0, Fa1
Fiber Wall Mountwall_mountFiber0, Fiber1
Power Distribution Devicepower_dist

Device Aliases

The server ships 101 aliases that let LLMs (and humans) use plain English names instead of Cisco model numbers. Aliases are case-insensitive and resolved before any catalog lookup.
AliasResolves toAliasResolves to
router2911switch2960-24TT
pc, computerPC-PTserverServer-PT
laptopLaptop-PTtabletTabletPC-PT
smartphone, phoneSMARTPHONE-PTprinterPrinter-PT
cloud, wanCloud-PTap, wifi, access_pointAccessPoint-PT
hubHub-PTfirewall, asa5506-X
wlc, wireless_controllerWLC-PTlap, lightweight_apLAP-PT
dsl, modemDSL-Modem-PTcable_modemCable-Modem-PT
1841, 1941, 2811(direct)2901, 2911(direct)
4321, isr4321ISR43214331, isr4331ISR4331
29502950-2429602960-24TT
35603560-24PS36503650-24PS
ie2000, ie-2000IE-2000switch_emptySwitch-PT-Empty
550555055506, 5506x5506-X
ip_phone, 7960, cisco_phone7960meraki, meraki_mx65wMeraki-MX65W
bridgeBridge-PTrepeaterRepeater-PT
splitter, coaxial_splitterCoAxialSplitter-PTsnifferSniffer
mcu, microcontrollerMCU-PTsbc, raspberry, single_boardSBC-PT
iot, thing, sensorThingmeraki_serverMeraki-Server
network_controller, controllerNetworkControllerlinksys, wrt300nLinksys-WRT300N
home_router, home_gatewayHomeRouter-PT-ACtvTV-PT
voip, home_voipHome-VoIP-PTanalog_phoneAnalog-Phone-PT
patch_panel, copper_patchCopper Patch Panelfiber_patchFiber Patch Panel
wall_mount, copper_wallCopper Wall Mountfiber_wallFiber Wall Mount
cell_towerCell-Towerdwdm, dlc100DLC100
cloud_emptyCloud-PT-Emptyrouter_emptyRouter-PT-Empty
ap_aAccessPoint-PT-Aap_nAccessPoint-PT-N
ap_acAccessPoint-PT-AC3702i3702i
wireless_deviceWirelessEndDevice-PTwired_deviceWiredEndDevice-PT
embedded_serverEmbedded-Server-PTpower_distPower Distribution Device
central_officeCentral-Office-Server802, 803(direct wireless bridges)
The complete 101-entry mapping is defined in infrastructure/catalog/aliases.py.

Querying the Catalog with MCP Tools

Two tools let you inspect the catalog at runtime without leaving your LLM client:

pt_list_devices

Returns all 74 models with their port specs and categories. Useful when you want to browse what’s available or pick a model by port count.

pt_get_device_details

Returns the full port list, category, and display name for a single model. Accepts both the exact pt_type string and any alias (e.g. "router" resolves to the full 2911 spec).
The same data is also available as a read-only MCP resource at pt://catalog/devices — see MCP Resources for details.

Build docs developers (and LLMs) love