NetForge MCP
Integrates with Cisco Packet Tracer and Cisco IOS to open, inspect, build, configure, verify, grade, diagnose, and repair Cisco networking labs non-destructively, including topology creation, device configuration, IOS CLI execution, live ping verification, and .pkt/.pka workflow support.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
AgenticNet
Agentic Networking Platform — "Networks. Understood. Engineered. Automated."
An open-source agentic networking platform (current development focus: Cisco Packet Tracer 8.2.2+). AgenticNet connects AI assistants (Claude Desktop, Cursor, VS Code Copilot, Google Antigravity, and any MCP client) directly to Cisco Packet Tracer 8.2.2+ and a cross-platform network engineering engine so your AI can plan subnets, build topologies, push verified Cisco IOS configs, test live pings, grade .pka activities, and diagnose broken labs without overwriting your original .pkt/.pka files.
Independent Community Project: AgenticNet is an open-source MIT project and is not affiliated with, sponsored by, or endorsed by Cisco Systems, Inc. Cisco Packet Tracer is a trademark of Cisco Systems, Inc. This repository contains no Cisco binaries or copyrighted lab files.
What You Can Ask Your AI To Do
"Open
my_lab.pka, show me what is already configured vs. what is missing, fix the remaining tasks, verify connectivity, and save a working copy.""Design and build a 3-VLAN campus topology in live Packet Tracer using OSPF and DHCP (
10.10.0.0/22), configure all switches/routers/PCs, and verify end-to-end pings.""PC1 cannot reach the web server in
broken.pkt— inspect interfaces, VLAN trunks, routing tables, and ARP, diagnose the root cause, repair it, and show me a diff of what changed.""Plan a VLSM subnet allocation for 4 departments (offline, no Packet Tracer needed), validate the IOS configs, and export a Mermaid topology diagram."
Related MCP server: Packet Tracer MCP Server
Why AgenticNet?
One-Command Live Lab Workflow (
lab_start/start_lab): Give your AI a.pkt/.pkafile, PDF/Markdown lab brief, or plain-English description. AgenticNet drafts a concise plan for your confirmation first, builds and configures the lab live in Packet Tracer, narrates progress, and verifies every step.Native Packet Tracer Script Bridge: Uses an authenticated
127.0.0.1HTTP bridge inside Packet Tracer (com.netforge.bridge, shipped asnetforge_bridge.pts) for reliableadd_device,create_link,configure_host,batch_ops,HWIC-2Tmodule attachment,7960IP phone powering, IOS CLI execution, and.pkt/.pkaopen/save (desktop mouse/keyboard GUI automation stays fallback-only).Non-Destructive Copy-on-Write + Diffs: Original
.pkt/.pkafiles stay untouched by default (*_agenticnet.pkt), with before/after snapshots (lab_snapshot) and readable change summaries (lab_diff).Evidence-First Verification (
plannedvs.executedvs.verified): Never claims success without proof —verify_labandlab_statusinspect realshow ip interface brief,show ip route,show vlan brief,show telephony-service, and livepingoutputs.Clean Default Profile + Power-User Mode: Exposes 25 focused tools in the default
solve_labprofile (reducing prompt clutter for agents) or all 82 engineering, IPAM, IOS, simulation, and GUI tools viaAGENTICNET_TOOL_PROFILE=advanced.
Platform Support: Planning, VLSM IPAM, IOS generation/validation, SQLite persistence, and all unit/protocol tests run natively on Windows, Linux, and macOS. Live Cisco Packet Tracer automation runs on Windows 10/11 + Cisco Packet Tracer 8.2.2+ on an unlocked interactive desktop session.
Quick Start (1-Command Setup)
Requires Python 3.11+.
Windows (PowerShell)
git clone https://github.com/gg1i/agenticnet.git
cd agenticnet
powershell -ExecutionPolicy Bypass -File scripts\install.ps1 -WithGui -Client antigravitySupported -Client values: antigravity, claude, cursor, vscode, or none (default, prints the exact JSON snippet with absolute .venv Python path). Add -ToolProfile advanced to enable all 82 tools (including gui_* fallback).
macOS / Linux (Offline Planning, IPAM & IOS Core)
git clone https://github.com/gg1i/agenticnet.git
cd agenticnet
bash scripts/install.sh --client claudeManual Setup (Optional)
pip install . # or pip install ".[gui]" on Windows for GUI fallback
agenticnet setup # installs netforge_bridge.pts + prints ready-to-paste MCP config
agenticnet doctor # checks Python, PT, and script bridge statusOne-Time Packet Tracer Bridge Registration (Windows, 8.2.2+)
Open Cisco Packet Tracer -> Extensions -> Scripting -> Configure PT Script Modules...
Click Add and select
%LOCALAPPDATA%\netforge\netforge_bridge.pts(mirrored automatically bysetupso the compiledcom.netforge.bridgemodule discoversbridge_session.jsonseamlessly).Check On Startup, click Save, accept the one-time script privilege prompt, and restart Packet Tracer.
Physical-Tab Fallback Note: Standard topology, cabling, IOS CLI, host IP,
7960power via script bridge,.pkagrading, and verification require no mouse input. Only Physical-tab mouse-drag fallback actions (gui_*inadvancedmode, plusgui_attach_ip_phone_power— experimental: not yet validated by the 5-attempt live protocol) require an unlocked interactive Windows desktop session.
Running Directly Over HTTP/Stdio (Optional)
See examples/claude_desktop_config.json and examples/mcp_config.json, or launch the server directly:
# Default stdio transport
agenticnet serve --transport stdio
# Local Streamable HTTP transport
agenticnet serve --transport streamable-http --host 127.0.0.1 --port 8765Features & Architecture
AgenticNet exposes 82 MCP tools (25 in default solve_lab profile), 7 resources, 6 prompts, and verified device profiles across 17 models (2911, 1941, 2811, 4321, Router-PT, 2960-24TT, Switch-PT, 3560-24PS, 3650-24PS, PC-PT, Laptop-PT, Server-PT, Printer-PT, 7960 IP Phone, Home-VoIP-PT, WRT300N, AccessPoint-PT):
agenticnet/
├── core/ # State separation (planned/executed/verified), OperationResult, settings
├── security/ # 5-tier permission enforcement, confirmation gates, secret redaction
├── devices/ # Verified Packet Tracer device catalog & interface normalization (17 models)
├── topology/ # NetworkX MultiGraph topology engine, cable rules, layout, Mermaid/ASCII export
├── ipam/ # IPv4/IPv6 CIDR math, VLSM allocator, conflict detection, addressing tables
├── ios/ # Structured IOS generators, capability pre-validators, CLI parser, unified diff
├── storage/ # Versioned SQLite WAL repository, snapshots, backups, JSON/YAML import & export
├── adapters/ # PT binary discovery, BackendRouter, 127.0.0.1 HTTP Script Bridge, .pts assets
├── gui/ # Optional Windows Win32/ctypes GUI fallback backend & safety failsafe
├── console/ # Device console state-machine, prompt handling, paging cleanup, paced CLI queue
├── simulation/ # Simulation/realtime controls, PDU specs, show/ping/ephone CLI parsers
├── diagnostics/ # Root-cause rules, ranked repair proposals, LabRunner, LabVerifier, ActivityGrader
└── mcp/ # Official Python MCP SDK server, 82 tools (25 default), 7 resources, 6 prompts, manifest
netforge/ # Legacy Python/CLI compatibility shim redirecting cleanly to agenticnet
promo/ # Standalone 30s interactive GSAP promo (`index.html`, opens directly via file://)
promo-pro/ # 3D overlapping-null Canvas source & rendered 1080p MP4 (`render/agenticnet-pro-promo.mp4`)
docs/media/ # Animated WebP preview (`agenticnet-promo.webp`) embedded aboveEnvironment Variables & Compatibility
All AGENTICNET_* variables fall back to legacy NETFORGE_* names so existing configurations continue working seamlessly. Legacy CLI commands (netforge, netforge-mcp) and Python imports (import netforge) remain supported.
Variable | Default | Description |
|
|
|
|
| One of |
|
| Require explicit |
|
| Directory storing SQLite DB and backups (mirrors |
|
| SQLite database filename |
|
| Logging level ( |
|
| Transport ( |
| (auto-detect) | Explicit path to |
Documentation
Engineering Skill Pack (
skills/*/SKILL.mdspecialist modules)
Live Verification & Benchmark Results
Only real live Cisco Packet Tracer (8.2.2) runs (mode: "live_pt") are reported below; offline mocked dry-runs ("mock": true / mode: "offline_mock") are synthetic harness checks only and are never reported as benchmark scores (see Benchmark Protocol).
Lab Suite | Mode | Score | Notes |
|
| 8/8 (100%) | Multi-router static routing, |
|
| 5/5 (100%) | 802.1Q trunking, router-on-a-stick, DHCP pools, PC lease & ping |
|
| 5/5 (100%) | Cisco CME ( |
Testing & Development
All unit and MCP protocol tests run completely offline with no Packet Tracer installation required:
pip install -e .[dev]
pytest
ruff check agenticnet netforge tests scriptsSee Contributing and Security Policy for guidelines.
Acknowledgements
AgenticNet's clean-room companion .pts Script Module architecture acknowledges prior open-source Packet Tracer MCP projects:
Mats2208/MCP-Packet-Tracer(MIT) — Pioneered the companion.ptsScript Module +127.0.0.1HTTP bridge pattern.kiskander/pt-mcp-server(BSD-2-Clause) — Prior-art reference for broad Packet Tracer IPC coverage.
License
Released under the MIT License.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
AI network lab: build and validate real multi-vendor router and switch labs from a prompt.
AI helper for choosing and speccing network & security products from Cisco, Arista, Juniper and more
IP intelligence, network diagnostics, and AI service availability tools for AI agents.
Protocol-native energy infrastructure orchestration for AI data centers. Provides 46 MCP tools across 8 grid protocols (IEC-61850, DNP3, Modbus, OCPP, OpenADR, IEEE 2030.5, IEC 60870-5-104, ICCP) with 5 core API primitives: connect, dispatch, settle, comply, and intel. Enables AI agents to programmatically interact with substations, grid interfaces, and energy assets for real-time workload-grid coordination.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to control Cisco Packet Tracer in real time, allowing natural language-driven creation and configuration of network topologies.6MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI models to generate, validate, and deploy network topologies directly into Cisco Packet Tracer from natural-language prompts.-
- AlicenseNot gradedqualityCmaintenanceEnables LLMs to plan, validate, generate, and deploy Cisco Packet Tracer network topologies from natural-language prompts, including routing, switching, DHCP, VLANs, security, IPv6, wireless, live deployment, verification, and .pkt project management.3MIT
- AlicenseAqualityCmaintenanceEnables AI assistants to build and configure Cisco Packet Tracer topologies, run device and connectivity commands, and inspect simulation-mode packet explanations through natural language.451BSD 2-Clause "Simplified"