MCP Tools Reference

This page details all available Model Context Protocol (MCP) tools exposed by easyeda-mcp-pro. These tools are profile-gated. Set the TOOL_PROFILE environment variable to enable them.

Summary of Tools

Tool Name	Profile	Risk	Description
`easyeda_api_call`	`full`	`high`	Controlled call to a documented EasyEDA class method by path, for example SCH_PrimitiveWire.getAll. This is not raw JavaScript execution.
`easyeda_api_inventory`	`core`	`low`	Inspect the live EasyEDA extension runtime and list available documented API classes, runtime paths, and methods.
`easyeda_board_dimensions`	`core`	`low`	Get the PCB board outline dimensions, shape, and mounting hole information.
`easyeda_board_features`	`core`	`low`	Get counts of board features including vias, tracks, copper zones, and pads.
`easyeda_board_layers`	`core`	`low`	List all layers in the PCB design including signal, power, plane, and mechanical layers.
`easyeda_board_stackup`	`core`	`low`	Get the PCB layer stackup including thickness, material, and dielectric constants.
`easyeda_bom_export`	`core`	`low`	Export the bill of materials to a file on disk in the specified format.
`easyeda_bom_generate`	`core`	`low`	Generate a bill of materials for the project with grouping and formatting options.
`easyeda_bom_quality_report`	`core`	`medium`	Generate a BOM quality report that identifies unavailable, single-source, missing-MPN, missing-footprint, and low-stock items across configured suppliers.
`easyeda_bom_sourcing`	`core`	`medium`	Retrieve pricing and availability information for all parts in the project BOM from specified suppliers.
`easyeda_bom_validate`	`core`	`medium`	Validate the project BOM against LCSC inventory to identify missing, obsolete, or alternate parts.
`easyeda_bridge_probe_methods`	`dev`	`medium`	Query the EasyEDA Pro bridge for available API methods. Requires bridge connection. (dev/pro only)
`easyeda_bridge_status`	`core`	`low`	Check EasyEDA Pro bridge connection status, version, and capabilities.
`easyeda_canvas_capture`	`core`	`low`	Capture the currently visible EasyEDA schematic/PCB canvas as a PNG image, so the caller can visually verify the result of a draw/place/route action. Captures the given tab (or last-focused); use easyeda_canvas_capture_region first to frame a specific area. Image is delivered once, as its own content block.
`easyeda_canvas_capture_region`	`core`	`low`	Zoom the EasyEDA canvas to a rectangular region (document/canvas coordinates) and capture it as a PNG, so the caller can visually verify a specific area. This moves the user's visible viewport — EasyEDA Pro has no offscreen rendering API. The image is delivered once, as its own content block.
`easyeda_canvas_locate`	`core`	`low`	Zoom the EasyEDA canvas to a coordinate/scale (document/canvas coordinates), returning the resulting viewport rectangle. Useful to frame a location before calling easyeda_canvas_capture, or standalone to navigate the user's view to a point of interest.
`easyeda_catalog_list`	`pro`	`low`	List devices cached by easyeda_catalog_verify_device, with their validation status and provenance. Optionally filter by status (resolved/partial/unresolved). This is a local cache only — never redistributed.
`easyeda_catalog_verify_device`	`pro`	`medium`	Resolve an LCSC part number into a catalog device entry (keyless LCSC metadata plus an EasyEDA symbol/footprint reference, if already known locally), validate it, and write it to the local device cache (confirmWrite required). Does NOT verify pin/pad geometry — see docs/catalog-ingestion.md.
`easyeda_component_probe`	`dev`	`low`	Inspect live schematic component objects, including available methods and state getter values, to validate EasyEDA runtime mappings.
`easyeda_design_rules_lookup`	`core`	`low`	Look up generic engineering reference guidance: IPC-2221 trace-width/current-capacity, clearance bands, protocol routing data (USB/RS-485/I2C/SPI/UART/Ethernet), decoupling recipes and bulk capacitance sizing, and a static DFM checklist. Every result cites a source and caveat: these are estimates, not certified values.
`easyeda_drc_run`	`core`	`medium`	Run the native design rule check (DRC): same as clicking "Check DRC" in EasyEDA Pro, so the bottom DRC panel opens/refreshes in the user's window as a visible side effect. Returns coarse per-severity counts only — which specific wire/net/component is affected is shown only in EasyEDA Pro's own DRC panel.
`easyeda_erc_run`	`core`	`medium`	Run native ERC and supplement its coarse counts with inferred_floating_pins. Only a strict native noConnected=true readback suppresses a pin; unavailable or malformed state remains visible. Native counts remain authoritative for other categories.
`easyeda_export_gerbers`	`core`	`medium`	Export PCB design to Gerber files for PCB fabrication.
`easyeda_export_netlist`	`pro`	`low`	Export the schematic netlist in a specified EDA tool format (PADS, Allegro, or Altium).
`easyeda_export_pdf`	`pro`	`low`	Export the schematic and/or board layout to PDF.
`easyeda_export_pick_place`	`pro`	`low`	Export pick-and-place (centroid) file for PCB assembly. Contains component reference, position, rotation, and layer.
`easyeda_get_capabilities`	`core`	`low`	Return server capabilities, including available profiles, enabled feature flags, and supported operations.
`easyeda_get_feature_flags`	`core`	`low`	Return current feature flag values.
`easyeda_get_server_config`	`core`	`low`	Return safe (redacted) server configuration. Secrets are never exposed.
`easyeda_get_tool_profiles`	`core`	`low`	List available tool profiles and their descriptions.
`easyeda_health_check`	`core`	`low`	Return server health status in one call: runtime version, active profile, bridge state, EasyEDA version, keyless sourcing state, and starter catalog size. Intended as the single actionable status check after first connecting the bridge extension.
`easyeda_jlcpcb_quote_workflow`	`pro`	`medium`	Prepare a non-binding JLCPCB quote workflow snapshot with explicit human-review gates and audit evidence. This tool never places orders or performs paid operations.
`easyeda_live_smoke_report`	`dev`	`low`	Run a read-only live smoke report against the connected EasyEDA bridge and return status, API inventory, components, wires, and schematic nets in one response.
`easyeda_live_write_regression`	`dev`	`medium`	Exercise real schematic (and optionally PCB) write paths against the bridge — place, connect, wire, delete — reporting pass/fail per step, then clean up its own scratch primitives. Needs a test device from schematic_search_device and the matching tab focused.
`easyeda_observability_report`	`core`	`low`	Return latency budgets, runtime metrics, cache/vendor timing snapshot, and storage retention policy for performance diagnostics.
`easyeda_pcb_add_silkscreen_line`	`full`	`medium`	Draw a non-electrical line on the PCB (e.g. Top/Bottom Silkscreen) for section dividers or board art — reuses the same PCB_PrimitiveLine primitive as add_track but with an empty net name, so it never appears in the netlist or ratsnest.
`easyeda_pcb_add_text`	`full`	`medium`	Place a text primitive on a PCB layer (typically Top/Bottom Silkscreen) — reference labels, section titles, assembly notes. Signature recovered from PCB_PrimitiveString: fontFamily must be a name the runtime's font list actually contains — "NotoSansMonoCJKsc-Regular" (the default) is live-verified to work.
`easyeda_pcb_add_track`	`full`	`high`	Draw a copper track/trace on the PCB board. A multi-point path is written as one line segment per consecutive point pair (all sharing netName, so they form one electrical track — same coordinate/name merge model as schematic wires).
`easyeda_pcb_add_via`	`full`	`high`	Place a via to connect different copper layers on the PCB board. outerDiameter/holeSize are passed through to the native API unconverted (same native unit as x/y) — their real-world scale was not independently verified against a known physical dimension, so confirm the resulting via size visually before trusting it.
`easyeda_pcb_add_zone`	`full`	`high`	Create a copper pour zone on a layer with clearance settings. CAUTION: the native create() call needs 9 args but this tool sends only 4 (points, layer, netName, clearance) — live-confirmed mismatch, not yet resolved. Verify visually before trusting it.
`easyeda_pcb_autoroute`	`pro`	`high`	Drive EasyEDA Pro's native autorouter (PCB_Document.autoRouting, a @beta API) after a pre-flight constraint check, then run DRC and a constraint report before reporting success. Never reports success without that evidence attached (confirmWrite required).
`easyeda_pcb_components`	`core`	`low`	List components placed on the active PCB layout: primitiveId, designator, footprint identity, position/rotation/layer. Requires a focused PCB tab in EasyEDA Pro — returns an empty list (not an error) if none is active.
`easyeda_pcb_constraint_check`	`core`	`low`	Run PCB constraint validation against the board design. Checks board outline, layer stackup, net classes, clearance rules, keepout areas, placement zones, mounting holes, fiducials, and manufacturing constraints.
`easyeda_pcb_constraint_report`	`core`	`low`	Generate a human-readable report explaining which PCB constraints were applied and which require manual review.
`easyeda_pcb_delete_component`	`full`	`high`	Delete components, tracks, vias, or other PCB primitives by ID. Checks each id against every deletable PCB class instead of assuming component, since PCB_PrimitiveComponent.delete() reports success for ids it does not own without deleting them.
`easyeda_pcb_export_route_context`	`pro`	`low`	Export the board as a Specctra DSN file (PCB_ManufactureData.getDsnFile) — an open, vendor-neutral format supported by external autorouters such as FreeRouting. Re-import the routed result through EasyEDA Pro's own SES/DSN import, not through this server.
`easyeda_pcb_floorplan`	`full`	`high`	Translate CircuitIR physical constraints (keepouts, top/bottom side, connector-edge, thermal spacing) into a component group placement plan, then optionally apply it. CircuitIR devices carry no physical dimensions, so widths/heights must be supplied per device (confirmWrite required).
`easyeda_pcb_modify_component`	`full`	`high`	Modify component properties in the PCB layout.
`easyeda_pcb_place_component`	`full`	`high`	Direct PCB component creation is unavailable because the verified EasyEDA runtime does not complete PCB_PrimitiveComponent.create(). This tool fails closed. Place the part in the schematic, sync to PCB, confirm the native dialog, then reposition it with easyeda_pcb_modify_component.
`easyeda_pcb_place_component_group`	`full`	`high`	Create a high-level, constraint-checked placement plan for a group of components and optionally apply it after explicit confirmation.
`easyeda_pcb_production_review`	`core`	`medium`	Run fabrication, assembly, and testability production review rules for PCB handoff. Reports severity-ranked DFM/DFA/DFT findings with actionable remediation before Gerber export or manufacturing submission.
`easyeda_pcb_route_path_plan`	`full`	`high`	Create a high-level, constraint-checked route path plan for one net and optionally apply it after explicit confirmation.
`easyeda_pcb_tracks`	`core`	`low`	List copper track segments on the active PCB layout: primitiveId, net, layer, start/end coordinates, width. A multi-point track drawn by add_track appears as several consecutive segments sharing one net. Returns an empty list (not an error) if no PCB tab is focused.
`easyeda_pcb_vias`	`core`	`low`	List vias on the active PCB layout: primitiveId, net, position, hole/outer diameter (native unit, same scale as x/y — not independently verified against a known physical dimension). Requires a focused PCB tab — returns an empty list (not an error) if none is active.
`easyeda_post_write_qa`	`core`	`medium`	Run and classify post-write schematic QA after generated edits. Combines native DRC/ERC results with policy-aware classification so duplicate net names, free networks, and unconnected pins are reported as pass/fail/inconclusive instead of raw warning counts.
`easyeda_power_tree_analyze`	`core`	`medium`	Analyze supply sources, regulators, loads, protection, bulk capacitance, current budget, dropout, and regulator thermal risk. Returns machine-readable issues and a human-readable summary.
`easyeda_production_qa_artifacts`	`pro`	`low`	Generate testpoint checklist, assembly notes, bring-up plan, production QA checklist, and machine-readable QA manifest for board handoff.
`easyeda_project_begin_transaction`	`core`	`low`	Open an in-memory, document-scoped transaction for snapshot-backed schematic writes. Only one active transaction is allowed per document. Beginning a transaction does not modify EasyEDA.
`easyeda_project_commit_transaction`	`core`	`medium`	Finalize a transaction after its writes and validation gates succeed. Commit removes rollback eligibility and releases the document transaction lock.
`easyeda_project_get_transaction_status`	`core`	`low`	Read transaction state, validation results, operation hashes, and rollback status without exposing captured primitive snapshots.
`easyeda_project_rollback_transaction`	`core`	`medium`	Controlled write: restore applied schematic primitive snapshots in reverse order, verify each restored hash, and report partial rollback explicitly instead of hiding inconsistencies.
`easyeda_project_save`	`core`	`medium`	Explicitly save the current EasyEDA Pro project. This ensures all netlist changes, net flags, pin connections, and other mutations are persisted to the project file. Save is never implicit — the caller must explicitly request it. Requires confirmWrite.
`easyeda_project_validate_transaction`	`core`	`low`	Run transaction consistency gates before commit: bridge availability, pending/failed operation checks, optional expected operation count, and optional requirement for at least one applied write.
`easyeda_rule_check_summary`	`core`	`low`	Get a summary of all design and electrical rule check results for the project.
`easyeda_run_self_test`	`core`	`low`	Run internal self-test to verify server integrity, config, and bridge connectivity.
`easyeda_schematic_add_circle`	`core`	`medium`	Draw a circle on the schematic sheet — decorative marker or custom symbol element. Cosmetic only, no electrical meaning. fillColor "none" leaves it unfilled.
`easyeda_schematic_add_polygon`	`core`	`medium`	Draw a closed polygon on the schematic sheet from 3+ vertices — custom decorative shapes, callout arrows, or block diagram elements. Cosmetic only, no electrical meaning.
`easyeda_schematic_add_rectangle`	`core`	`medium`	Draw a rectangle on the schematic sheet — section dividers/grouping boxes for organizing a busy schematic into labeled functional blocks (pair with add_text for the title). Cosmetic only. x/y is the top-left corner; fillColor "none" leaves it unfilled.
`easyeda_schematic_add_text`	`core`	`medium`	Place free-standing text on the schematic sheet (section headers, notes, block labels) — cosmetic/organizational, not a net label. color must be a hex string and fontName a real font (e.g. "Arial") — untyped placeholders create nothing despite returning ok.
`easyeda_schematic_add_wire`	`core`	`medium`	Add a wire connecting schematic coordinates/pins — real native connectivity. Same `netName` connects pins globally: separate stubs sharing one name merge into one net (no label needed). NET_COLLISION guards touched points against a foreign net's wire, pin, or flag/port — not mid-segment crossings.
`easyeda_schematic_audit_imported_design`	`core`	`low`	Read the live schematic without modifying it, build a canonical model, and report imported net aliases, duplicate or missing references, unresolved metadata expressions, missing values/footprints, and ambiguous BOM classification. Includes a preview only; it never renames nets or changes components.
`easyeda_schematic_batch_write`	`core`	`high`	Apply up to 200 validated schematic create, modify, pin no-connect, and delete operations in one snapshot-backed transaction. Any failure rolls the whole transaction back. Delete is limited to safely recreatable drawing primitives.
`easyeda_schematic_capture_full_page`	`pro`	`low`	Read the active schematic sheet geometry, clear selection overlays, frame the complete sheet including its border and title block, and return a deterministic PNG plus the sheet-to-image coordinate transform. Refuses guessed geometry unless explicitly allowed.
`easyeda_schematic_check_collisions`	`core`	`low`	Scan every component's real pin coordinates and report any (x,y) shared by two or more components — a silent-short risk the native NET_COLLISION guard misses for never-wired pins. Run after manual placement outside easyeda_workflow_* tools (which reconcile this automatically).
`easyeda_schematic_check_placement`	`pro`	`low`	Validate a candidate placement (rendered bounds, clearances, conflicts, deterministic alternatives) or -- when x/y are omitted -- search for a safe region of the given size, against real title-block/page-border/existing-primitive constraints. Read-only, no writes.
`easyeda_schematic_component_pins`	`core`	`low`	Get exact pin primitive IDs, numbers, names, coordinates, native no-connect state, and pinType for a schematic component by its primitive ID. pinType is EasyEDA's own symbol-library field and is unreliably authored (often "Undefined" even on real ICs) — treat it as a weak hint, not ground truth.
`easyeda_schematic_components`	`core`	`low`	List schematic components: primitiveId, reference, value, footprint, x/y/rotation, and device identity for cloning — deviceUuid+deviceLibraryUuid (a place_component deviceItem in this project), deviceName, symbolName, lcsc, manufacturerId.
`easyeda_schematic_connect_pin_to_net`	`core`	`medium`	Create real EasyEDA connectivity for a pin: draws a short wire stub from its exact coordinate, tagged with netName. Same-netName wires merge globally, so this joins the pin to everything else on that net — visible to ERC, ratsnest, and autorouting.
`easyeda_schematic_connect_pins_by_net`	`core`	`medium`	Bulk variant of connect_pin_to_net: draws a real wire stub from each pin, tagged with netName, so all listed pins (and anything else already on that net) merge into one net. Visible to ERC, ratsnest, and autorouting. A pin that fails (e.g. collision) is reported in failures rather than aborting the batch.
`easyeda_schematic_connectivity_fingerprint`	`pro`	`low`	Compute a deterministic connectivity fingerprint (pin/net membership, wire endpoints, labels/ports, no-connects) from the live schematic. Pass the hash as beforeFingerprint/afterFingerprint to easyeda_schematic_layout_qa to prove a cosmetic move left connectivity unchanged.
`easyeda_schematic_create_net_flag`	`core`	`medium`	Create a named net flag/label. With `identification` (Power/Ground/AnalogGround/ProtectGround) it places a power-flag symbol binding to a coincident pin (use for VCC/GND). Without it, a generic net label — cosmetic only; connect pins with add_wire stubs sharing one netName.
`easyeda_schematic_create_net_port`	`core`	`medium`	Place a hierarchical net port (off-sheet connector) on the schematic. Net ports create named connections that span multiple schematic sheets, appearing as real SCH_Net entries in the netlist.
`easyeda_schematic_delete_primitive`	`core`	`medium`	Delete components, wires, or other drawing objects from the schematic by their primitive UUIDs.
`easyeda_schematic_layout_autofix`	`pro`	`low`	Detect title-block overlap, page-boundary overflow, and component-overlap violations from real rendered bounds, and propose cosmetic-only moves that resolve them. Read-only preview only (requiresConfirmWrite=true, no writes) -- confirmWrite apply with connectivity-fingerprint rollback is tracked separately (#273).
`easyeda_schematic_layout_autofix_apply`	`pro`	`high`	Apply the layout-autofix cosmetic moves in a snapshot-backed transaction, re-verifying a connectivity fingerprint after every write batch. Any unintended electrical change or write failure rolls the transaction back and is reported, never thrown. dryRun:true previews only.
`easyeda_schematic_layout_qa`	`pro`	`low`	Run a normalized post-write QA pass combining runtime DRC/ERC, expected component/pin topology, rendered primitive bounds, title-block and page constraints, wiring/grouping checks, and connectivity fingerprints, with optional full-page visual evidence. Critical geometry or connectivity findings always block commit.
`easyeda_schematic_modify_primitive`	`core`	`medium`	Safely modify a schematic primitive while preserving omitted fields. With transactionId and projectId, capture before/after snapshots and automatically restore the prior state if the write or post-write read fails. Component moves keep connected wires attached.
`easyeda_schematic_net_detail`	`core`	`low`	Get full details for a specific net in the schematic including all connected pins and components.
`easyeda_schematic_nets`	`core`	`low`	List all nets in the schematic with their node connections.
`easyeda_schematic_place_component`	`core`	`medium`	Place a library component/device on the active schematic sheet. Auto-assigns the next free designator ("R?" → "R1") — check the returned value, duplicate "R?" merge into one node. On a timeout error, auto-reconciles against the sheet before reporting failure (see reconciled/unconfirmed) — do not blindly retry.
`easyeda_schematic_plan_layout`	`pro`	`low`	Deterministically plan functional-block placement (reserved rectangles, support space, grid-aligned coordinates, occupancy map, A3 fallback, score) from real sheet/primitive geometry -- no writes. Caller supplies roles/blockId/parentId; other primitives read as occupied regions, never overwritten.
`easyeda_schematic_plan_safe_region`	`core`	`low`	Compute a safe schematic drawing region before placing components. Uses live sheet info when available, assumes EasyEDA bottom-left coordinates, reserves the default lower-right title-block keep-out, and returns an anchor/bounds plan that avoids title-block overlap.
`easyeda_schematic_preview_imported_normalization`	`core`	`low`	Read the live schematic and produce a deterministic, read-only normalization plan with a stable plan ID, model hash, proposed net-name/reference/metadata operations, validation gates, warnings, and blockers. This tool never writes to EasyEDA.
`easyeda_schematic_primitive_bounds`	`pro`	`low`	Read real rendered (sheet-space, rotation-aware) component bounding boxes from the live bridge, batched in one call. Origin is not a collision bound -- use combinedBounds for overlap/page/title-block checks. Reference/value text is not independently addressable here and reports not_available.
`easyeda_schematic_search_device`	`core`	`low`	Search for schematic symbols/devices in the EasyEDA library by keywords. Full results carry the library's complete metadata object per device; pass minimal:true to get back only uuid/libraryUuid/name/pin_count/symbol_type when that is all you need.
`easyeda_schematic_set_pin_no_connect`	`core`	`medium`	Set or clear EasyEDA Pro's native No Connect marker on one exact component pin. This changes the component pin noConnected state; it does not create a net, label, power flag, or short-circuit flag. The bridge rejects missing/ambiguous pins and verifies the native readback after the write.
`easyeda_schematic_set_title_block`	`core`	`medium`	Update schematic title block text fields (Company, Version, Drawn, Reviewed, Page Size). Only these 5 are exposed — writing Symbol/Border/Device/etc once corrupted a real title block; those are read-only natively and must be fixed via the EasyEDA Pro UI.
`easyeda_schematic_sheet_info`	`core`	`low`	Return read-only active schematic sheet metadata including page size, frame, origin, and grid hints for safer component placement.
`easyeda_schematic_sync_to_pcb`	`core`	`medium`	Request a schematic-to-PCB sync (SCH_Document.importChanges). CAUTION (live-verified): opens a confirmation dialog in EasyEDA Pro's UI a HUMAN must approve — success here only means the request was sent, not that components appeared. Ask the user to approve the dialog, then verify with pcb_components.
`easyeda_schematic_validate_netlist`	`core`	`low`	Validate inferred nets and floating pins, then cross-check native ERC. A pin is excluded from floating inference only when native noConnected readback is boolean true; unavailable or malformed state stays visible. `valid` requires clean inference and zero native errors.
`easyeda_schematic_verify_write`	`core`	`low`	Read back schematic state after an agent-authored write. Returns component-count delta evidence and optional netlist validation so agents can confirm a placement or connection before continuing.
`easyeda_schematic_wires`	`core`	`low`	List wire segments: primitiveId, line coordinates, net name, color, style. Page with offset (check total) past the 50-wire-per-call cap. primitiveId is required by delete_primitive/modify_primitive — schematic_nets alone cannot resolve a wire ID.
`easyeda_semantic_erc_auto`	`core`	`low`	Extract nets/devices/pins from the LIVE schematic and run semantic ERC — no hand-authored netlist needed. Net/pin electrical types are INFERRED from naming conventions, not verified — treat findings as a first-pass signal, not a substitute for semantic_erc_validate.
`easyeda_semantic_erc_validate`	`core`	`medium`	Run semantic electrical-rule validation over a netlist with pin electrical types to detect output contention, floating inputs, power conflicts, missing power pins, missing decoupling, and voltage-domain mismatches.
`easyeda_simulate_operating_point`	`pro`	`low`	Translate a typed circuit description into a SPICE deck and run an offline ngspice operating-point (.op) simulation, optionally checking rail node voltages against a spec. Read-only, local-only. Reports a capability gap rather than failing when ngspice is absent.
`easyeda_simulate_transient`	`pro`	`low`	Translate a typed circuit description into a SPICE deck and run an offline ngspice transient (.tran) simulation, optionally checking the final rail voltage against a spec. Read-only, local-only. Reports a capability gap rather than failing when ngspice is absent.
`easyeda_wire_probe`	`dev`	`low`	Inspect live schematic wire objects, including line coordinates, net names, methods, and state getter values, to validate EasyEDA runtime mappings.
`easyeda_workflow_connector_breakout`	`pro`	`medium`	Place a connector, wire each declared pin to its net, and create a net port for each net so the breakout is accessible off-sheet — all as a single atomic transaction (confirmWrite required).
`easyeda_workflow_decouple_ic`	`pro`	`medium`	Place one decoupling capacitor per declared IC power pin and wire each to the pin's net and ground, in a single atomic transaction. Cites design-rules decoupling guidance (rule-of-thumb, not datasheet-specific) alongside the plan (confirmWrite required).
`easyeda_workflow_layout_section`	`pro`	`medium`	Compute and create a section rectangle + title sized from the real pin extents of the given already-placed components (or replace an existing rectangle/title pair). Reports overlap with other rectangles and page-size overflow as warnings; never resizes the page.
`easyeda_workflow_led_blinker`	`pro`	`medium`	Create a deterministic LED blinker workflow: a switch, current-limiting resistor, and indicator LED. Uses safe sheet-region planning, left-to-right layout, generic wire stubs, and optional post-write QA. Caller supplies resolved device items (confirmWrite required); simplest circuit for validating the MCP pipeline.
`easyeda_workflow_ne555_astable`	`pro`	`medium`	Create a deterministic NE555 astable LED flasher workflow using safe sheet-region planning, component-level layout offsets, explicit pin-to-net connectivity, and optional post-write QA. Caller supplies already-resolved EasyEDA device items; this tool does not guess catalog parts (confirmWrite required).
`easyeda_workflow_place_block`	`pro`	`medium`	Place a group of components, wire their pin-to-net connections (new and/or pre-existing components), and create net ports for block-external nets — all as a single atomic transaction with rollback on partial failure (confirmWrite required).
`easyeda_workflow_power_rail`	`pro`	`medium`	Place a regulator and its supporting passives and wire them to input/output/ground nets in a single atomic transaction, instead of one primitive call per component. Caller supplies already-resolved device items and pin connections; this tool does not select parts (confirmWrite required).
`easyeda_workflow_rp2040_servo_module`	`pro`	`medium`	Plan or apply an RP2040 servo-module scaffold: 56 BOM parts in seven visible rollback-backed sections with deterministic titles and completeness diagnostics. Exact pin-to-net wiring stays intentionally absent until later block netlists supply it (confirmWrite required).

`easyeda_api_call`

Profile: full | Risk Level: high

Controlled call to a documented EasyEDA class method by path, for example SCH_PrimitiveWire.getAll. This is not raw JavaScript execution.

Input Parameters

Parameter	Type	Required
`path`	`string`	Yes
`args`	`any[]`	Yes
`confirmWrite`	`boolean`	Yes

Output Format

Returns a JSON object matching the schema:

{
  ok: boolean;
  path: string;
  resolvedPath: string(optional);
  result: any(optional);
  error: string(optional);
  requires_confirmation: boolean(optional);
}

`easyeda_api_inventory`

Profile: core | Risk Level: low

Inspect the live EasyEDA extension runtime and list available documented API classes, runtime paths, and methods.

Input Parameters

Parameter	Type	Required	Description
`filter`	`string (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  classes: object[];
  total: number;
  not_available: boolean (optional);
  error: string (optional);
}

`easyeda_board_dimensions`

Profile: core | Risk Level: low

Get the PCB board outline dimensions, shape, and mounting hole information.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  width_mm: number(optional);
  height_mm: number(optional);
  shape: string(optional);
  mounting_hole_count: number;
  area_mm2: number(optional);
  has_outline: boolean;
  not_available: boolean(optional);
  error: string(optional);
}

`easyeda_board_features`

Profile: core | Risk Level: low

Get counts of board features including vias, tracks, copper zones, and pads.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  vias: number;
  tracks: number;
  zones: number;
  pads: number;
  components: number(optional);
  not_available: boolean(optional);
}

`easyeda_board_layers`

Profile: core | Risk Level: low

List all layers in the PCB design including signal, power, plane, and mechanical layers.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  layers: object[];
  total: number;
  not_available: boolean (optional);
  error: string (optional);
}

`easyeda_board_stackup`

Profile: core | Risk Level: low

Get the PCB layer stackup including thickness, material, and dielectric constants.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  total_layers: number;
  board_thickness_mm: number (optional);
  layers: object[];
  data_source: 'physical_stackup' | 'copper_layer_count_only' (optional);
  not_available: boolean (optional);
  error: string (optional);
}

`easyeda_bom_export`

Profile: core | Risk Level: low

Export the bill of materials to a file on disk in the specified format.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes
`format`	`'csv'	'json'	'xlsx'`
`filePath`	`string`	Yes

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  format: string;
  file_path: string;
  exported: boolean;
  entry_count: number(optional);
  not_available: boolean(optional);
}

`easyeda_bom_generate`

Profile: core | Risk Level: low

Generate a bill of materials for the project with grouping and formatting options.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes
`format`	`'csv'	'json'	'xlsx'`
`groupBy`	`'value'	'lcsc'	'footprint'`

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  format: string;
  group_by: string;
  entries: object[];
  total_entries: number;
  not_available: boolean (optional);
}

`easyeda_bom_quality_report`

Profile: core | Risk Level: medium

Generate a BOM quality report that identifies unavailable, single-source, missing-MPN, missing-footprint, and low-stock items across configured suppliers.

Input Parameters

Parameter	Type	Required
`projectId`	`string`	Yes
`low_stock_threshold`	`number (optional)`	No
`require_mpn`	`boolean (optional)`	No
`require_footprint`	`boolean (optional)`	No
`stale_vendor_data_seconds`	`number (optional)`	No
`minimum_quality_score`	`number (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  bom_id: string;
  generated_at: string;
  total_entries: number;
  summary: object;
  entries: object[];
  has_supplier_errors: boolean;
  not_available: boolean (optional);
}

`easyeda_bom_sourcing`

Profile: core | Risk Level: medium

Retrieve pricing and availability information for all parts in the project BOM from specified suppliers.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes
`suppliers`	`string[] (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  parts: object[];
  total_parts: number;
  keyless_sourcing_enabled: boolean (optional);
  not_available: boolean (optional);
}

`easyeda_bom_validate`

Profile: core | Risk Level: medium

Validate the project BOM against LCSC inventory to identify missing, obsolete, or alternate parts.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  total_parts: number;
  missing_lcsc: string[];
  invalid_lcsc: string[];
  obsolete: string[];
  valid_count: number;
  validated: boolean;
  not_available: boolean (optional);
}

`easyeda_bridge_probe_methods`

Profile: dev | Risk Level: medium

Query the EasyEDA Pro bridge for available API methods. Requires bridge connection. (dev/pro only)

Input Parameters

Parameter	Type	Required	Description
`filter`	`string (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  methods: object[];
  total: number;
  source: 'loader_status' | 'server_registry' (optional);
  dispatcher_build_id: string (optional);
}

`easyeda_bridge_status`

Profile: core | Risk Level: low

Check EasyEDA Pro bridge connection status, version, and capabilities.

Input Parameters

No parameters required.

Output Format

Returns a JSON object matching the schema:

{
  connected: boolean;
  bridge_version: string (optional);
  easyeda_version: string (optional);
  capabilities: string[] (optional);
  dev_mode: boolean (optional);
  last_heartbeat_ms: number (optional);
  uptime_ms: number (optional);
  status_error: string (optional);
  diagnostics: object (optional);
}

`easyeda_canvas_capture`

Profile: core | Risk Level: low

Capture the currently visible EasyEDA schematic/PCB canvas as a PNG image, so the caller can visually verify the result of a draw/place/route action. Captures the given tab (or last-focused); use easyeda_canvas_capture_region first to frame a specific area. Image is delivered once, as its own content block.

Input Parameters

Parameter	Type	Required	Description
`tabId`	`string (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  captured: boolean;
  mime_type: string(optional);
  file_name: string(optional);
  byte_length: number(optional);
  image_base64: string(optional);
  not_available: boolean(optional);
  error: string(optional);
}

`easyeda_canvas_capture_region`

Profile: core | Risk Level: low

Zoom the EasyEDA canvas to a rectangular region (document/canvas coordinates) and capture it as a PNG, so the caller can visually verify a specific area. This moves the user's visible viewport — EasyEDA Pro has no offscreen rendering API. The image is delivered once, as its own content block.

Input Parameters

Parameter	Type	Required	Description
`left`	`number`	Yes	First horizontal edge in document/canvas coordinates.
`right`	`number`	Yes	Second horizontal edge; either edge order is accepted.
`top`	`number`	Yes	First vertical edge in document/canvas coordinates.
`bottom`	`number`	Yes	Second vertical edge; either edge order is accepted.
`tabId`	`string (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  captured: boolean;
  mime_type: string(optional);
  file_name: string(optional);
  byte_length: number(optional);
  image_base64: string(optional);
  not_available: boolean(optional);
  error: string(optional);
}

`easyeda_canvas_locate`

Profile: core | Risk Level: low

Zoom the EasyEDA canvas to a coordinate/scale (document/canvas coordinates), returning the resulting viewport rectangle. Useful to frame a location before calling easyeda_canvas_capture, or standalone to navigate the user's view to a point of interest.

Input Parameters

Parameter	Type	Required
`x`	`number (optional)`	No
`y`	`number (optional)`	No
`scaleRatio`	`number (optional)`	No
`tabId`	`string (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  located: boolean;
  left: number(optional);
  right: number(optional);
  top: number(optional);
  bottom: number(optional);
  not_available: boolean(optional);
  error: string(optional);
}

`easyeda_catalog_list`

Profile: pro | Risk Level: low

List devices cached by easyeda_catalog_verify_device, with their validation status and provenance. Optionally filter by status (resolved/partial/unresolved). This is a local cache only — never redistributed.

Input Parameters

Parameter	Type	Required	Description
`status`	`'resolved'	'partial'	'unresolved' (optional)`

Output Format

Returns a JSON object matching the schema:

{
  devices: object[];
  total: number;
  not_available: boolean (optional);
  error: string (optional);
}

`easyeda_catalog_verify_device`

Profile: pro | Risk Level: medium

Resolve an LCSC part number into a catalog device entry (keyless LCSC metadata plus an EasyEDA symbol/footprint reference, if already known locally), validate it, and write it to the local device cache (confirmWrite required). Does NOT verify pin/pad geometry — see docs/catalog-ingestion.md.

Input Parameters

Parameter	Type	Required	Description
`lcscId`	`string`	Yes
`confirmWrite`	`boolean`	Yes

Output Format

Returns a JSON object matching the schema:

{
  lcsc_id: string;
  status: 'resolved' | 'partial' | 'unresolved';
  valid: boolean;
  errors: object[];
  warnings: object[];
  provenance: object;
  entry: object;
  cached: boolean;
  not_available: boolean (optional);
  error: string (optional);
}

`easyeda_component_probe`

Profile: dev | Risk Level: low

Inspect live schematic component objects, including available methods and state getter values, to validate EasyEDA runtime mappings.

Input Parameters

Parameter	Type	Required	Description
`limit`	`number`	Yes

Output Format

Returns a JSON object matching the schema:

{
  total: number;
  samples: any[];
  not_available: boolean (optional);
  error: string (optional);
}

`easyeda_design_rules_lookup`

Profile: core | Risk Level: low

Look up generic engineering reference guidance: IPC-2221 trace-width/current-capacity, clearance bands, protocol routing data (USB/RS-485/I2C/SPI/UART/Ethernet), decoupling recipes and bulk capacitance sizing, and a static DFM checklist. Every result cites a source and caveat: these are estimates, not certified values.

Input Parameters

Parameter	Type	Required	Description
`topic`	`'trace-width'	'max-current'	'clearance'
`currentA`	`number (optional)`	No	Required when topic is trace-width. Load current in amperes.
`traceWidthMils`	`number (optional)`	No	Required when topic is max-current. Trace width in mils.
`temperatureRiseC`	`number (optional)`	No	Required for trace-width and max-current. Allowed temperature rise in °C.
`layer`	`'external'	'internal' (optional)`	No
`copperWeightOz`	`number (optional)`	No	Required for trace-width and max-current. Copper weight in oz/ft².
`voltageV`	`number (optional)`	No	Required when topic is clearance. Working voltage in volts.
`location`	`'external'	'internal' (optional)`	No
`protocol`	`'usb2'	'usb3'	'rs485'
`category`	`'digital-logic'	'mcu'	'analog'
`loadA`	`number (optional)`	No	Required when topic is bulk-capacitance. Load current in amperes.
`minBulkCapacitanceUfPerA`	`number (optional)`	No	Optional minimum bulk capacitance per ampere in µF/A.
`minBulkCapacitanceUf`	`number (optional)`	No	Optional absolute minimum bulk capacitance in µF.
`id`	`string (optional)`	No	Optional DFM checklist item id.

Output Format

Returns a JSON object matching the schema:

{
  topic: string;
  traceWidth: object (optional);
  maxCurrent: object (optional);
  clearance: object (optional);
  protocolRouting: object (optional);
  protocolRoutingList: object[] (optional);
  decoupling: object (optional);
  decouplingList: object[] (optional);
  bulkCapacitance: object (optional);
  dfmChecklist: object[] (optional);
  dfmChecklistItem: object (optional);
  error: string (optional);
}

`easyeda_drc_run`

Profile: core | Risk Level: medium

Run the native design rule check (DRC): same as clicking "Check DRC" in EasyEDA Pro, so the bottom DRC panel opens/refreshes in the user's window as a visible side effect. Returns coarse per-severity counts only — which specific wire/net/component is affected is shown only in EasyEDA Pro's own DRC panel.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes
`rules`	`string[] (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  violations: object[];
  total_violations: number;
  error_count: number;
  warning_count: number;
  passed: boolean;
  not_available: boolean (optional);
}

`easyeda_erc_run`

Profile: core | Risk Level: medium

Run native ERC and supplement its coarse counts with inferred_floating_pins. Only a strict native noConnected=true readback suppresses a pin; unavailable or malformed state remains visible. Native counts remain authoritative for other categories.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes
`checks`	`string[] (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  violations: object[];
  total_violations: number;
  error_count: number;
  warning_count: number;
  passed: boolean;
  inferred_floating_pins: object[] (optional);
  detail_source: 'inferred_partial' | 'native_aggregate_only' (optional);
  not_available: boolean (optional);
}

`easyeda_export_gerbers`

Profile: core | Risk Level: medium

Export PCB design to Gerber files for PCB fabrication.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes
`filePath`	`string (optional)`	No
`drillFormat`	`'excellon'	'millimeter'	'inch' (optional)`
`excludeLayer`	`string[] (optional)`	No
`ledPanel`	`boolean (optional)`	No
`productionReview`	`object (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  artifact_path: string(optional);
  byte_length: number(optional);
  file_count: number(optional);
  exported: boolean;
  blocked_by_production_review: boolean(optional);
  production_review: object(optional);
  not_available: boolean(optional);
  error: string(optional);
}

`easyeda_export_netlist`

Profile: pro | Risk Level: low

Export the schematic netlist in a specified EDA tool format (PADS, Allegro, or Altium).

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes
`format`	`'pads'	'allegro'	'altium'`
`filePath`	`string (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  format: string;
  file_path: string(optional);
  byte_length: number(optional);
  net_count: number(optional);
  exported: boolean;
  not_available: boolean(optional);
  error: string(optional);
}

`easyeda_export_pdf`

Profile: pro | Risk Level: low

Export the schematic and/or board layout to PDF.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes
`scope`	`'schematic'	'board'	'both'`
`orientation`	`'portrait'	'landscape'`	Yes
`filePath`	`string (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  scope: string;
  orientation: string;
  file_path: string(optional);
  byte_length: number(optional);
  pages: number(optional);
  exported: boolean;
  not_available: boolean(optional);
  error: string(optional);
}

`easyeda_export_pick_place`

Profile: pro | Risk Level: low

Export pick-and-place (centroid) file for PCB assembly. Contains component reference, position, rotation, and layer.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes
`format`	`'csv'	'txt'`	Yes
`filePath`	`string (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  format: string;
  file_path: string(optional);
  byte_length: number(optional);
  component_count: number(optional);
  exported: boolean;
  not_available: boolean(optional);
  error: string(optional);
}

`easyeda_get_capabilities`

Profile: core | Risk Level: low

Return server capabilities, including available profiles, enabled feature flags, and supported operations.

Input Parameters

No parameters required.

Output Format

Returns a JSON object matching the schema:

{
  server_name: string;
  server_version: string;
  protocol_version: string;
  profiles: object[];
  current_profile: string;
  feature_flags: Record<string, boolean>;
  feature_maturity: Record<string, object>;
  transports: string[];
}

`easyeda_get_feature_flags`

Profile: core | Risk Level: low

Return current feature flag values.

Input Parameters

No parameters required.

Output Format

Returns a JSON object matching the schema:

{
  flags: Record<string, boolean>;
  maturity: Record<string, object>;
}

`easyeda_get_server_config`

Profile: core | Risk Level: low

Return safe (redacted) server configuration. Secrets are never exposed.

Input Parameters

Parameter	Type	Required	Description
`include_flags`	`boolean`	Yes

Output Format

Returns a JSON object matching the schema:

{
  node_env: string;
  log_level: string;
  profile: string;
  transport: string;
  bridge_host: string;
  bridge_port: number;
  mcp_protocol_version: string;
  flags: Record<string, boolean>(optional);
  feature_maturity: Record<string, object>;
}

`easyeda_get_tool_profiles`

Profile: core | Risk Level: low

List available tool profiles and their descriptions.

Input Parameters

No parameters required.

Output Format

Returns a JSON object matching the schema:

{
  current: string;
  profiles: object[];
}

`easyeda_health_check`

Profile: core | Risk Level: low

Return server health status in one call: runtime version, active profile, bridge state, EasyEDA version, keyless sourcing state, and starter catalog size. Intended as the single actionable status check after first connecting the bridge extension.

Input Parameters

No parameters required.

Output Format

Returns a JSON object matching the schema:

{
  status: 'ok' | 'degraded' | 'unavailable';
  version: string;
  node_version: string;
  profile: string;
  transport: string;
  bridge_connected: boolean;
  easyeda_version: string(optional);
  extension_version: string(optional);
  extension_version_mismatch: boolean;
  registry_mismatch: boolean;
  keyless_sourcing_enabled: boolean;
  catalog_device_count: number;
  ups: number;
}

`easyeda_jlcpcb_quote_workflow`

Profile: pro | Risk Level: medium

Prepare a non-binding JLCPCB quote workflow snapshot with explicit human-review gates and audit evidence. This tool never places orders or performs paid operations.

Input Parameters

Parameter	Type	Required	Description
`provider`	`'jlcpcb'	'custom'`	Yes
`action`	`'estimate'	'verify_quote'	'place_order'`
`projectId`	`string (optional)`	No
`board`	`object`	Yes
`quote`	`object (optional)`	No
`confirmation`	`object (optional)`	No
`vendorTermsReviewed`	`boolean (optional)`	No
`productionFilesReady`	`boolean (optional)`	No
`exportManifestVerified`	`boolean (optional)`	No
`productionReviewPassed`	`boolean (optional)`	No
`allowedPaidOperations`	`boolean (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  provider: string;
  action: string;
  project_id: string;
  status: string;
  allowed: boolean;
  quote: object;
  risk: object;
  issues: object[];
  audit: object;
  summary: string;
  unsupported_operations: string[];
}

`easyeda_live_smoke_report`

Profile: dev | Risk Level: low

Run a read-only live smoke report against the connected EasyEDA bridge and return status, API inventory, components, wires, and schematic nets in one response.

Input Parameters

Parameter	Type	Required
`projectId`	`string`	Yes
`limit`	`number`	Yes
`includeRaw`	`boolean`	Yes
`timeoutMs`	`number`	Yes

Output Format

Returns a JSON object matching the schema:

{
  ok: boolean;
  project_id: string;
  generated_at: string;
  checks: object[];
  summary: object;
  raw: object (optional);
}

`easyeda_live_write_regression`

Profile: dev | Risk Level: medium

Exercise real schematic (and optionally PCB) write paths against the bridge — place, connect, wire, delete — reporting pass/fail per step, then clean up its own scratch primitives. Needs a test device from schematic_search_device and the matching tab focused.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes
`testDeviceItem`	`object`	Yes
`scope`	`'schematic'	'pcb'	'both'`
`confirmWrite`	`'true'`	Yes	Must be the literal boolean true (not the string "true") to allow this write.

Output Format

Returns a JSON object matching the schema:

{
  ok: boolean;
  project_id: string;
  scope: string;
  steps: object[];
  cleanup_performed: boolean;
}

`easyeda_observability_report`

Profile: core | Risk Level: low

Return latency budgets, runtime metrics, cache/vendor timing snapshot, and storage retention policy for performance diagnostics.

Input Parameters

Parameter	Type	Required	Description
`includeRecentEvents`	`boolean`	Yes

Output Format

Returns a JSON object matching the schema:

{
  generated_at: string;
  server_version: string;
  budgets: object[];
  metrics: object;
  retention: object;
  timeout_policy: object;
}

`easyeda_pcb_add_silkscreen_line`

Profile: full | Risk Level: medium

Draw a non-electrical line on the PCB (e.g. Top/Bottom Silkscreen) for section dividers or board art — reuses the same PCB_PrimitiveLine primitive as add_track but with an empty net name, so it never appears in the netlist or ratsnest.

Input Parameters

Parameter	Type	Required	Description
`layer`	`number`	Yes	Layer id, e.g. 3 = Top Silkscreen, 4 = Bottom Silkscreen
`startX`	`number`	Yes
`startY`	`number`	Yes
`endX`	`number`	Yes
`endY`	`number`	Yes
`lineWidth`	`number (optional)`	No
`confirmWrite`	`'true'`	Yes	Must be the literal boolean true (not the string "true") to allow this write.

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  primitiveId: string(optional);
  error: string(optional);
}

`easyeda_pcb_add_text`

Profile: full | Risk Level: medium

Place a text primitive on a PCB layer (typically Top/Bottom Silkscreen) — reference labels, section titles, assembly notes. Signature recovered from PCB_PrimitiveString: fontFamily must be a name the runtime's font list actually contains — "NotoSansMonoCJKsc-Regular" (the default) is live-verified to work.

Input Parameters

Parameter	Type	Required	Description
`layer`	`number`	Yes	Layer id, e.g. 3 = Top Silkscreen, 4 = Bottom Silkscreen
`x`	`number`	Yes
`y`	`number`	Yes
`text`	`string`	Yes
`fontFamily`	`string (optional)`	No
`fontSize`	`number (optional)`	No
`lineWidth`	`number (optional)`	No
`alignMode`	`number (optional)`	No
`rotation`	`number (optional)`	No
`reverse`	`boolean (optional)`	No
`expansion`	`number (optional)`	No
`mirror`	`boolean (optional)`	No
`locked`	`boolean (optional)`	No
`confirmWrite`	`'true'`	Yes	Must be the literal boolean true (not the string "true") to allow this write.

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  primitiveId: string(optional);
  error: string(optional);
}

`easyeda_pcb_add_track`

Profile: full | Risk Level: high

Draw a copper track/trace on the PCB board. A multi-point path is written as one line segment per consecutive point pair (all sharing netName, so they form one electrical track — same coordinate/name merge model as schematic wires).

Input Parameters

Parameter	Type	Required	Description
`points`	`object[]`	Yes
`layer`	`number`	Yes
`width`	`number`	Yes
`netName`	`string (optional)`	No
`confirmWrite`	`'true'`	Yes	Must be the literal boolean true (not the string "true") to allow this write.

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  primitiveId: string (optional);
  primitiveIds: string[] (optional);
  error: string (optional);
}

`easyeda_pcb_add_via`

Profile: full | Risk Level: high

Place a via to connect different copper layers on the PCB board. outerDiameter/holeSize are passed through to the native API unconverted (same native unit as x/y) — their real-world scale was not independently verified against a known physical dimension, so confirm the resulting via size visually before trusting it.

Input Parameters

Parameter	Type	Required	Description
`x`	`number`	Yes
`y`	`number`	Yes
`outerDiameter`	`number`	Yes
`holeSize`	`number`	Yes
`netName`	`string (optional)`	No
`confirmWrite`	`'true'`	Yes	Must be the literal boolean true (not the string "true") to allow this write.

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  primitiveId: string(optional);
  error: string(optional);
}

`easyeda_pcb_add_zone`

Profile: full | Risk Level: high

Create a copper pour zone on a layer with clearance settings. CAUTION: the native create() call needs 9 args but this tool sends only 4 (points, layer, netName, clearance) — live-confirmed mismatch, not yet resolved. Verify visually before trusting it.

Input Parameters

Parameter	Type	Required	Description
`points`	`object[]`	Yes
`layer`	`number`	Yes
`netName`	`string (optional)`	No
`clearance`	`number (optional)`	No
`confirmWrite`	`'true'`	Yes	Must be the literal boolean true (not the string "true") to allow this write.

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  primitiveId: string(optional);
  error: string(optional);
}

`easyeda_pcb_autoroute`

Profile: pro | Risk Level: high

Drive EasyEDA Pro's native autorouter (PCB_Document.autoRouting, a @beta API) after a pre-flight constraint check, then run DRC and a constraint report before reporting success. Never reports success without that evidence attached (confirmWrite required).

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes
`routingNets`	`'selected'	'selectedComponents'	string[] (optional)`
`cornerStyle`	`'45'	'90' (optional)`	No
`existingPrimitiveMode`	`'keep'	'remove' (optional)`	No
`optimization`	`'completion'	'faster' (optional)`	No
`layers`	`number[] (optional)`	No
`ignoreNets`	`string[] (optional)`	No
`boardData`	`object (optional)`	No
`confirmWrite`	`boolean (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  project_id: string;
  overall_verdict: 'success' | 'partial' | 'blocked' | 'failed';
  blocked_by_preflight: boolean;
  preflight: object(optional);
  autoroute_result: object(optional);
  post_route_drc: object(optional);
  post_route_constraint_report: object(optional);
  summary: string;
  not_available: boolean(optional);
  error: string(optional);
}

`easyeda_pcb_components`

Profile: core | Risk Level: low

List components placed on the active PCB layout: primitiveId, designator, footprint identity, position/rotation/layer. Requires a focused PCB tab in EasyEDA Pro — returns an empty list (not an error) if none is active.

Input Parameters

Parameter	Type	Required
`projectId`	`string`	Yes
`limit`	`number`	Yes
`offset`	`number`	Yes

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  components: object[];
  total: number;
  not_available: boolean (optional);
  error: string (optional);
}

