Proteus MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PROTEUS_MCP_EXE | Yes | Path to the Proteus PDS.exe executable. | |
| PROTEUS_MCP_KEIL | No | Path to the Keil installation, used for compiling 8051 examples. Not required for library queries or semantic circuit editing. | |
| PROTEUS_MCP_LIBRARY | Yes | Path to the Proteus device library directory. | |
| PROTEUS_MCP_WORKSPACE | Yes | Workspace directory for Proteus MCP. | |
| PROTEUS_MCP_CALIBRATION | No | Path to the local calibration template used for exporting new native Proteus projects. Optional. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Check proteus_doctor. Model edits are not native Proteus edits; do not claim simulation verification from compilation.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| proteus_doctorA | Report capability-specific health. Installed is not verified working. |
| catalog_listB | List supported logical devices and pins; library_path explicitly selects ambiguous installed devices. NOT placement verification. |
| library_searchB | Search the actual installed Proteus .LIB device index without mouse or screenshots. Finding a device does not imply native placement support. |
| library_deviceB | Read real installed device pins, geometry, hidden supplies, properties and source library. Optional explicit unit A..Z resolves supported homogeneous multi-unit packaging to physical pin numbers. |
| project_createB | Create a NEW semantic circuit directory; never overwrite existing directories. |
| project_readC | Read circuit revision and source hash. |
| component_addB | Add a logical component; does NOT draw in Proteus. Use current expected_revision. |
| component_setC | Update logical properties or placement; native status becomes not_applied. |
| circuit_editA | Apply an atomic revision-checked batch: add, set (properties/position), remove, connect, disconnect, merge_nets. Any invalid edit rolls back the entire batch. Export native afterward. |
| connect_pinsC | Connect named pins in the model, e.g. U1.P1.0 to D1.K. Rejects implicit shorts across nets. |
| project_validateA | Check model pin existence, MCU supplies/reset and floating passive pins. NOT full ERC. |
| project_planB | Export deterministic plan.json. Status is planned, not applied to Proteus. |
| export_svgC | Export named-net connectivity preview.svg. This is NOT a Proteus screenshot or .pdsprj. |
| export_netlistB | Export portable semantic netlist.json, NOT an importable Proteus native file. |
| example_led_chaserC | Create a NEW 12MHz 12T 8051, P1 active-low 8-LED circuit and C51 main.c. |
| example_external_interruptA | Create a NEW C51 teaching circuit/source for external interrupts: two BUTTON inputs, 8 LEDs, multiplexed 4-digit CC display and transistor-driven buzzer. mode=level: idle chaser, held low-level input increments with alarm; mode=nesting: low-priority INT0 chaser can be preempted by high-priority INT1 increment. Diagnostic nets expose ISR activity/increment/wrap. initial_count defaults to 0000; other values support explicit boundary tests. Build/export/open/observe separately. Not physical driver or audio certification. |
| source_writeA | Write main.c; existing source requires matching expected_sha256 and is backed up. |
| firmware_buildB | Actually run installed C51, BL51 and OH51; preserve logs and verify Intel HEX. NOT simulation. |
| firmware_inspectB | Read Intel HEX and validate checksums, addresses, overlap and reset vector. |
| native_inspectB | Read .pdsprj ZIP contents and hashes. Does NOT claim electrical verification. |
| native_readB | Read calibrated native components, properties and stored pin references directly from .pdsprj. No UI. Not simulation verification. |
| native_previewC | Render an SVG from actual calibrated native component/pin/wire/junction geometry. This is a reconstructed vector preview, not a screenshot. New output only. |
| native_createA | Create a NEW experimental empty native .pdsprj within an existing semantic project. No UI input. Use project_open/save to verify the generated instance. |
| native_set_componentB | Modify calibrated native component values, clock_hz or program in a NEW output file, requiring source SHA-256. No UI; never overwrites output. |
| native_export_led_chaserB | Generate a native .pdsprj, C51 source and HEX from the exact example_led_chaser topology. Calibrated explicit wires and named nets. Each export still needs its own runtime verification. |
| native_exportC | Draw a NEW native schematic with calibrated symbols, rotation and mirroring. Default auto uses full continuous signal wires and sheet bounds, never silently falls back to labels. The LED example uses an authored parallel-channel plan. Explicit labels and wires modes remain opt-in and are also sheet-bounded. routing=schematic uses exact half-grid trees and audited unconnected crossings; sheet_size sets even grid width/height. Topology readback; never overwrites a project. |
| project_openA | Open a .pdsprj directly, return once the project window settles, record processes and crash evidence. With session, reuse the same project or stop/save/close that owned session before switching files. No input emulation. |
| runtime_statusB | Read running Proteus process, window and menu metadata. No screenshots or input emulation. |
| runtime_diagnosticsB | Collect Windows crash events, dump paths and process state for a tracked launch, saving diagnostics.json. |
| project_closeA | Request normal WM_CLOSE for a tracked Proteus session. Does not force termination or dismiss unsaved-change dialogs. |
| project_reopenA | Save, verify circuit preservation, close normally, then reopen the same tracked project. Stops if saving or normal close is unconfirmed. |
| native_statusB | Read commands, logs, modal dialog and simulation state via version-pinned Qt function bridge. Optional Frida; no input emulation. |
| live_readA | Read CURRENT owned ISIS sheet components, physical pin numbers/names, transforms and real wires. Returns revision token. No screenshots or input emulation. |
| live_editA | Edit the CURRENT owned ISIS sheet in the same PID/document using native functions. Stopped simulation and current live_read token required. Operations: add, transform, set, connect. Deletion is a separate batch: {op:delete,ref,delete_connected_wires:false} permits direct attached component wires only when true; {op:delete_wire,wire_address} removes one exact wire including a branch; {op:delete_junction,junction_address,connected_wire_addresses:[all exact incident addresses]} removes a DOT and explicitly listed incident wires, never a whole net. Non-target geometry/labels are compared; native selections/tags are rejected. NOT atomic; partial/unconfirmed may have applied. Save/reopen for disk validation. |
| live_historyA | Undo or redo exactly one recorded MCP live_edit batch in the same native document. Requires current live_read token, stopped simulation and matching semantic history. External edits, no-op or partial batches invalidate history. Does not emulate keyboard input. |
| native_commandsB | Discover native command IDs, owning modules, labels and enabled/checked states. Discovery is NOT verified execution. No arbitrary command execution is exposed. |
| native_checkA | Run a stopped-session native check. kind=erc requires a live_read token and a fresh electrical report. kind=drc requires a pcb_read token and refreshes the whole-design ARES physical clearance checker, reading real violations/ignored flags without a dialog. kind=preproduction runs all 23 native PPC checks, including connectivity CRC, on an owned workspace copy with a pcb_read token; restores original selections and closes only its own native PPC dialog. Cached/truncated/partial/disabled results, warnings, skips and ignored violations never count as clean. Current configured rules only, NOT fabrication certification or unrestricted full PCB DRC. Invocation status is separate from passed. |
| pcb_readA | Export and read the CURRENT owned ARES PCB: native pad indices, nets, layers, board outline, rules, copper paths and calibrated through-vias including native drill/style/span. Stopped simulation required. Returns revision token; pad indices are NOT schematic physical pin numbers. |
| pcb_routeA | Add verified real TOP/BOT same-layer copper in the owned ARES board, preserving old wires and calibrated vias. Token, existing net and two native pad ids required. Explicit points_nm or conservative 8-direction A*. All pad/copper/via/edge clearance checked. Integer nm must be 10 nm aligned. Not full DRC or push/shove. Unknown geometry fails closed; NOT atomic. Save/reopen verifies disk copper. |
| pcb_route_layersA | Route between real through-hole pads across TOP/BOT with full-diameter calibrated through-vias. Requires fresh pcb_read token and native via_style. Automatic layer-state A* or explicit waypoints of {layer,position_nm}; a layer change repeats the same position. Preserves all old wires/vias and verifies exact native copper, style, hole, span and multiplicity. Only two-copper-layer rectangular boards with known geometry. NOT push/shove, blind/buried vias, full DRC or atomic. Save/reopen for disk verification. |
| pcb_route_pushA | Bounded local push of ONE isolated MCP-created trace on TOP/BOT to clear an explicit new pad-to-pad path. mode=plan (default) does NOT change copper; mode=apply displaces an internal orthogonal segment, fixes both old pad endpoints, imports exact replacements and requires a fresh clean native clearance DRC. Supply current pcb_read token and explicit movable wire_ids from wire_inventory. No branches, via moves, cascades, arbitrary native/protected traces, native lock certification, or vendor interactive push engine. Non-atomic; an unconfirmed apply may have changed the board. Save/reopen for disk verification. |
| project_saveA | Queue native Save Project; back up and verify the scoped save. Confirm only the exact calibrated format-upgrade notice for workspace copies, never unknown dialogs. Schematic save compares disk circuit/cache; PCB save checks memory plus archive write and needs project_reopen for disk copper verification. No keyboard/mouse. |
| pcb_route_push_chainA | Plan/apply bounded multi-trace chain displacement on TOP/BOT. Up to eight explicitly allowed, current MCP-created isolated pad-to-pad traces may move internal orthogonal segments; fixed anchors and all other copper/vias are preserved. mode=plan is read-only, apply requires exact replacement and fresh native DRC. Not the vendor interactive engine; branch/via push and arbitrary locked traces remain unsupported. NOT atomic. Save/reopen for disk verification. |
| manufacturing_bomA | Export an audited UTF-8 CSV and JSON assembly BOM from a SAVED, DSN/CDB-consistent native project. Requires input SHA-256, counts each physical package once across units, reports unassigned packages separately, escapes CSV formulas, writes NEW workspace output only. Not unsaved-session data, Gerber/Excellon, verified PCB population or fabrication certification. |
| simulation_logB | Read actual Proteus simulation log rows directly from the native item model. No menu, screenshots or input emulation. |
| simulation_inputsA | Read calibrated BUTTON/LOGICSTATE inputs in an owned RUNNING ISIS simulation. Returns epoch/context/EID-bound token. Start with simulation_control; restart invalidates old tokens. No desktop input. |
| simulation_stimulateA | Deliver 1..32 calibrated native input events using a current simulation_inputs token. at_ms is a nondecreasing offset from the current native simulator time. Waits for actual time then dispatches at CURRENT time and records lateness. Delivery delays shift following events enough to preserve requested inter-event spacing, never compress a pulse or inject future events. Native clock is coarse, not hard realtime. BUTTON 0=release/1=press; LOGICSTATE 0=low/1=high. Runtime events only: persistent STATE/icon/disk is not edited. Non-atomic; partial/unconfirmed may have applied; no automatic restore. Dispatched does NOT prove electrical effect or ISR behavior. Saves complete sampled raw trace. |
| simulation_observeA | Sample DSIM native network vectors with VSMDEBUG native simulation-time brackets. Strength-aware decoding only for calibrated state codes; unknowns remain unknown. Bounded polling, NOT a complete event waveform or analog/audio measurement. Saves full raw trace, returns summary/evidence. Running owned session only. |
| simulation_decode_displayA | Decode a saved raw simulation_observe/stimulate JSON trace by actual segment/select net values. Supply source SHA-256, ordered A..G[,DP] segment_nets and left-to-right digit_nets. Requires exactly one selected digit and known stable states; reports composite frames, confirmations and rejected samples. This is sampled digital evidence, not optical output or complete transitions. |
| simulation_sampleB | Sample live native DSIM network STATE values and save evidence. Supply native network names, not semantic JSON net names. Raw states include strength bits. |
| native_applyB | Export the semantic circuit into a NEW native file with full signal wires and strict sheet bounds, never silent label fallback. The LED example uses authored parallel channels. Does not modify a live session. Use project_open on its returned path. |
| native_verifyC | Autonomously open, save, close, reopen, compare circuit/cache, run and sample, pause/resume/stop, close and collect crash evidence. Net order is checked for calibrated active-low cyclic output. Creates file backups and reports. |
| simulation_controlB | Execute run, pause or stop using version-pinned Qt functions for an owned runtime session, then check native command state. A semantic project alone is insufficient. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 53 tools
Several tools target nearly identical territory and only deep description-reading separates them: native_read vs native_inspect vs live_read vs project_read all 'read the native project', simulation_sample vs simulation_observe vs simulation_log all sample simulator data, and four pcb_route* variants plus native_export vs native_apply vs native_export_led_chaser vs example_led_chaser are near-siblings. The detailed descriptions do provide the distinctions, but with 53 tools an agent is likely to misselect on the first pass (e.g. component_add vs circuit_edit vs live_edit vs native_set_component).
There is a systematic noun_verb prefix scheme (project_*, native_*, pcb_*, simulation_*, library_*, component_*, firmware_*), which is readable and groups well. But it mixes conventions with verb_noun outliers like connect_pins, export_svg, export_netlist, source_write, live_history, and one-off names like proteus_doctor and example_external_interrupt.
53 tools is far beyond a comfortable agent-facing surface, even for a broad proteus-automation domain spanning schematic, native file, PCB, simulation and manufacturing. Distinct capabilities here (e.g. four routing tools, three read tools, three status/diagnostic tools) could plausibly be consolidated into a single operation-dispatched tool.
Coverage is unusually deep: create/read/edit/validate/save/close/reopen for projects, add/set/connect/delete for circuits, plus exports, firmware build/inspect, simulation control/stimulus/observe, PCB read/route, and BOM. Minor gaps exist (no project delete/cleanup, explicitly no full ERC or Gerber/fabrication outputs), but these are declared boundaries rather than dead ends.