eda-agent

MCP server that lets an AI (or any MCP-compatible client) interact with a live Altium Designer session. It exposes 195+ tools covering schematic, PCB, library, and project operations over a persistent DelphiScript bridge — the AI reads the design you currently have open, asks questions about it, and can modify it in place while you watch.

⚠️ Experimental. Not all tools are extensively tested. Some can crash the Altium DelphiScript engine. See Known limitations before using on any design you haven't backed up.

Demo

Claude Code reviewing a buck converter through eda-agent. The feedback resistor divider on this schematic is intentionally wrong — Claude catches it among other recommendations.

Dashboard

A floating Altium-side window shows live status, request count, cumulative Altium-side time, auto-shutdown countdown, and a per-command log with durations. Hide pings filters the 30 s keep-alive traffic; Only >100ms isolates slow calls. The Detach button saves all dirty docs and exits the polling loop cleanly.

How it works

• Altium Designer stays open and in full control of your design
• A DelphiScript polling loop runs inside Altium's scripting engine
• eda-agent (Python, launched by your MCP client) sends commands via file-based IPC
• Altium executes, writes a response, and returns to polling
• You see the changes happen live in Altium

This is not a batch tool that opens a project, runs a script, and exits. It's a live connection for as long as you want it — conversational design review, guided refactoring, ad-hoc BOM queries, "what nets does this resistor connect to?" — all on the project you currently have open.

Features

• 195+ tools across application, project, library, schematic/general, and PCB categories
• Generic primitives (query_objects, modify_objects, create_object, delete_objects, run_process) that work on almost any schematic or PCB object type via late-binding — avoids per-type handler proliferation
• Bulk batch primitives — batch_modify, batch_create, batch_delete, pcb_place_tracks, pcb_move_components, place_wires, place_sch_components_from_library, lib_add_pins, get_connectivity_many, sch_attach_spice_primitives. Collapse N LLM turns + N IPC round-trips into one. Typical wall-time savings: 10–100× on multi-item edits
• Design review snapshot — design_review_snapshot bundles 8–12 review reads (project info, components, nets, rules, diff, messages, stats, unrouted, BOM) into a single call. One LLM turn instead of a dozen
• Datasheet-first discipline — every component-surfacing response (pcb_get_components, get_bom, get_component_info, find_component, lib_search, design_review_snapshot, sch_get_simulation_readiness) carries a _datasheet_guidance block with per-part vendor search queries. attach_to_altium / ping_altium carry a _system_reminder so every MCP client that connects sees the rule at session start. LLM-fabricated datasheet values are forbidden; WebFetch/WebSearch are called out by name
• Sch ↔ PCB netlist crossref — crossref_net(net_name) compares the schematic pin list against the PCB pad list for the same net. Catches ECO drift, stale post-fabrication routing, phantom nets from port/sheet-entry rename conflicts. in_sync flag + sch_only / pcb_only diff
• SPICE simulation workflow — sch_get_simulation_readiness audits every component and partitions into ready / needs-primitive / needs-file. sch_attach_spice_primitive(s) sets SpicePrefix + Value on passives. sch_attach_spice_model links a vendor .mdl / .ckt. sim_run dispatches the simulator. Built-in guardrail: never fabricate a SPICE model

... View full README on GitHub