`easyeda_pcb_constraint_check`

Profile: core | Risk Level: low

Run PCB constraint validation against the board design. Checks board outline, layer stackup, net classes, clearance rules, keepout areas, placement zones, mounting holes, fiducials, and manufacturing constraints.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes
`boardData`	`object (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  valid: boolean;
  errors: object[];
  warnings: object[];
  summary: object;
  not_available: boolean (optional);
}

`easyeda_pcb_constraint_report`

Profile: core | Risk Level: low

Generate a human-readable report explaining which PCB constraints were applied and which require manual review.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes
`boardData`	`object (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  verdict: string;
  checked: object[];
  manualReviewRequired: object[];
  not_available: boolean (optional);
}

`easyeda_pcb_delete_component`

Profile: full | Risk Level: high

Delete components, tracks, vias, or other PCB primitives by ID. Checks each id against every deletable PCB class instead of assuming component, since PCB_PrimitiveComponent.delete() reports success for ids it does not own without deleting them.

Input Parameters

Parameter	Type	Required	Description
`primitiveIds`	`string[]`	Yes
`confirmWrite`	`'true'`	Yes	Must be the literal boolean true (not the string "true") to allow this write.

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  deletedCount: number (optional);
  deleted: string[] (optional);
  notFound: string[] (optional);
  error: string (optional);
}

