22 tools. 5 resources.
One complete pipeline.

Every tool exposes a real capability verified against Cisco Packet Tracer 8.x. From catalog browsing to live deployment, the server covers the full lifecycle.

Organized by workflow stage.

Catalog & Discovery

3 tools
pt_list_devices List all supported device models with ports and specs
pt_list_templates Browse available topology templates
pt_get_device_details Get detailed info about a specific device model

Planning & Validation

5 tools
pt_estimate_plan Dry-run estimation before building
pt_plan_topology Generate a full topology plan from parameters
pt_validate_plan Validate a plan against PT constraints
pt_fix_plan Auto-fix common errors in a plan
pt_explain_plan Get natural language explanation of a plan

Generation

3 tools
pt_generate_script Generate PTBuilder JavaScript code
pt_generate_configs Generate IOS CLI configs per device
pt_full_build Complete pipeline: plan → validate → generate

Deployment

3 tools
pt_deploy Deploy via clipboard for manual paste
pt_live_deploy Real-time deploy via HTTP bridge
pt_bridge_status Check bridge connection status

Topology Interaction

6 tools
pt_query_topology Query the current topology in PT
pt_delete_device Remove a device from the topology
pt_rename_device Rename an existing device
pt_move_device Move a device on the canvas
pt_delete_link Delete a specific link
pt_send_raw Send raw JavaScript to PT

Export & Projects

3 tools
pt_export Export all artifacts to files
pt_list_projects List saved projects
pt_load_project Load a previously saved project

Static data the agent can query anytime.

pt://catalog/devices

Complete device catalog with models, types, and verified port definitions

pt://catalog/cables

Cable types and rules for correct cabling between device categories

pt://catalog/aliases

Model aliases to simplify device references

pt://catalog/templates

Topology templates with predefined configurations

pt://capabilities

Full server capabilities manifest

Clean layered design.
Every boundary is explicit.

01

Adapters

adapters/mcp/

MCP protocol layer — tool and resource registrations that map MCP calls to use cases.

02

Application

application/

Use cases (plan, validate, generate, export, deploy) with DTOs for clean request/response boundaries.

03

Domain

domain/

Core business logic — orchestrator, IP planner, validator, auto-fixer, explainer, estimator, and validation rules.

04

Infrastructure

infrastructure/

External concerns — device catalog, PTBuilder/CLI generators, HTTP bridge, live executor, and project persistence.

05

Shared

shared/

Enums, constants, and utility functions used across all layers.

Proven tools, minimal dependencies.

Python 3.11+ Runtime
Pydantic 2.0+ Data validation & models
FastMCP MCP server framework
Streamable HTTP Transport protocol
ThreadingHTTPServer Live bridge server
Pytest Test framework (34 tests)

Want to explore the code?

Every tool, resource, and architecture layer is in the open-source repo.

View on GitHub