`easyeda_pcb_export_route_context`

Profile: pro | Risk Level: low

Export the board as a Specctra DSN file (PCB_ManufactureData.getDsnFile) — an open, vendor-neutral format supported by external autorouters such as FreeRouting. Re-import the routed result through EasyEDA Pro's own SES/DSN import, not through this server.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes
`filePath`	`string (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  artifact_path: string(optional);
  byte_length: number(optional);
  exported: boolean;
  not_available: boolean(optional);
  error: string(optional);
}

`easyeda_pcb_floorplan`

Profile: full | Risk Level: high

Translate CircuitIR physical constraints (keepouts, top/bottom side, connector-edge, thermal spacing) into a component group placement plan, then optionally apply it. CircuitIR devices carry no physical dimensions, so widths/heights must be supplied per device (confirmWrite required).

Input Parameters

Parameter	Type	Required	Description
`circuitIR`	`any`	Yes
`devices`	`object[]`	Yes
`projectId`	`string (optional)`	No
`mode`	`'preview'	'apply'`	Yes
`board`	`object`	Yes
`anchor`	`object`	Yes
`columns`	`number (optional)`	No
`spacingMm`	`number (optional)`	No
`minSpacingMm`	`number (optional)`	No
`topLayer`	`number (optional)`	No
`bottomLayer`	`number (optional)`	No
`connectorEdge`	`'top'	'bottom'	'left'
`connectorEdgeMarginMm`	`number (optional)`	No
`thermalSpacingBoostMm`	`number (optional)`	No
`thermalDissipationThresholdWatts`	`number (optional)`	No
`confirmWrite`	`boolean (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  project_id: string;
  transaction_id: string;
  mode: string;
  applied: boolean;
  blocked: boolean;
  placements: object[];
  operations: object[];
  apply_results: object[] (optional);
  issues: object[];
  floorplan_notes: string[];
  summary: string;
  not_available: boolean (optional);
  error: string (optional);
}

`easyeda_pcb_modify_component`

Profile: full | Risk Level: high

Modify component properties in the PCB layout.

Input Parameters

Parameter	Type	Required	Description
`primitiveId`	`string`	Yes
`property`	`Record<string, any>`	Yes
`confirmWrite`	`'true'`	Yes	Must be the literal boolean true (not the string "true") to allow this write.

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  error: string(optional);
}

`easyeda_pcb_place_component`

Profile: full | Risk Level: high

Direct PCB component creation is unavailable because the verified EasyEDA runtime does not complete PCB_PrimitiveComponent.create(). This tool fails closed. Place the part in the schematic, sync to PCB, confirm the native dialog, then reposition it with easyeda_pcb_modify_component.

Input Parameters

Parameter	Type	Required	Description
`footprint`	`string`	Yes
`x`	`number`	Yes
`y`	`number`	Yes
`rotation`	`number`	Yes
`layer`	`number`	Yes
`confirmWrite`	`'true'`	Yes	Must be the literal boolean true (not the string "true") to allow this write.

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  not_available: boolean(optional);
  error: string(optional);
  remediation: string(optional);
}

`easyeda_pcb_place_component_group`

Profile: full | Risk Level: high

Create a high-level, constraint-checked placement plan for a group of components and optionally apply it after explicit confirmation.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string (optional)`	No
`mode`	`'preview'	'apply'`	Yes
`board`	`object`	Yes
`anchor`	`object`	Yes
`columns`	`number (optional)`	No
`spacingMm`	`number (optional)`	No
`layer`	`number`	Yes
`minSpacingMm`	`number (optional)`	No
`components`	`object[]`	Yes
`keepouts`	`object[] (optional)`	No
`confirmWrite`	`boolean (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  project_id: string;
  transaction_id: string;
  mode: string;
  applied: boolean;
  blocked: boolean;
  placements: object[];
  operations: object[];
  apply_results: object[] (optional);
  issues: object[];
  summary: string;
  error: string (optional);
}

`easyeda_pcb_production_review`

Profile: core | Risk Level: medium

Run fabrication, assembly, and testability production review rules for PCB handoff. Reports severity-ranked DFM/DFA/DFT findings with actionable remediation before Gerber export or manufacturing submission.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes
`boardData`	`object (optional)`	No
`gateMode`	`'warn'	'block'	'off'`

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  passed: boolean;
  blocked: boolean;
  gate_mode: string;
  severity_counts: object;
  errors: object[];
  warnings: object[];
  summary: object;
  not_available: boolean (optional);
}

`easyeda_pcb_route_path_plan`

Profile: full | Risk Level: high

Create a high-level, constraint-checked route path plan for one net and optionally apply it after explicit confirmation.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string (optional)`	No
`mode`	`'preview'	'apply'`	Yes
`board`	`object (optional)`	No
`netName`	`string`	Yes
`layer`	`number`	Yes
`widthMm`	`number`	Yes
`waypoints`	`object[]`	Yes
`keepouts`	`object[] (optional)`	No
`maxLengthMm`	`number (optional)`	No
`minWidthMm`	`number (optional)`	No
`confirmWrite`	`boolean (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  project_id: string;
  transaction_id: string;
  mode: string;
  applied: boolean;
  blocked: boolean;
  net_name: string;
  layer: number;
  width_mm: number;
  path_length_mm: number;
  operations: object[];
  apply_results: object[] (optional);
  issues: object[];
  summary: string;
  error: string (optional);
}

`easyeda_pcb_tracks`

Profile: core | Risk Level: low

List copper track segments on the active PCB layout: primitiveId, net, layer, start/end coordinates, width. A multi-point track drawn by add_track appears as several consecutive segments sharing one net. Returns an empty list (not an error) if no PCB tab is focused.

Input Parameters

Parameter	Type	Required
`projectId`	`string`	Yes
`limit`	`number`	Yes
`offset`	`number`	Yes

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  tracks: object[];
  total: number;
  not_available: boolean (optional);
  error: string (optional);
}

`easyeda_pcb_vias`

Profile: core | Risk Level: low

List vias on the active PCB layout: primitiveId, net, position, hole/outer diameter (native unit, same scale as x/y — not independently verified against a known physical dimension). Requires a focused PCB tab — returns an empty list (not an error) if none is active.

Input Parameters

Parameter	Type	Required
`projectId`	`string`	Yes
`limit`	`number`	Yes
`offset`	`number`	Yes

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  vias: object[];
  total: number;
  not_available: boolean (optional);
  error: string (optional);
}

`easyeda_post_write_qa`

Profile: core | Risk Level: medium

Run and classify post-write schematic QA after generated edits. Combines native DRC/ERC results with policy-aware classification so duplicate net names, free networks, and unconnected pins are reported as pass/fail/inconclusive instead of raw warning counts.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes
`policy`	`'circuit'	'diagnostic-fixture'`	Yes
`useNativeChecks`	`boolean`	Yes
`manualDrcMessages`	`string[] (optional)`	No	Optional user-copied EasyEDA DRC log lines for classification when native details are unavailable
`manualErcMessages`	`string[] (optional)`	No	Optional user-copied EasyEDA ERC log lines for classification when native details are unavailable
`drc`	`object (optional)`	No	Optional explicit DRC result override for tests or log ingestion
`erc`	`object (optional)`	No	Optional explicit ERC result override for tests or log ingestion

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  status: 'pass' | 'fail' | 'inconclusive';
  passed: boolean;
  policy: 'circuit' | 'diagnostic-fixture';
  issue_count: number;
  fatal_count: number;
  warning_count: number;
  inconclusive_count: number;
  categories: Record<string, number>;
  issues: object[];
  summary: string;
  detail_source: 'native' | 'manual' | 'override' | 'mixed' (optional);
}

`easyeda_power_tree_analyze`

Profile: core | Risk Level: medium

Analyze supply sources, regulators, loads, protection, bulk capacitance, current budget, dropout, and regulator thermal risk. Returns machine-readable issues and a human-readable summary.

Input Parameters

Parameter	Type	Required
`projectId`	`string (optional)`	No
`rails`	`object[]`	Yes
`sources`	`object[] (optional)`	No
`regulators`	`object[] (optional)`	No
`loads`	`object[] (optional)`	No
`protections`	`object[] (optional)`	No
`capacitors`	`object[] (optional)`	No
`limits`	`object (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  passed: boolean;
  rails: object[];
  regulators: object[];
  issues: object[];
  summary: object;
}

`easyeda_production_qa_artifacts`

Profile: pro | Risk Level: low

Generate testpoint checklist, assembly notes, bring-up plan, production QA checklist, and machine-readable QA manifest for board handoff.

Input Parameters

Parameter	Type	Required
`projectId`	`string (optional)`	No
`projectName`	`string (optional)`	No
`revision`	`string (optional)`	No
`criticalNets`	`object[] (optional)`	No
`components`	`object[] (optional)`	No
`requiresProgramming`	`boolean (optional)`	No
`programmingInterfaces`	`string[] (optional)`	No
`hasProgrammingAccess`	`boolean (optional)`	No
`hasBattery`	`boolean (optional)`	No
`requiresFunctionalTest`	`boolean (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  project_name: string (optional);
  revision: string (optional);
  passed: boolean;
  issues: object[];
  checklist: object[];
  artifacts: object[];
  summary: object;
}

`easyeda_project_begin_transaction`

Profile: core | Risk Level: low

Open an in-memory, document-scoped transaction for snapshot-backed schematic writes. Only one active transaction is allowed per document. Beginning a transaction does not modify EasyEDA.

Input Parameters

Parameter	Type	Required
`projectId`	`string`	Yes
`label`	`string (optional)`	No
`maxOperations`	`number`	Yes
`ttlSeconds`	`number`	Yes

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  transaction: object (optional);
  restored_operation_ids: string[] (optional);
  failed_operation_ids: string[] (optional);
  error_code: string (optional);
  error: string (optional);
  details: Record<string, any> (optional);
}

`easyeda_project_commit_transaction`

Profile: core | Risk Level: medium

Finalize a transaction after its writes and validation gates succeed. Commit removes rollback eligibility and releases the document transaction lock.

Input Parameters

Parameter	Type	Required	Description
`transactionId`	`string`	Yes
`confirmWrite`	`'true'`	Yes

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  transaction: object (optional);
  restored_operation_ids: string[] (optional);
  failed_operation_ids: string[] (optional);
  error_code: string (optional);
  error: string (optional);
  details: Record<string, any> (optional);
}

`easyeda_project_get_transaction_status`

Profile: core | Risk Level: low

Read transaction state, validation results, operation hashes, and rollback status without exposing captured primitive snapshots.

Input Parameters

Parameter	Type	Required	Description
`transactionId`	`string`	Yes

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  transaction: object (optional);
  restored_operation_ids: string[] (optional);
  failed_operation_ids: string[] (optional);
  error_code: string (optional);
  error: string (optional);
  details: Record<string, any> (optional);
}

`easyeda_project_rollback_transaction`

Profile: core | Risk Level: medium

Controlled write: restore applied schematic primitive snapshots in reverse order, verify each restored hash, and report partial rollback explicitly instead of hiding inconsistencies.

Input Parameters

Parameter	Type	Required	Description
`transactionId`	`string`	Yes
`confirmWrite`	`'true'`	Yes

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  transaction: object (optional);
  restored_operation_ids: string[] (optional);
  failed_operation_ids: string[] (optional);
  error_code: string (optional);
  error: string (optional);
  details: Record<string, any> (optional);
}

`easyeda_project_save`

Profile: core | Risk Level: medium

Explicitly save the current EasyEDA Pro project. This ensures all netlist changes, net flags, pin connections, and other mutations are persisted to the project file. Save is never implicit — the caller must explicitly request it. Requires confirmWrite.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes	The project/schematic ID to save
`confirmWrite`	`'true'`	Yes	Must be the literal boolean true (not the string "true") to allow this write.

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  project_id: string;
  saved_at: string(optional);
  error: string(optional);
}

`easyeda_project_validate_transaction`

Profile: core | Risk Level: low

Run transaction consistency gates before commit: bridge availability, pending/failed operation checks, optional expected operation count, and optional requirement for at least one applied write.

Input Parameters

Parameter	Type	Required
`transactionId`	`string`	Yes
`expectedOperationCount`	`number (optional)`	No
`requireAppliedOperations`	`boolean`	Yes
`requireBridgeConnected`	`boolean`	Yes

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  transaction: object (optional);
  restored_operation_ids: string[] (optional);
  failed_operation_ids: string[] (optional);
  error_code: string (optional);
  error: string (optional);
  details: Record<string, any> (optional);
}

`easyeda_rule_check_summary`

Profile: core | Risk Level: low

Get a summary of all design and electrical rule check results for the project.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  drc: object;
  erc: object;
  overall_passed: boolean;
  not_available: boolean(optional);
}

`easyeda_run_self_test`

Profile: core | Risk Level: low

Run internal self-test to verify server integrity, config, and bridge connectivity.

Input Parameters

No parameters required.

Output Format

Returns a JSON object matching the schema:

{
  passed: boolean;
  checks: object[];
}

`easyeda_schematic_add_circle`

Profile: core | Risk Level: medium

Draw a circle on the schematic sheet — decorative marker or custom symbol element. Cosmetic only, no electrical meaning. fillColor "none" leaves it unfilled.

Input Parameters

Parameter	Type	Required	Description
`centerX`	`number`	Yes
`centerY`	`number`	Yes
`radius`	`number`	Yes
`color`	`string (optional)`	No
`fillColor`	`string (optional)`	No	Fill color, hex string, or "none" for unfilled
`lineWidth`	`number (optional)`	No
`lineType`	`number (optional)`	No
`fillStyle`	`string (optional)`	No
`confirmWrite`	`'true'`	Yes	Must be the literal boolean true (not the string "true") to allow this write.

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  circle: any(optional);
  error: string(optional);
}

`easyeda_schematic_add_polygon`

Profile: core | Risk Level: medium

Draw a closed polygon on the schematic sheet from 3+ vertices — custom decorative shapes, callout arrows, or block diagram elements. Cosmetic only, no electrical meaning.

Input Parameters

Parameter	Type	Required	Description
`points`	`object[]`	Yes
`color`	`string (optional)`	No
`fillColor`	`string (optional)`	No	Fill color, hex string, or "none" for unfilled
`lineWidth`	`number (optional)`	No
`lineType`	`number (optional)`	No
`confirmWrite`	`'true'`	Yes	Must be the literal boolean true (not the string "true") to allow this write.

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  polygon: any(optional);
  error: string(optional);
}

`easyeda_schematic_add_rectangle`

Profile: core | Risk Level: medium

Draw a rectangle on the schematic sheet — section dividers/grouping boxes for organizing a busy schematic into labeled functional blocks (pair with add_text for the title). Cosmetic only. x/y is the top-left corner; fillColor "none" leaves it unfilled.

Input Parameters

Parameter	Type	Required	Description
`x`	`number`	Yes	Top-left X coordinate
`y`	`number`	Yes	Top-left Y coordinate
`width`	`number`	Yes
`height`	`number`	Yes
`cornerRadius`	`number (optional)`	No
`rotation`	`number (optional)`	No
`color`	`string (optional)`	No	Border/line color, hex string (e.g. "#FF0000")
`fillColor`	`string (optional)`	No	Fill color, hex string, or "none" for unfilled
`lineWidth`	`number (optional)`	No
`lineType`	`number (optional)`	No
`fillStyle`	`string (optional)`	No
`confirmWrite`	`'true'`	Yes	Must be the literal boolean true (not the string "true") to allow this write.

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  rectangle: any(optional);
  error: string(optional);
}

`easyeda_schematic_add_text`

Profile: core | Risk Level: medium

Place free-standing text on the schematic sheet (section headers, notes, block labels) — cosmetic/organizational, not a net label. color must be a hex string and fontName a real font (e.g. "Arial") — untyped placeholders create nothing despite returning ok.

Input Parameters

Parameter	Type	Required	Description
`x`	`number`	Yes
`y`	`number`	Yes
`content`	`string`	Yes
`rotation`	`number (optional)`	No
`color`	`string (optional)`	No
`fontName`	`string (optional)`	No
`fontSize`	`number (optional)`	No
`bold`	`boolean (optional)`	No
`italic`	`boolean (optional)`	No
`underline`	`boolean (optional)`	No
`alignMode`	`number (optional)`	No
`confirmWrite`	`'true'`	Yes	Must be the literal boolean true (not the string "true") to allow this write.

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  text: any(optional);
  error: string(optional);
}

`easyeda_schematic_add_wire`

Profile: core | Risk Level: medium

Add a wire connecting schematic coordinates/pins — real native connectivity. Same netName connects pins globally: separate stubs sharing one name merge into one net (no label needed). NET_COLLISION guards touched points against a foreign net's wire, pin, or flag/port — not mid-segment crossings.

Input Parameters

Parameter	Type	Required	Description
`points`	`object[]`	Yes
`netName`	`string (optional)`	No
`color`	`string (optional)`	No
`lineWidth`	`number (optional)`	No
`lineType`	`string (optional)`	No
`confirmWrite`	`'true'`	Yes	Must be the literal boolean true (not the string "true") to allow this write.

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  wire: any(optional);
  error: string(optional);
}

`easyeda_schematic_audit_imported_design`

Profile: core | Risk Level: low

Read the live schematic without modifying it, build a canonical model, and report imported net aliases, duplicate or missing references, unresolved metadata expressions, missing values/footprints, and ambiguous BOM classification. Includes a preview only; it never renames nets or changes components.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes	The project/schematic ID to audit
`includeInfo`	`boolean`	Yes	Include informational imported-alias and power-flag findings
`componentLimit`	`number`	Yes	Maximum number of component records to read from the live bridge

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  audit_schema_version: 'imported-design-audit/v1';
  status: 'clean' | 'review' | 'blocked';
  read_only: 'true';
  safe_to_normalize: boolean;
  source: object;
  model_summary: object;
  summary: object;
  findings: object[];
  normalization_preview: object;
  not_available: boolean (optional);
  error: string (optional);
}

`easyeda_schematic_batch_write`

Profile: core | Risk Level: high

Apply up to 200 validated schematic create, modify, pin no-connect, and delete operations in one snapshot-backed transaction. Any failure rolls the whole transaction back. Delete is limited to safely recreatable drawing primitives.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes
`transactionId`	`string (optional)`	No
`operations`	`object	object	object
`atomic`	`'true'`	Yes
`dryRun`	`boolean`	Yes
`confirmWrite`	`'true'`	Yes

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  atomic: 'true';
  dry_run: boolean;
  internally_managed_transaction: boolean;
  transaction_id: string (optional);
  transaction_state: 'active' | 'validating' | 'validated' | 'committed' | 'rolling-back' | 'rolled-back' | 'failed' | 'expired' (optional);
  committed: boolean;
  rolled_back: boolean;
  results: object[];
  error_code: string (optional);
  error: string (optional);
  rollback_error: string (optional);
}

`easyeda_schematic_capture_full_page`

Profile: pro | Risk Level: low

Read the active schematic sheet geometry, clear selection overlays, frame the complete sheet including its border and title block, and return a deterministic PNG plus the sheet-to-image coordinate transform. Refuses guessed geometry unless explicitly allowed.

Input Parameters

Parameter	Type	Required
`projectId`	`string`	Yes
`tabId`	`string (optional)`	No
`padding`	`number`	Yes
`allowInferredA4`	`boolean`	Yes

Output Format

Returns a JSON object matching the schema:

{
  captured: boolean;
  mime_type: string (optional);
  file_name: string (optional);
  byte_length: number (optional);
  image_base64: string (optional);
  not_available: boolean (optional);
  error: string (optional);
  project_id: string;
  sheet: object (optional);
  viewport: object (optional);
  image_dimensions: object (optional);
  sheet_to_image_transform: object (optional);
  selection_overlays_removed: boolean (optional);
  deterministic_viewport: boolean;
  warnings: string[];
}

`easyeda_schematic_check_collisions`

Profile: core | Risk Level: low

Scan every component's real pin coordinates and report any (x,y) shared by two or more components — a silent-short risk the native NET_COLLISION guard misses for never-wired pins. Run after manual placement outside easyeda_workflow_* tools (which reconcile this automatically).

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes	The project/schematic ID

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  collisions: object[];
  collision_count: number;
  scan_complete: boolean;
  scan_diagnostics: object (optional);
  success: boolean;
  error: string (optional);
}

`easyeda_schematic_check_placement`

Profile: pro | Risk Level: low

Validate a candidate placement (rendered bounds, clearances, conflicts, deterministic alternatives) or -- when x/y are omitted -- search for a safe region of the given size, against real title-block/page-border/existing-primitive constraints. Read-only, no writes.

Input Parameters

Parameter	Type	Required
`projectId`	`string`	Yes
`candidate`	`object`	Yes
`reservedRegions`	`object[] (optional)`	No
`minimumClearance`	`number (optional)`	No
`excludePrimitiveIds`	`string[] (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  mode: 'check-placement' | 'select-safe-region';
  accepted: boolean (optional);
  proposed: object (optional);
  combinedBounds: object (optional);
  clearances: object[] (optional);
  conflicts: object[] (optional);
  suggestedAlternatives: object[] (optional);
  failure: object (optional);
  feasible: boolean (optional);
  preference: string (optional);
  candidate: object (optional);
  check: object (optional);
  rationale: string[] (optional);
}

`easyeda_schematic_component_pins`

Profile: core | Risk Level: low

Get exact pin primitive IDs, numbers, names, coordinates, native no-connect state, and pinType for a schematic component by its primitive ID. pinType is EasyEDA's own symbol-library field and is unreliably authored (often "Undefined" even on real ICs) — treat it as a weak hint, not ground truth.

Input Parameters

Parameter	Type	Required	Description
`primitiveId`	`string`	Yes

Output Format

Returns a JSON object matching the schema:

{
  primitiveId: string;
  pins: object[];
  success: boolean;
  error: string (optional);
}

`easyeda_schematic_components`

Profile: core | Risk Level: low

List schematic components: primitiveId, reference, value, footprint, x/y/rotation, and device identity for cloning — deviceUuid+deviceLibraryUuid (a place_component deviceItem in this project), deviceName, symbolName, lcsc, manufacturerId.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes	The project/schematic ID
`limit`	`number`	Yes
`offset`	`number`	Yes

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  components: object[];
  total: number;
  read_consistency: object (optional);
  not_available: boolean (optional);
  error: string (optional);
}

`easyeda_schematic_connect_pin_to_net`

Profile: core | Risk Level: medium

Create real EasyEDA connectivity for a pin: draws a short wire stub from its exact coordinate, tagged with netName. Same-netName wires merge globally, so this joins the pin to everything else on that net — visible to ERC, ratsnest, and autorouting.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes	The project/schematic ID
`primitiveId`	`string`	Yes	The primitive ID of the component
`pinNumber`	`string`	Yes	The pin number or pin name on the component (e.g. "1", "VCC", "GND")
`netName`	`string`	Yes	The net name to connect the pin to (e.g. VCC, GND, DATA0)
`stubLength`	`number (optional)`	No	Length of the wire stub drawn outward from the pin. Defaults to 10.
`confirmWrite`	`'true'`	Yes	Must be the literal boolean true (not the string "true") to allow this write.

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  real: boolean(optional);
  created_primitive_id: string(optional);
  endpoint: object(optional);
  connection: object(optional);
  error: string(optional);
}

`easyeda_schematic_connect_pins_by_net`

Profile: core | Risk Level: medium

Bulk variant of connect_pin_to_net: draws a real wire stub from each pin, tagged with netName, so all listed pins (and anything else already on that net) merge into one net. Visible to ERC, ratsnest, and autorouting. A pin that fails (e.g. collision) is reported in failures rather than aborting the batch.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes	The project/schematic ID
`netName`	`string`	Yes	The net name to assign pins to
`pins`	`object[]`	Yes	List of component pins to connect to the net
`stubLength`	`number (optional)`	No	Length of the wire stub drawn outward from each pin. Defaults to 10.
`confirmWrite`	`'true'`	Yes	Must be the literal boolean true (not the string "true") to allow this write.

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  real: boolean (optional);
  created_primitive_ids: string[] (optional);
  failures: object[] (optional);
  connections: object[] (optional);
  count: number;
  error: string (optional);
}

`easyeda_schematic_connectivity_fingerprint`

Profile: pro | Risk Level: low

Compute a deterministic connectivity fingerprint (pin/net membership, wire endpoints, labels/ports, no-connects) from the live schematic. Pass the hash as beforeFingerprint/afterFingerprint to easyeda_schematic_layout_qa to prove a cosmetic move left connectivity unchanged.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes

Output Format

Returns a JSON object matching the schema:

{
  projectId: string;
  schemaVersion: '1';
  hash: string;
  modelHash: string;
  componentCount: number;
  netCount: number;
  normalized: object;
  diagnosticCount: number;
}

`easyeda_schematic_create_net_flag`

Profile: core | Risk Level: medium

Create a named net flag/label. With identification (Power/Ground/AnalogGround/ProtectGround) it places a power-flag symbol binding to a coincident pin (use for VCC/GND). Without it, a generic net label — cosmetic only; connect pins with add_wire stubs sharing one netName.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes	The project/schematic ID
`netName`	`string`	Yes	The net name to assign (e.g. VCC, GND, TEST_NET)
`x`	`number`	Yes	X coordinate on the schematic canvas
`y`	`number`	Yes	Y coordinate on the schematic canvas
`rotation`	`number (optional)`	No	Rotation in degrees (0, 90, 180, 270)
`identification`	`'Power'	'Ground'	'AnalogGround'
`confirmWrite`	`'true'`	Yes	Must be the literal boolean true (not the string "true") to allow this write.

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  netFlag: object(optional);
  error: string(optional);
}

`easyeda_schematic_create_net_port`

Profile: core | Risk Level: medium

Place a hierarchical net port (off-sheet connector) on the schematic. Net ports create named connections that span multiple schematic sheets, appearing as real SCH_Net entries in the netlist.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes	The project/schematic ID
`netName`	`string`	Yes	The net name for the port (e.g. VCC, GND, DATA_BUS)
`x`	`number`	Yes	X coordinate on the schematic canvas
`y`	`number`	Yes	Y coordinate on the schematic canvas
`portType`	`'input'	'output'	'bidirectional'
`rotation`	`number (optional)`	No	Rotation in degrees (0, 90, 180, 270)
`confirmWrite`	`'true'`	Yes	Must be the literal boolean true (not the string "true") to allow this write.

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  netPort: object(optional);
  error: string(optional);
}

`easyeda_schematic_delete_primitive`

Profile: core | Risk Level: medium

Delete components, wires, or other drawing objects from the schematic by their primitive UUIDs.

Input Parameters

Parameter	Type	Required	Description
`primitiveIds`	`string[]`	Yes
`confirmWrite`	`'true'`	Yes	Must be the literal boolean true (not the string "true") to allow this write.

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  error: string(optional);
}

`easyeda_schematic_layout_autofix`

Profile: pro | Risk Level: low

Detect title-block overlap, page-boundary overflow, and component-overlap violations from real rendered bounds, and propose cosmetic-only moves that resolve them. Read-only preview only (requiresConfirmWrite=true, no writes) -- confirmWrite apply with connectivity-fingerprint rollback is tracked separately (#273).

Input Parameters

Parameter	Type	Required
`projectId`	`string`	Yes
`allowlist`	`object (optional)`	No
`hardKeepouts`	`object[] (optional)`	No
`reservedRegions`	`object[] (optional)`	No
`minimumClearance`	`number (optional)`	No
`maxMoves`	`number (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  projectId: string;
  mode: 'preview';
  requiresConfirmWrite: 'true';
  violations: object[];
  moves: object[];
  report: object;
  allowlist: object;
  primitiveCount: number;
  unavailablePrimitiveIds: string[];
}

`easyeda_schematic_layout_autofix_apply`

Profile: pro | Risk Level: high

Apply the layout-autofix cosmetic moves in a snapshot-backed transaction, re-verifying a connectivity fingerprint after every write batch. Any unintended electrical change or write failure rolls the transaction back and is reported, never thrown. dryRun:true previews only.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes
`allowlist`	`object (optional)`	No
`hardKeepouts`	`object[] (optional)`	No
`reservedRegions`	`object[] (optional)`	No
`minimumClearance`	`number (optional)`	No
`maxMoves`	`number (optional)`	No
`batchSize`	`number (optional)`	No
`dryRun`	`boolean`	Yes
`confirmWrite`	`'true'`	Yes	Must be the literal boolean true (not the string "true") to allow this write.

Output Format

Returns a JSON object matching the schema:

{
  projectId: string;
  dryRun: boolean;
  mode: 'preview';
  requiresConfirmWrite: 'true';
  violations: object[];
  moves: object[];
  allowlist: object;
  primitiveCount: number;
  unavailablePrimitiveIds: string[];
  applied: boolean;
  batchesVerified: number;
  actualStateReadAfterFailure: boolean;
  beforeFingerprintHash: string (optional);
  afterFingerprintHash: string (optional);
  connectivityDiff: object (optional);
  report: object;
  transactionId: string (optional);
  transactionState: 'active' | 'validating' | 'validated' | 'committed' | 'rolling-back' | 'rolled-back' | 'failed' | 'expired' (optional);
  errorCode: string (optional);
  error: string (optional);
}

`easyeda_schematic_layout_qa`

Profile: pro | Risk Level: low

Run a normalized post-write QA pass combining runtime DRC/ERC, expected component/pin topology, rendered primitive bounds, title-block and page constraints, wiring/grouping checks, and connectivity fingerprints, with optional full-page visual evidence. Critical geometry or connectivity findings always block commit.

Input Parameters

Parameter	Type	Required
`projectId`	`string`	Yes
`expectedComponentRefs`	`string[] (optional)`	No
`expectedNetNames`	`string[] (optional)`	No
`expectedPinMappings`	`object[] (optional)`	No
`relationships`	`object[] (optional)`	No
`connectivity`	`object (optional)`	No
`thresholds`	`object (optional)`	No
`visualFindings`	`object[] (optional)`	No
`runVisualCapture`	`boolean`	Yes

Output Format

Returns a JSON object matching the schema:

{
  projectId: string;
  status: 'pass' | 'fail' | 'inconclusive';
  passed: boolean;
  commitBlocked: boolean;
  issues: object[];
  issueCounts: object;
  scores: object;
  evidence: object;
  summary: object;
}

`easyeda_schematic_modify_primitive`

Profile: core | Risk Level: medium

Safely modify a schematic primitive while preserving omitted fields. With transactionId and projectId, capture before/after snapshots and automatically restore the prior state if the write or post-write read fails. Component moves keep connected wires attached.

Input Parameters

Parameter	Type	Required	Description
`primitiveId`	`string`	Yes
`property`	`Record<string, any>`	Yes
`projectId`	`string (optional)`	No	Required when transactionId is supplied; must match the transaction document.
`transactionId`	`string (optional)`	No	Optional snapshot-backed project transaction ID.
`confirmWrite`	`'true'`	Yes	Must be the literal boolean true (not the string "true") to allow this write.

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  result: any(optional);
  transaction: object(optional);
  error_code: string(optional);
  error: string(optional);
  details: Record<string, any>(optional);
}

`easyeda_schematic_net_detail`

Profile: core | Risk Level: low

Get full details for a specific net in the schematic including all connected pins and components.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes	The project/schematic ID
`netName`	`string`	Yes

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  net_name: string;
  node_count: number;
  nodes: object[];
  not_available: boolean (optional);
  timed_out: boolean (optional);
  error_code: string (optional);
  timeout_stage: string (optional);
  timeout_component: string (optional);
  error: string (optional);
}

`easyeda_schematic_nets`

Profile: core | Risk Level: low

List all nets in the schematic with their node connections.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes	The project/schematic ID

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  nets: object[];
  total: number;
  read_consistency: object (optional);
  not_available: boolean (optional);
  error: string (optional);
}

`easyeda_schematic_place_component`

Profile: core | Risk Level: medium

Place a library component/device on the active schematic sheet. Auto-assigns the next free designator ("R?" → "R1") — check the returned value, duplicate "R?" merge into one node. On a timeout error, auto-reconciles against the sheet before reporting failure (see reconciled/unconfirmed) — do not blindly retry.

Input Parameters

Parameter	Type	Required	Description
`deviceItem`	`object`	Yes
`x`	`number`	Yes
`y`	`number`	Yes
`subPartName`	`string (optional)`	No
`rotation`	`number (optional)`	No
`mirror`	`boolean (optional)`	No
`addIntoBom`	`boolean (optional)`	No
`addIntoPcb`	`boolean (optional)`	No
`dryRun`	`boolean (optional)`	No
`verifyAfterWrite`	`boolean (optional)`	No
`checkPlacementCollision`	`boolean (optional)`	No
`collisionRadius`	`number (optional)`	No
`confirmWrite`	`'true'`	Yes	Must be the literal boolean true (not the string "true") to allow this write.

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  component: any(optional);
  dry_run: boolean(optional);
  placement_guard: any(optional);
  verification: any(optional);
  reconciled: boolean(optional);
  unconfirmed: boolean(optional);
  warning: string(optional);
  error: string(optional);
}

`easyeda_schematic_plan_layout`

Profile: pro | Risk Level: low

Deterministically plan functional-block placement (reserved rectangles, support space, grid-aligned coordinates, occupancy map, A3 fallback, score) from real sheet/primitive geometry -- no writes. Caller supplies roles/blockId/parentId; other primitives read as occupied regions, never overwritten.

Input Parameters

Parameter	Type	Required
`projectId`	`string`	Yes
`components`	`object[]`	Yes
`allowA3Fallback`	`boolean`	Yes
`hardKeepouts`	`object[] (optional)`	No
`constraints`	`object (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  feasible: boolean;
  deterministic: 'true';
  layoutHash: string;
  selectedSheet: object;
  blockReservations: object[];
  supportReservations: object[];
  placements: object[];
  placementOrder: string[];
  occupancyMap: object[];
  conflicts: object[];
  pageSuitability: object;
  score: object;
}

`easyeda_schematic_plan_safe_region`

Profile: core | Risk Level: low

Compute a safe schematic drawing region before placing components. Uses live sheet info when available, assumes EasyEDA bottom-left coordinates, reserves the default lower-right title-block keep-out, and returns an anchor/bounds plan that avoids title-block overlap.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string (optional)`	No
`contentWidth`	`number`	Yes	Estimated width of the planned circuit block in EasyEDA coordinates
`contentHeight`	`number`	Yes	Estimated height of the planned circuit block in EasyEDA coordinates
`preferredRegion`	`'upper-left'	'upper-center'	'upper-right'
`margin`	`number (optional)`	No
`titleBlockKeepout`	`object (optional)`	No	Optional explicit title-block keep-out rectangle when the sheet template is known

Output Format

Returns a JSON object matching the schema:

{
  project_id: string (optional);
  blocked: boolean;
  preferred_region: string;
  sheet: object;
  usable_bounds: object;
  requested_bounds: object;
  bounds: object;
  anchor: object;
  keepouts: object[];
  warnings: string[];
  issues: object[];
  not_available: boolean (optional);
  error: string (optional);
}

`easyeda_schematic_preview_imported_normalization`

Profile: core | Risk Level: low

Read the live schematic and produce a deterministic, read-only normalization plan with a stable plan ID, model hash, proposed net-name/reference/metadata operations, validation gates, warnings, and blockers. This tool never writes to EasyEDA.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes	The project/schematic ID to preview
`componentLimit`	`number`	Yes
`normalizeNetNames`	`boolean`	Yes
`annotateReferences`	`boolean`	Yes
`resolveMetadataExpressions`	`boolean`	Yes
`componentOverrides`	`object[]`	Yes

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  source: object;
  plan: object;
  not_available: boolean(optional);
  error: string(optional);
}

`easyeda_schematic_primitive_bounds`

Profile: pro | Risk Level: low

Read real rendered (sheet-space, rotation-aware) component bounding boxes from the live bridge, batched in one call. Origin is not a collision bound -- use combinedBounds for overlap/page/title-block checks. Reference/value text is not independently addressable here and reports not_available.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes
`primitiveIds`	`string[] (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  items: object[];
  availableCount: number;
  notAvailableCount: number;
  units: string;
  coordinateOrigins: object[];
}

`easyeda_schematic_search_device`

Profile: core | Risk Level: low

Search for schematic symbols/devices in the EasyEDA library by keywords. Full results carry the library's complete metadata object per device; pass minimal:true to get back only uuid/libraryUuid/name/pin_count/symbol_type when that is all you need.

Input Parameters

Parameter	Type	Required	Description
`key`	`string`	Yes	Search keyword(s), matched against device name/description in the library
`libraryUuid`	`string (optional)`	No
`classification`	`string	string[] (optional)`	No
`symbolType`	`string (optional)`	No
`itemsOfPage`	`number`	Yes
`page`	`number`	Yes
`minimal`	`boolean (optional)`	No	When true, return only uuid/libraryUuid/name/pin_count/symbol_type per device instead of the full library metadata object — use this when the goal is just picking a deviceItem for place_component, to avoid paying for fields you will not read.

Output Format

Returns a JSON object matching the schema:

{
  devices: object[];
  total: number;
  provider_tier: 'local_library' (optional);
  not_available: boolean (optional);
  error: string (optional);
}

`easyeda_schematic_set_pin_no_connect`

Profile: core | Risk Level: medium

Set or clear EasyEDA Pro's native No Connect marker on one exact component pin. This changes the component pin noConnected state; it does not create a net, label, power flag, or short-circuit flag. The bridge rejects missing/ambiguous pins and verifies the native readback after the write.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes	The project/schematic ID
`primitiveId`	`string`	Yes	The component primitive ID
`pinNumber`	`string`	Yes	The exact component pin number
`noConnected`	`boolean`	Yes	true places the native No Connect marker; false removes it
`confirmWrite`	`'true'`	Yes	Must be the literal boolean true (not the string "true") to allow this write.

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  project_id: string;
  component_primitive_id: string;
  pin_primitive_id: string(optional);
  pin_number: string;
  previous_no_connected: boolean(optional);
  no_connected: boolean(optional);
  changed: boolean(optional);
  verified: boolean(optional);
  error_code: string(optional);
  error: string(optional);
}

`easyeda_schematic_set_title_block`

Profile: core | Risk Level: medium

Update schematic title block text fields (Company, Version, Drawn, Reviewed, Page Size). Only these 5 are exposed — writing Symbol/Border/Device/etc once corrupted a real title block; those are read-only natively and must be fixed via the EasyEDA Pro UI.

Input Parameters

Parameter	Type	Required	Description
`fields`	`Record<string, object>`	Yes	Map of title block field name to the sub-fields to change, e.g. { "Company": { "value": "ACME", "showValue": true } }
`showTitleBlock`	`boolean (optional)`	No	Show/hide the whole title block
`confirmWrite`	`'true'`	Yes	Must be the literal boolean true (not the string "true") to allow this write.

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  error: string(optional);
}

`easyeda_schematic_sheet_info`

Profile: core | Risk Level: low

Return read-only active schematic sheet metadata including page size, frame, origin, and grid hints for safer component placement.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  project_id: string(optional);
  sheet: any(optional);
  page_size: object(optional);
  frame: any(optional);
  origin: any(optional);
  grid: any(optional);
  raw: any(optional);
  metadata_source: string(optional);
  focused_document: any(optional);
  diagnostics: any(optional);
  geometry_available: boolean;
  warning: string(optional);
  not_available: boolean(optional);
  error_code: string(optional);
  error: string(optional);
}

`easyeda_schematic_sync_to_pcb`

Profile: core | Risk Level: medium

Request a schematic-to-PCB sync (SCH_Document.importChanges). CAUTION (live-verified): opens a confirmation dialog in EasyEDA Pro's UI a HUMAN must approve — success here only means the request was sent, not that components appeared. Ask the user to approve the dialog, then verify with pcb_components.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string (optional)`	No
`confirmWrite`	`'true'`	Yes	Must be the literal boolean true (not the string "true") to allow this write.

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  requested: boolean(optional);
  note: string(optional);
  error: string(optional);
}

`easyeda_schematic_validate_netlist`

Profile: core | Risk Level: low

Validate inferred nets and floating pins, then cross-check native ERC. A pin is excluded from floating inference only when native noConnected readback is boolean true; unavailable or malformed state stays visible. valid requires clean inference and zero native errors.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes	The project/schematic ID
`includeWireCheck`	`boolean`	Yes	When true, also check for graphical wires without netlist connectivity

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  netlist: object[];
  total_nets: number;
  floating_pins: object[];
  wires_without_netlist: object[] (optional);
  native_erc: object (optional);
  valid: boolean;
  warnings: string[];
  not_available: boolean (optional);
  error: string (optional);
}

`easyeda_schematic_verify_write`

Profile: core | Risk Level: low

Read back schematic state after an agent-authored write. Returns component-count delta evidence and optional netlist validation so agents can confirm a placement or connection before continuing.

Input Parameters

Parameter	Type	Required
`projectId`	`string (optional)`	No
`netName`	`string (optional)`	No
`beforeComponentCount`	`number (optional)`	No
`expectedComponentCountDelta`	`number (optional)`	No
`includeWireCheck`	`boolean (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  project_id: string (optional);
  net_name: string (optional);
  components_available: boolean;
  component_count: number (optional);
  component_count_delta: number (optional);
  component_delta_matches: boolean (optional);
  netlist_available: boolean;
  netlist_validation: any (optional);
  warnings: string[];
  error: string (optional);
}

`easyeda_schematic_wires`

Profile: core | Risk Level: low

List wire segments: primitiveId, line coordinates, net name, color, style. Page with offset (check total) past the 50-wire-per-call cap. primitiveId is required by delete_primitive/modify_primitive — schematic_nets alone cannot resolve a wire ID.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes	The project/schematic ID
`limit`	`number`	Yes
`offset`	`number`	Yes

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  wires: object[];
  total: number;
  read_consistency: object (optional);
  not_available: boolean (optional);
  error: string (optional);
}

`easyeda_semantic_erc_auto`

Profile: core | Risk Level: low

Extract nets/devices/pins from the LIVE schematic and run semantic ERC — no hand-authored netlist needed. Net/pin electrical types are INFERRED from naming conventions, not verified — treat findings as a first-pass signal, not a substitute for semantic_erc_validate.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  passed: boolean;
  error_count: number;
  warning_count: number;
  total_issues: number;
  errors: object[];
  warnings: object[];
  inferred_net_count: number;
  inferred_device_count: number;
  not_available: boolean (optional);
  error: string (optional);
}

`easyeda_semantic_erc_validate`

Profile: core | Risk Level: medium

Run semantic electrical-rule validation over a netlist with pin electrical types to detect output contention, floating inputs, power conflicts, missing power pins, missing decoupling, and voltage-domain mismatches.

Input Parameters

Parameter	Type	Required
`projectId`	`string (optional)`	No
`nets`	`object[]`	Yes
`devices`	`object[] (optional)`	No
`interfaces`	`object[] (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  project_id: string;
  passed: boolean;
  error_count: number;
  warning_count: number;
  total_issues: number;
  errors: object[];
  warnings: object[];
}

`easyeda_simulate_operating_point`

Profile: pro | Risk Level: low

Translate a typed circuit description into a SPICE deck and run an offline ngspice operating-point (.op) simulation, optionally checking rail node voltages against a spec. Read-only, local-only. Reports a capability gap rather than failing when ngspice is absent.

Input Parameters

Parameter	Type	Required
`circuit`	`object`	Yes
`railSpecs`	`object[] (optional)`	No
`timeoutMs`	`number (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  available: boolean;
  ngspice_version: string (optional);
  node_voltages: Record<string, number> (optional);
  rail_verdicts: object[] (optional);
  not_available: boolean (optional);
  error: string (optional);
}

`easyeda_simulate_transient`

Profile: pro | Risk Level: low

Translate a typed circuit description into a SPICE deck and run an offline ngspice transient (.tran) simulation, optionally checking the final rail voltage against a spec. Read-only, local-only. Reports a capability gap rather than failing when ngspice is absent.

Input Parameters

Parameter	Type	Required
`circuit`	`object`	Yes
`stepSeconds`	`number`	Yes
`stopTimeSeconds`	`number`	Yes
`railSpecs`	`object[] (optional)`	No
`timeoutMs`	`number (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  available: boolean;
  ngspice_version: string (optional);
  samples: object[] (optional);
  truncated: boolean (optional);
  rail_verdicts: object[] (optional);
  not_available: boolean (optional);
  error: string (optional);
}

`easyeda_wire_probe`

Profile: dev | Risk Level: low

Inspect live schematic wire objects, including line coordinates, net names, methods, and state getter values, to validate EasyEDA runtime mappings.

Input Parameters

Parameter	Type	Required	Description
`limit`	`number`	Yes

Output Format

Returns a JSON object matching the schema:

{
  total: number;
  samples: any[];
  not_available: boolean (optional);
  error: string (optional);
}

`easyeda_workflow_connector_breakout`

Profile: pro | Risk Level: medium

Place a connector, wire each declared pin to its net, and create a net port for each net so the breakout is accessible off-sheet — all as a single atomic transaction (confirmWrite required).

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes
`mode`	`'preview'	'apply'`	Yes
`anchor`	`object`	Yes
`netPortAnchor`	`object (optional)`	No
`connectorRef`	`string`	Yes
`connector`	`object`	Yes
`rotation`	`number (optional)`	No
`mirror`	`boolean (optional)`	No
`subPartName`	`string (optional)`	No
`pins`	`object[]`	Yes
`confirmWrite`	`boolean (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  project_id: string;
  transaction_id: string;
  mode: string;
  applied: boolean;
  blocked: boolean;
  rolled_back: boolean;
  placements: object[];
  operations: object[];
  apply_results: object[] (optional);
  issues: object[];
  summary: string;
  rollback_notes: string[];
  error: string (optional);
}

`easyeda_workflow_decouple_ic`

Profile: pro | Risk Level: medium

Place one decoupling capacitor per declared IC power pin and wire each to the pin's net and ground, in a single atomic transaction. Cites design-rules decoupling guidance (rule-of-thumb, not datasheet-specific) alongside the plan (confirmWrite required).

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes
`mode`	`'preview'	'apply'`	Yes
`anchor`	`object`	Yes
`spacing`	`number (optional)`	No
`groundNetName`	`string`	Yes
`icPowerPins`	`object[]`	Yes
`capacitor`	`object`	Yes
`capacitorPins`	`object`	Yes
`decouplingCategory`	`'digital-logic'	'mcu'	'analog'
`confirmWrite`	`boolean (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  project_id: string;
  transaction_id: string;
  mode: string;
  applied: boolean;
  blocked: boolean;
  rolled_back: boolean;
  placements: object[];
  operations: object[];
  apply_results: object[] (optional);
  issues: object[];
  summary: string;
  rollback_notes: string[];
  error: string (optional);
  decoupling_guidance: object (optional);
}

`easyeda_workflow_layout_section`

Profile: pro | Risk Level: medium

Compute and create a section rectangle + title sized from the real pin extents of the given already-placed components (or replace an existing rectangle/title pair). Reports overlap with other rectangles and page-size overflow as warnings; never resizes the page.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes
`mode`	`'preview'	'apply'`	Yes
`componentPrimitiveIds`	`string[]`	Yes	Components belonging to this section — their pin extents define the box.
`title`	`string`	Yes
`margin`	`number`	Yes	Padding between the component cluster and the box edge.
`componentPadding`	`number`	Yes	Per-component padding around its pins, approximating body extent beyond them.
`titleGap`	`number`	Yes	Gap between the title and the box top edge.
`titleFontSize`	`number`	Yes
`color`	`string`	Yes
`replaceRectanglePrimitiveId`	`string (optional)`	No	An existing section rectangle to delete and replace with the newly-sized one.
`replaceTitlePrimitiveId`	`string (optional)`	No	An existing section title to delete and replace with the repositioned one.
`confirmWrite`	`boolean (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  applied: boolean;
  bounds: object (optional);
  overlapping_rectangles: object[];
  page_frame_warning: string (optional);
  rectangle_primitive_id: string (optional);
  title_primitive_id: string (optional);
  deleted_primitive_ids: string[];
  error: string (optional);
}

`easyeda_workflow_led_blinker`

Profile: pro | Risk Level: medium

Create a deterministic LED blinker workflow: a switch, current-limiting resistor, and indicator LED. Uses safe sheet-region planning, left-to-right layout, generic wire stubs, and optional post-write QA. Caller supplies resolved device items (confirmWrite required); simplest circuit for validating the MCP pipeline.

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes
`mode`	`'preview'	'apply'`	Yes
`devices`	`object`	Yes
`anchor`	`object (optional)`	No
`preferredRegion`	`'upper-left'	'upper-center'	'upper-right'
`margin`	`number (optional)`	No
`createNetPorts`	`boolean`	Yes
`createWireStubs`	`boolean`	Yes
`refs`	`object (optional)`	No
`nets`	`object (optional)`	No
`values`	`object (optional)`	No
`pinMaps`	`object (optional)`	No
`runPostWriteQa`	`boolean`	Yes
`confirmWrite`	`boolean (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  project_id: string;
  transaction_id: string;
  mode: string;
  applied: boolean;
  blocked: boolean;
  rolled_back: boolean;
  placements: object[];
  operations: object[];
  apply_results: object[] (optional);
  issues: object[];
  summary: string;
  rollback_notes: string[];
  error: string (optional);
  safe_region: object;
  design: object;
  post_write_qa: object (optional);
}

`easyeda_workflow_ne555_astable`

Profile: pro | Risk Level: medium

Create a deterministic NE555 astable LED flasher workflow using safe sheet-region planning, component-level layout offsets, explicit pin-to-net connectivity, and optional post-write QA. Caller supplies already-resolved EasyEDA device items; this tool does not guess catalog parts (confirmWrite required).

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes
`mode`	`'preview'	'apply'`	Yes
`devices`	`object`	Yes
`anchor`	`object (optional)`	No
`preferredRegion`	`'upper-left'	'upper-center'	'upper-right'
`margin`	`number (optional)`	No
`createNetPorts`	`boolean`	Yes
`createWireStubs`	`boolean`	Yes
`refs`	`object (optional)`	No
`nets`	`object (optional)`	No
`values`	`object (optional)`	No
`pinMaps`	`object (optional)`	No
`runPostWriteQa`	`boolean`	Yes
`confirmWrite`	`boolean (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  project_id: string;
  transaction_id: string;
  mode: string;
  applied: boolean;
  blocked: boolean;
  rolled_back: boolean;
  placements: object[];
  operations: object[];
  apply_results: object[] (optional);
  issues: object[];
  summary: string;
  rollback_notes: string[];
  error: string (optional);
  safe_region: object;
  design: object;
  post_write_qa: object (optional);
}

`easyeda_workflow_place_block`

Profile: pro | Risk Level: medium

Place a group of components, wire their pin-to-net connections (new and/or pre-existing components), and create net ports for block-external nets — all as a single atomic transaction with rollback on partial failure (confirmWrite required).

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes
`mode`	`'preview'	'apply'`	Yes
`anchor`	`object`	Yes
`spacing`	`number (optional)`	No
`blockName`	`string (optional)`	No
`components`	`object[]`	Yes
`existingComponents`	`object[]`	Yes
`netPorts`	`object[]`	Yes
`netPortAnchor`	`object (optional)`	No
`wires`	`object[]`	Yes
`confirmWrite`	`boolean (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  project_id: string;
  transaction_id: string;
  mode: string;
  applied: boolean;
  blocked: boolean;
  rolled_back: boolean;
  placements: object[];
  operations: object[];
  apply_results: object[] (optional);
  issues: object[];
  summary: string;
  rollback_notes: string[];
  error: string (optional);
}

`easyeda_workflow_power_rail`

Profile: pro | Risk Level: medium

Place a regulator and its supporting passives and wire them to input/output/ground nets in a single atomic transaction, instead of one primitive call per component. Caller supplies already-resolved device items and pin connections; this tool does not select parts (confirmWrite required).

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes
`mode`	`'preview'	'apply'`	Yes
`anchor`	`object`	Yes
`spacing`	`number (optional)`	No
`groundNetName`	`string`	Yes
`inputNetName`	`string`	Yes
`outputNetName`	`string`	Yes
`components`	`object[]`	Yes
`verifyRail`	`object (optional)`	No
`confirmWrite`	`boolean (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  project_id: string;
  transaction_id: string;
  mode: string;
  applied: boolean;
  blocked: boolean;
  rolled_back: boolean;
  placements: object[];
  operations: object[];
  apply_results: object[] (optional);
  issues: object[];
  summary: string;
  rollback_notes: string[];
  error: string (optional);
  verification: object (optional);
}

`easyeda_workflow_rp2040_servo_module`

Profile: pro | Risk Level: medium

Plan or apply an RP2040 servo-module scaffold: 56 BOM parts in seven visible rollback-backed sections with deterministic titles and completeness diagnostics. Exact pin-to-net wiring stays intentionally absent until later block netlists supply it (confirmWrite required).

Input Parameters

Parameter	Type	Required	Description
`projectId`	`string`	Yes
`mode`	`'preview'	'apply'`	Yes
`devices`	`object`	Yes
`anchor`	`object (optional)`	No
`preferredRegion`	`'upper-left'	'upper-center'	'upper-right'
`margin`	`number (optional)`	No
`confirmWrite`	`boolean (optional)`	No

Output Format

Returns a JSON object matching the schema:

{
  success: boolean;
  project_id: string;
  transaction_id: string;
  mode: string;
  applied: boolean;
  blocked: boolean;
  rolled_back: boolean;
  placements: object[];
  operations: object[];
  apply_results: object[] (optional);
  issues: object[];
  summary: string;
  rollback_notes: string[];
  error: string (optional);
  safe_region: object;
  scaffold: object;
}

MCP Tools Reference ​

Summary of Tools ​

easyeda_api_call ​

Input Parameters ​

Output Format ​

easyeda_api_inventory ​

Input Parameters ​

Output Format ​

easyeda_board_dimensions ​

Input Parameters ​

Output Format ​

easyeda_board_features ​

Input Parameters ​

Output Format ​

easyeda_board_layers ​

Input Parameters ​

Output Format ​

easyeda_board_stackup ​

Input Parameters ​

Output Format ​

easyeda_bom_export ​

Input Parameters ​

Output Format ​

easyeda_bom_generate ​

Input Parameters ​

Output Format ​

easyeda_bom_quality_report ​

Input Parameters ​

Output Format ​

easyeda_bom_sourcing ​

Input Parameters ​

Output Format ​

easyeda_bom_validate ​

Input Parameters ​

Output Format ​

easyeda_bridge_probe_methods ​

Input Parameters ​

Output Format ​

easyeda_bridge_status ​

Input Parameters ​

Output Format ​

easyeda_canvas_capture ​

Input Parameters ​

Output Format ​

easyeda_canvas_capture_region ​

Input Parameters ​

Output Format ​

easyeda_canvas_locate ​

Input Parameters ​

Output Format ​

easyeda_catalog_list ​

Input Parameters ​

Output Format ​

easyeda_catalog_verify_device ​

Input Parameters ​

Output Format ​

easyeda_component_probe ​

Input Parameters ​

Output Format ​

easyeda_design_rules_lookup ​

Input Parameters ​

Output Format ​

easyeda_drc_run ​

Input Parameters ​

Output Format ​

easyeda_erc_run ​

Input Parameters ​

Output Format ​

easyeda_export_gerbers ​

Input Parameters ​

Output Format ​

easyeda_export_netlist ​

Input Parameters ​

Output Format ​

easyeda_export_pdf ​

Input Parameters ​

Output Format ​

easyeda_export_pick_place ​

Input Parameters ​

Output Format ​

MCP Tools Reference

Summary of Tools

`easyeda_api_call`

Input Parameters

Output Format

`easyeda_api_inventory`

Input Parameters

Output Format

`easyeda_board_dimensions`

Input Parameters

Output Format

`easyeda_board_features`

Input Parameters

Output Format

`easyeda_board_layers`

Input Parameters

Output Format

`easyeda_board_stackup`

Input Parameters

Output Format

`easyeda_bom_export`

Input Parameters

Output Format

`easyeda_bom_generate`

Input Parameters

Output Format

`easyeda_bom_quality_report`

Input Parameters

Output Format

`easyeda_bom_sourcing`

Input Parameters

Output Format

`easyeda_bom_validate`

Input Parameters

Output Format

`easyeda_bridge_probe_methods`

Input Parameters

Output Format

`easyeda_bridge_status`

Input Parameters

Output Format

`easyeda_canvas_capture`

Input Parameters

Output Format

`easyeda_canvas_capture_region`

Input Parameters

Output Format

`easyeda_canvas_locate`

Input Parameters

Output Format

`easyeda_catalog_list`

Input Parameters

Output Format

`easyeda_catalog_verify_device`

Input Parameters

Output Format

`easyeda_component_probe`

Input Parameters

Output Format

`easyeda_design_rules_lookup`

Input Parameters

Output Format

`easyeda_drc_run`

Input Parameters

Output Format

`easyeda_erc_run`

Input Parameters

Output Format

`easyeda_export_gerbers`

Input Parameters

Output Format

`easyeda_export_netlist`

Input Parameters

Output Format

`easyeda_export_pdf`

Input Parameters

Output Format

`easyeda_export_pick_place`

Input Parameters

Output Format