Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

CircuitAgent

PYPI · CIRCUIT-AGENT-CLIENT

AI hardware synthesis: CircuitBlocks DSL, live LCSC parts, industrial DFX audit, stdio MCP server.

−15 this week 79 Trust /100

Last scanned (14 hours ago)

Scores higher than 75% of PyPI servers

Category IoT and Hardware

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security50
  • Malware scan not yet available for this package.Unverified
  • No known CVEs affecting this package version or its production dependencies.Pass
  • Runs setuptools.build_meta at install time, a recognised build step with no custom scripting around it. View diagnostics → Pass
  • No production dependencies, so there is no dependency health to assess. View diagnostics → Pass
Provenance & Transparency100
  • Source repository is publicly reachable at the declared URL. View diagnostics → Pass
  • Cryptographically verified build provenance (signed, bound to mo9652962-ai/circuit-agent). View diagnostics → Pass
  • Clear OSI-approved license (MIT).Pass
  • Actively maintained (last published 24 days ago).Pass
  • Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability76
  • 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
  • AI-judged instruction clarity (good).Pass
  • Context-footprint check failed: tool/resource definitions use about 16917 tokens (~183/item across 92 items; 84 tools + 8 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
  • No destabilizing schema changes in the last 30 days.Pass
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 99% of tool parameters carry a description.Partial
  • Structured output schemas are declared (7% of tools); any adoption earns full credit.Pass
Tool Safety75
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • 0 of 5 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "audit_industrial_dfx" implies "execute" and declares readOnlyHint instead, contradicting what its own name says it does. See how to fix → Fail
  • An AI judge read all 86 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a current MCP spec version (2026-07-28).Pass
What we tested

Checks we ran (15)

  • Known CVEs
  • Install scripts
  • Dependency health
  • Source repository
  • Provenance
  • License
  • Maintenance
  • Security disclosure
  • Schema quality
  • Stability
  • Tool coverage
  • Injection markers
  • Destructive annotations
  • Judged manipulation
  • MCP protocol

Checks we could not complete (1)

These are gaps on our side, not findings about this package. We only credit what we can confirm, so a category made up entirely of them scores 0.

  • Malware scan in Supply Chain SecurityMalware scan not yet available for this package.

Does not apply to this package (2)

  • Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
  • Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.

The score does not measure everything. What the score does not measure →

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 20 Nov 26 −15
    • Malware scan: pass → unverified ▼ security
  • 13 Nov 26 0
    • Stability: 0.97 → pass security
  • 12 Nov 26 +16
    • Malware scan: unverified → pass ▲ security
  • 11 Nov 26 −15
    • Malware scan: pass → unverified ▼ security
  • 10 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.

  • 9 Nov 26 −2
    • Stability: pass → 0.87 functional
  • 7 Nov 26 +15
    • Malware scan: unverified → pass ▲ security
  • 6 Nov 26 −15
    • Malware scan: pass → unverified ▼ security
Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 21 Nov 2026 · Analysed pypi/circuit-agent-client@0.25.0

Provenance Verified

A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.

Result Verified
Ecosystem pypi
Reason Verified
Discovered via Registry attestation endpoint
Source repo mo9652962-ai/circuit-agent
Certificate issuer https://token.actions.githubusercontent.com
Certificate SAN https://github.com/mo9652962-ai/circuit-agent/.github/workflows/publish.yml@refs/tags/v0.25.0
Rekor log index 3535260483
Predicate type PyPI publish attestation https://docs.pypi.org/attestations/publish/v1
Subject digest sha256:97acb3d8a692d0e47dd1772bd9813c8bdd417fd92e66d71a5b68388a5d6157f7

Background: How many MCP packages publish verified provenance →

Install scripts 1 script
Hook Tier Command
build_backend Known build tool setuptools.build_meta

Background: Why install scripts are a supply-chain risk →

Dependencies 0 packages
Packages resolved 0
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 84 exposed · ~16,455 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
calculate_via_stitching_array ~221

Calculate thermal via matrix array under QFN/power exposed pads (IPC-7093 Section 7.2) or RF ground shielding fence via arrays (IPC-2141A <= lambda/10 pitch) with thermal resistance reduction metrics.

NameTypeReqDescription
center_x_mmnumber–Center X coordinate in mm (default: 0.0).
center_y_mmnumber–Center Y coordinate in mm (default: 0.0).
drill_dia_mmnumber–Via drill diameter in mm (default: 0.30).
grid_pitch_mmnumber–Via center-to-center pitch in mm (default: 1.20).
is_rf_shielding_fenceboolean–Whether to generate dual-side ground shielding fence for RF microstrip (default: false).
pad_height_mmnumber–Exposed pad height in mm (default: 5.0).
pad_width_mmnumber–Exposed pad width in mm (default: 5.0).

No output schema declared.

No examples provided.

calculate_wave_solder_orientation_audit ~133

Audit bottom-side SMD component wave soldering orientation angles and hydrodynamic shadowing per IPC-7351B and SMTA guidelines: chip passives (0603/0805) perpendicular to flow to prevent tombstoning, SOIC ICs parallel to flow to prevent solder bridging, and 3xH shadow keepout zones behind tall components.

NameTypeReqDescription
flow_directionstring–Conveyor wave flow direction: 'X+' (default), 'X-', 'Y+', or 'Y-'.
modulesobjectyesComponent modules dict (with rotation_deg, position, and package).

No output schema declared.

No examples provided.

diff_netlists ~117

Engineering Change Order (ECO) netlist diff: compare two netlist revisions and report added/removed components, value/package changes, added/removed nets, pin membership moves, total change count, and ECO severity (NONE / MINOR / MAJOR) for PLM change management.

NameTypeReqDescription
new_connectionsarrayyesRevision B connections list.
new_modulesobjectyesRevision B component modules dict.
old_connectionsarrayyesRevision A connections list.
old_modulesobjectyesRevision A component modules dict.

No output schema declared.

No examples provided.

estimate_solder_joint_thermal_fatigue ~406

IPC-9701A / IPC-D-279 Engelmaier thermal cycling fatigue life estimator for critical SMT attachments: computes CTE-mismatch shear strain range over the component DNP, applies the creep-aware cycle exponent (hot dwell and mean joint temperature), and reports cycles-to-63.2%-failure against the service requirement across TC1-TC4 automotive/aerospace profiles.

NameTypeReqDescription
compliance_factor_fnumber–Joint compliance factor (0.5 typical, 1.0 stiff; default: 0.5).
componentstring–Ref/designation of the worst-case component (default: U1_BGA256).
conditionstring–IPC-9701 profile: 'TC1' 0-100, 'TC2' -25-125, 'TC3' -40-125 (default), 'TC4' -55-125 °C.
dnp_mmnumber–Distance from board neutral point to farthest joint in mm (default: 15.0).
hot_dwell_minnumber–Hot dwell time per cycle in minutes (default: 10.0).
joint_height_mmnumber–Solder joint standoff height in mm; BGA ~0.10-0.45, QFN ~0.05 (default: 0.10).
package_cte_ppmnumber–Package substrate/leadframe CTE in ppm/K (default: 14.0 BT BGA).
pcb_cte_ppmnumber–PCB in-plane CTE in ppm/K (default: 15.0 FR-4).
required_cyclesnumber–Service cycles the attachment must survive (default: 3000).
temp_max_cnumber–Explicit cycle maximum °C (overrides condition).
temp_min_cnumber–Explicit cycle minimum °C (overrides condition).

No output schema declared.

No examples provided.

evaluate_material_cti_creepage ~213

Evaluate substrate Comparative Tracking Index (CTI) Material Group (Group I >= 600V to Group IIIb) and required safety creepage under Pollution Degrees 1/2/3 and Basic/Reinforced insulation per IEC 62368-1 Table 25 and IPC-2221B, calculating safety margins and recommending high-CTI laminates.

NameTypeReqDescription
actual_clearance_mmnumber–Actual physical conductor spacing in mm (default: 2.0).
insulation_typestring–Insulation classification: 'Basic' (default) or 'Reinforced'.
pollution_degreeinteger–Pollution degree 1, 2, or 3 (default: 2).
substrate_cti_vnumber–Substrate CTI rating in Volts (default: 175.0 for standard FR-4; 600.0 for Group I).
working_voltage_vnumber–Operating rms/DC voltage (default: 220.0).

No output schema declared.

No examples provided.

export_assembly_drawing_svg ~190

Generate a scaled PCBA assembly drawing SVG per ASME Y14.5 and IPC-2221B Section 11: body outlines with refDes labels, polarity marks (pin-1 dots, cathode bars, plus frames), mirrored bottom view, and an ASME Y14.100 title block with revision and check signature.

NameTypeReqDescription
board_height_mmnumber–PCB height in mm (default: 50.0).
board_width_mmnumber–PCB width in mm (default: 70.0).
mirrored_bottomboolean–Render bottom view mirrored in X (default: true).
modulesobjectyesComponent modules dict (from synthesize_circuit output, with positions).
revisionstring–Drawing revision letter (default: A).
titlestring–Drawing title (default: PCBA ASSEMBLY DRAWING).

No output schema declared.

No examples provided.

export_excellon_drill ~138

Generate production IPC-NC-349 Excellon CNC drill file (.drl) with metric tool headers (T01C... T02C...), completing the 5-layer PCB manufacturing bundle for automated CNC drilling machines.

NameTypeReqDescription
board_height_mmnumber–PCB height in mm (default: 50.0).
board_width_mmnumber–PCB width in mm (default: 70.0).
connectionsarray–Netlist connections list (optional).
job_namestring–PCB fabrication job name.
modulesobjectyesComponent modules dict (from synthesize_circuit output).

No output schema declared.

No examples provided.

export_gerber_bundle ~249

Generate native fabrication-ready Gerber RS-274X + Excellon bundle (Edge_Cuts .gm1, Top/Bottom Copper .gtl/.gbl, Top/Bottom Mask .gts/.gbs, Top Silkscreen .gto, drill .drl) directly from placed modules and netlist, eliminating GUI EDA dependency. Copper layers carry real footprint pads and the autorouter's actual track geometry.

NameTypeReqDescription
autorouteboolean–Run the autorouter first so the copper layers carry real tracks (default: true). Set false to export pads only, i.e. an unrouted board.
board_height_mmnumber–PCB height in mm (default: 50.0).
board_width_mmnumber–PCB width in mm (default: 70.0).
modulesobjectyesComponent modules dict (from synthesize_circuit output).
netlistobjectyesNetlist dict with 'connections' (from synthesize_circuit output).
ses_textstring–Optional Specctra SES session text from a previous autoroute_pcb call. Overrides 'autoroute' and avoids routing twice.

No output schema declared.

No examples provided.

export_ipc_d356 ~143

Generate universal IPC-D-356A ASCII bare-board electrical test netlist file for flying probe testers (AEMG, ATG, MicroCraft) and bed-of-nails PCB fabrication test fixtures.

NameTypeReqDescription
board_height_mmnumber–Board height in mm (default: 50.0).
board_width_mmnumber–Board width in mm (default: 70.0).
job_namestring–Fabrication PCB job name.
modulesobjectyesComponent modules dict (from synthesize_circuit output).
netlistobjectyesNetlist dict with 'connections' (from synthesize_circuit output).

No output schema declared.

No examples provided.

export_ipc2581 ~198

Export a simplified IPC-2581B single-file intelligent fabrication data package (XML) — stackup, BOM, placed components, nets with pin membership, and board profile — replacing the legacy Gerber+Excellon+TXT handoff bundle accepted by Siemens X / Altium / Zuken / EMS houses.

NameTypeReqDescription
board_height_mmnumber–PCB height in mm (default: 50.0).
board_width_mmnumber–PCB width in mm (default: 70.0).
connectionsarray–Netlist connections list.
modulesobjectyesComponent modules dict (from synthesize_circuit output).
project_namestring–Project/organization name embedded in the XML (default: HARDWARE_PROJECT).
stackup_layersarray–Optional stackup layers ({name, class: 'CONDUCTOR'|'DIELECTRIC', thickness_um, material}).

No output schema declared.

No examples provided.

export_kicad_netlist ~70

Export standard KiCad S-Expression netlist (.net) compatible with KiCad 6/7/8/9/10 Pcbnew.

NameTypeReqDescription
netlistobjectyesHardware netlist dictionary or synthesis result.
titlestring–Schematic / board project title.

No output schema declared.

No examples provided.

export_kicad_schematic ~101

Export modern KiCad 8/9 S-Expression schematic file (.kicad_sch) directly viewable and editable in KiCad Eeschema with sheet layout, component symbols, pin references, and LCSC attributes.

NameTypeReqDescription
connectionsarray–Netlist connections list (optional).
modulesobjectyesComponent modules dict (from synthesize_circuit output).
titlestring–Schematic sheet title block title.

No output schema declared.

No examples provided.

export_manufacturing_bom ~50

Generate production-ready JLCPCB SMT BOM CSV with part grouping, designator aggregation, and Basic/Extended classification.

NameTypeReqDescription
netlistobjectyesHardware netlist dictionary or synthesis result.

No output schema declared.

No examples provided.

export_manufacturing_cpl ~102

Generate the JLCPCB SMT pick-and-place (CPL/pos) file with designator, centre X/Y in mm, layer and rotation. Required alongside the BOM for assembly: a part in the BOM but absent here is purchased and never soldered.

NameTypeReqDescription
default_layerstring–Layer to assign when the netlist does not specify one (default 'Top').
netlistobjectyesHardware netlist dictionary or synthesis result.

No output schema declared.

No examples provided.

export_openpnp_job ~106

Generate production OpenPnP and industrial SMT pick-and-place board job CSV (part, designator, X/Y coords, rotation, nozzle ID, feeder slot assignment) for automated robotic assembly.

NameTypeReqDescription
board_height_mmnumber–PCB height in mm (default: 50.0).
board_width_mmnumber–PCB width in mm (default: 70.0).
modulesobjectyesComponent modules dict (from synthesize_circuit output).

No output schema declared.

No examples provided.

export_specctra_dsn ~187

Generate universal Specctra DSN (v15.0) auto-router interchange file for automated PCB track routing in Freerouting, Cadence Specctra, Altium, or KiCad. Includes heuristic component auto-placement.

NameTypeReqDescription
board_height_mmnumber–PCB height in mm (default: 50.0).
board_width_mmnumber–PCB width in mm (default: 70.0).
clearance_mmnumber–Default routing clearance in mm (default: 0.200 / 8mil).
modulesobjectyesComponent modules dict (from synthesize_circuit output).
netlistobjectyesNetlist dict with 'connections' (from synthesize_circuit output).
trace_width_mmnumber–Default routing trace width in mm (default: 0.254 / 10mil).

No output schema declared.

No examples provided.

gate_production_readiness ~144

One-call industrial release gate: synthesizes from a prompt, places, autoroutes, exports the full 9-layer fab bundle (copper, mask, silk, stencil, drill, BOM, CPL), then runs the manufacturing validator including solder-mask dam width. Returns a single production_ready verdict plus the blocking defects, so a CI job or a contract manufacturer can decide go/no-go without reading five separate reports.

NameTypeReqDescription
board_height_mmnumber––
board_width_mmnumber––
job_namestring––
promptstringyesNatural-language circuit description, e.g. 'ESP32-C3 sensor node with USB-C'.

No output schema declared.

No examples provided.

generate_assembly_process_plan ~99

Generate a mixed-assembly process route plan: classify each component into SMD reflow / THT wave / THT manual / mechanical stages per IPC-A-610G Section 7, output the 10-stage EMS routing (SPI -> reflow -> AOI -> THT insert -> wave -> manual -> ICT -> FCT -> coating -> packing).

NameTypeReqDescription
modulesobjectyesComponent modules dict (from synthesize_circuit output).

No output schema declared.

No examples provided.

generate_interactive_bom ~117

Generate a lightweight self-contained single-file Interactive HTML BOM (iBOM, InteractiveHtmlBom-compatible) with interactive component grouping table, vector SVG board map, and bidirectional hover/click inspection.

NameTypeReqDescription
board_height_mmnumber–PCB height in mm (default: 50.0).
board_width_mmnumber–PCB width in mm (default: 70.0).
modulesobjectyesComponent modules dict (from synthesize_circuit output).
titlestring–Inspection page title.

No output schema declared.

No examples provided.

list_circuit_blocks ~26

List all 10 pre-validated CircuitBlocks available in the hardware DSL catalog.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_supported_chips ~41

List all registered MCU chips and third-party pinout allocation rules (e.g. CH32V003, STM32G030, ATmega328P).

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

optimize_panel_grid ~145

Enumerate panel grid combinations (grid_x x grid_y, rail sides, V-cut vs mouse-bites), filter options exceeding the max panel size (default 300x300mm fab limit), and rank feasible layouts by material utilization percentage.

NameTypeReqDescription
board_height_mmnumberyesSingle board height in mm.
board_width_mmnumberyesSingle board width in mm.
max_gridinteger–Maximum grid count per axis (default: 4).
max_panel_mmnumber–Maximum panel dimension in mm (default: 300.0).
rail_width_mmnumber–Conveyor rail width in mm (default: 5.0).

No output schema declared.

No examples provided.

optimize_smt_feeder_setup ~171

Optimize SMT pick-and-place feeder trolley allocation (Panasonic NPM / Fuji NXT / ASM SIPLACE standard 80-slot cart): applies Group Technology (GT) to pin permanent common passive reels (100nF, 10k), places high-frequency reels near the gantry center to minimize travel time, and forecasts reel run-out exhaustion points per batch size per IPC-9851.

NameTypeReqDescription
batch_sizeinteger–Production batch size in boards (default: 1000).
common_parts_listarray–Optional list of common component identifiers to pin into the permanent feeder block.
feeder_cart_capacityinteger–Total feeder slots on trolley cart (default: 80).
modulesobjectyesComponent modules dict (e.g. from synthesis or netlist).

No output schema declared.

No examples provided.

plan_conformal_coating ~217

IPC-CC-830C / IPC-A-610G §10 conformal coating material selector and masking keepout planner: validates dry-film thickness against the type windows (AR/ER/UR 30-130, SR 50-210, XY 10-50 μm), flags reworkability conflicts for field-repairable products, and enumerates connector/test-point/switch masking keepouts from the BOM before the selective-coating program is generated.

NameTypeReqDescription
coating_typestring–IPC-CC-830 type: 'AR' acrylic (default), 'ER' epoxy, 'UR' urethane, 'SR' silicone, or 'XY' parylene.
measured_thickness_umnumber–Witness-coupon measured dry-film thickness in μm (default: 75.0).
modulesobject–Optional BOM modules dict — contact-bearing parts become masking keepouts.
requires_field_reworkboolean–Whether the product must be repairable in service (default: False).

No output schema declared.

No examples provided.

predict_assembly_mtbf ~273

Telcordia SR-332 / MIL-HDBK-217F part-stress MTBF prediction: classifies the BOM into Telcordia part classes, applies Arrhenius πT at worst-case ambient, quality πQ (level 1-3), and environment πE (ground benign 1.0 to airborne 12.0), returns total FIT, MTBF hours/years, 5-year survival probability, and the top-5 dominant failure-rate contributors.

NameTypeReqDescription
ambient_temp_cnumber–Worst-case operating ambient in °C (default: 40.0).
duty_cycle_deratenumber–Operating duty fraction 0-1 applied to total λ (default: 1.0).
environmentstring–'ground_benign' | 'ground_fixed' (default) | 'ground_mobile' | 'airborne'.
modulesobject–BOM modules dict — parts are auto-classified by kind/value.
part_countsobject–Explicit {part_class: quantity} mapping (Telcordia classes).
quality_levelinteger–Telcordia qualification level 1 (screened 0.8×) / 2 (standard, default) / 3 (uncertified 2.0×).

No output schema declared.

No examples provided.

register_custom_chip ~279

Register or dynamically override a third-party microcontroller pinout and peripheral multiplexing rule.

NameTypeReqDescription
chip_idstringyesUnique identifier, e.g. 'CH32V003F4P6'
default_gpio_assignmentsobject–Default signal mappings, e.g. {'/LED1': 'PD4'}
descriptionstring–Human-readable description of the chip
mcu_familystring–MCU family, e.g. 'QingKe-RISC-V', 'ARM-Cortex-M0+'
packagestring–Physical package, e.g. 'TSSOP-20', 'QFN-32'
peripheral_routesobject–Peripheral routing defaults, e.g. {'I2C1': {'I2C_SCL': 'PC2', 'I2C_SDA': 'PC1'}}
pin_numbersobject–Map of pin names to physical pin numbers, e.g. {'PD1': '8'}
pinsarrayyesList of available GPIO and power pins
reserved_pinsobject–Map of reserved pins and reasons, e.g. {'PD1': 'SWDIO', 'NRST': 'RESET'}
supply_voltagenumber–Operating voltage (typically 3.3 or 5.0)

No output schema declared.

No examples provided.

render_circuit_topology ~45

Render a clean, structured ASCII architectural diagram of power domains, buses, and connected subsystems.

NameTypeReqDescription
netlistobjectyesHardware netlist dictionary or synthesis result.

No output schema declared.

No examples provided.

run_erc ~108

Run deterministic Electrical Rules Check (ERC) on a netlist: floating nets, missing GND, unknown designators, missing power domain, missing decoupling. Every finding carries severity + source; blocking/error issues gate BOM/CPL delivery.

NameTypeReqDescription
modulesobject–Optional modules dict (ref -> {kind, value, package, lcsc}) for component-aware rules.
netlistobjectyesNetlist dict with 'connections' (synthesize_circuit output passes directly).

No output schema declared.

No examples provided.

run_pcb_drc ~407

Execute rigorous physical Design Rule Check (DRC) on a routed PCB and return a scored violation report. Verifies what the router cannot: true copper-to-copper clearance between different nets (segment-to-segment geometry, not grid cells), acid traps and sub-90-degree etching crevices (IPC-2221B 10.1.2), trace width vs process capability, board-edge and mounting-hole keepout intrusion, RF antenna keepout, and high-speed differential pair skew (IPC-2141A 3.4). Returns severity-tagged violations with measured vs required values plus a 0-100 score; `passed` is false when any blocking error remains.

NameTypeReqDescription
board_height_mmnumber–PCB height in mm (default: 50.0).
board_width_mmnumber–PCB width in mm (default: 70.0).
check_acid_trapsboolean–Whether to check acute-angle etching traps and 90-degree high-speed corners (default: true).
edge_clearance_mmnumber–Minimum copper-to-board-edge setback in mm (default: 0.800).
max_diff_skew_mmnumber–Maximum allowed USB differential pair length mismatch in mm (default: 1.250).
min_clearance_mmnumber–Minimum copper-to-copper clearance in mm (default: 0.100 / 4mil).
min_trace_width_mmnumber–Minimum manufacturable trace width in mm (default: 0.127 / 5mil).
modulesobjectyesComponent modules dict (from synthesize_circuit output).
netlistobjectyesNetlist dict with 'connections' (from synthesize_circuit output).
ses_textstring–Specctra SES session text to check. When omitted the board is routed first with the default exact engine, so the report describes what would actually be fabricated.

No output schema declared.

No examples provided.

search_lcsc_parts ~97

Query live LCSC / JLCPCB component inventory, stock, package, and pricing with zero API keys required. Features 24-hour disk cache and exponential backoff.

NameTypeReqDescription
limitinteger–Maximum number of component matches to return (default: 5).
querystringyesComponent part number, model, or description (e.g. 'CH340N', 'SP3485', 'TP4056').

No output schema declared.

No examples provided.

size_hold_up_capacitor ~333

Size an MLCC reservoir bank for a brown-out ride-through window in EFFECTIVE farads, then report the marked value you must actually buy. Solves C = I·t/ΔV for the required effective capacitance and divides by the retention at the worst-case bias in the window, because sizing from the marked value is how a design that 'passes' delivers 0.85 ms of hold-up when the spec asked for 20 ms. Reports the achieved hold time, the shortfall, and the required marked capacitance.

NameTypeReqDescription
ambient_cnumber–Operating ambient in °C.
case_sizestring–EIA case code (0402/0603/0805/1206/1210).
dielectricstring–EIA dielectric: X5R, X7R, X8R, C0G/NP0.
hours_in_servicenumber–Expected service life in hours.
load_current_manumberyesLoad current drawn from the reservoir during the outage, in mA.
rated_vnumber–Capacitor rated voltage. Defaults to 2x v_start to keep bias derating near 50%.
required_hold_time_msnumberyesRequired ride-through duration in milliseconds.
tolerance_pctnumber–Capacitance tolerance in percent.
v_floornumberyesMinimum voltage the load tolerates (brown-out floor), in volts.
v_startnumberyesRail voltage at the moment the source collapses, AFTER any ORing diode drop — not the nominal input.
NameTypeReqDescription
achieved_hold_time_msnumberyesWhat the sized bank actually delivers.
effective_capacitance_ufnumberyesEffective capacitance the sized part delivers.
load_current_manumberyesLoad current used.
margin_msnumberyesAchieved minus required; negative means the design fails.
marked_capacitance_ufnumberyesThe reel value you must buy to get that effective value.
notesarrayyesHuman-readable findings: which term dominates, what to change, and any caveat.
passesbooleanyesTrue when achieved meets or exceeds required.
required_capacitance_ufnumberyesEffective capacitance the physics demands (I·t/ΔV).
required_hold_time_msnumberyesThe spec: how long the rail must survive.
required_marked_capacitance_ufnumberyesAlias of marked_capacitance_uf, kept for clarity.
shortfall_ufnumberyesEffective capacitance still missing; zero when the design passes.
v_floornumberyesBrown-out floor the rail must stay above.
v_startnumberyesRail voltage at the start of the outage, after any diode drop.

No examples provided.

solve_feedback_divider ~127

Exact R1/R2 feedback divider pair for a regulator or comparator target, plus the static error the E96 snap adds. The ideal pair almost never exists in E96, and that snap error is a wrongness, not a tolerance: it is identical on every board and must be budgeted separately from the tolerance band.

NameTypeReqDescription
r_total_ohmnumber–Total divider resistance R1+R2, which sets the quiescent current.
v_outnumberyesTarget output voltage.
v_refnumberyesReference voltage at the feedback midpoint.
NameTypeReqDescription
notestringyesWhy the snap error must be budgeted separately from the tolerance band.
r1_ohmnumberyesSnapped E96 high-side resistor.
r2_ohmnumberyesSnapped E96 low-side resistor.
snap_error_pctnumberyesStatic offset from E96 quantisation — a wrongness, not a tolerance.
v_out_actualnumberyesOutput the snapped pair actually produces.
v_out_targetnumberyesRequested output voltage.
v_refnumberyesReference voltage at the feedback midpoint.

No examples provided.

solve_via_current_array ~237

IPC-2152 / IPC-2221 via barrel current capacity and stitching-array solver: computes the annular barrel cross-section from drill and plating, applies the thermal formula with internal/external k constants, 40% array current-sharing derate, and IPC-4761 Type VII fill+cap credit, returning the minimum parallel via count for a rail current.

NameTypeReqDescription
current_anumber–Rail current to carry in A (default: 3.0).
internal_layerboolean–Transition between internal layers k=0.024 (default: False).
is_filledboolean–IPC-4761 Type VII fill+cap via (default: False).
max_array_sizeinteger–Stitching ceiling before recommending wider traces (default: 8).
max_delta_t_cnumber–Allowable barrel temperature rise °C (default: 20.0).
plating_umnumber–Copper plating thickness in μm (default: 25.0).
via_drill_mmnumber–Finished drill diameter in mm (default: 0.30).

No output schema declared.

No examples provided.

synthesize_circuit ~271

Synthesize a deterministic hardware netlist and component modules from a natural language prompt. Supported MCUs: STM32F103, ESP32-C3, ESP32-S3, RP2040, STC89C52, CH32V003, STM32G030, ATmega328P. Peripherals: Type-C, LDO, Crystal, Buttons, LEDs, Buzzer, I2C, RS485, CAN, TP4056 Battery, AHT20 Temp/Humidity Sensor, MPU6050 6-Axis Motion Sensor.

NameTypeReqDescription
chip_idstring–Optional explicit MCU chip model (e.g. 'CH32V003F4P6', 'STM32G030F6P6', 'ATmega328P', 'STM32F103C8T6')
custom_chipobject–Optional third-party chip definition with custom pinout, package, and peripheral multiplexing rules
pin_mappingobject–Optional custom signal-to-pin allocations, e.g. {'/SCL': 'PC2', '/SDA': 'PC1'}
promptstringyesNatural language circuit description, e.g. '基于 CH32V003 的 AHT20 温湿度与 MPU6050 姿态传感器节点'

No output schema declared.

No examples provided.

validate_manufacturing_package ~138

Headless manufacturing package validator for automated CI/CD and developer hand-off: checks completeness and non-emptiness of 5-layer Gerbers, Excellon drill, BOM, and CPL, verifies component refDes consistency, and calculates SHA-256 cryptographic tamper-proof ledger.

NameTypeReqDescription
artifacts_dictobjectyesDict mapping filename (e.g. 'board-Edge_Cuts.gm1', 'bom.csv') to content string or bytes.
job_namestring–Project job name for manifest header (default: PCB_PROJECT).
modulesobject–Optional component modules dict from synthesis for BOM cross-verification.

No output schema declared.

No examples provided.

validate_netlist ~47

Validate a hardware netlist dictionary against the formal CircuitAgent JSON Schema specification.

NameTypeReqDescription
netlistobjectyesNetlist dictionary containing 'connections' list with 'net' and 'points'.

No output schema declared.

No examples provided.

Install

How do I install the CircuitAgent MCP server?

CircuitAgent runs locally as a PyPI package, launched with uvx circuit-agent-client. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

pypi · circuit-agent-client

# add to Claude Code
claude mcp add mo9652962-ai-circuit-agent-client -- uvx circuit-agent-client
Common questions

What is the CircuitAgent MCP server?

CircuitAgent is an MCP server listed in the public MCP registry as io.github.mo9652962-ai/circuit-agent-client. AI hardware synthesis: CircuitBlocks DSL, live LCSC parts, industrial DFX audit, stdio MCP server. This page covers its PyPI package (circuit-agent-client).

Is the CircuitAgent MCP server safe to use?

CircuitAgent scores 79 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 2026. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the CircuitAgent MCP server expose?

CircuitAgent exposes 84 tools: synthesize_circuit, list_supported_chips, register_custom_chip, search_lcsc_parts, list_circuit_blocks, and 79 more. Their descriptions and schemas cost roughly 16,455 tokens of context every time the server is loaded.

Is the CircuitAgent MCP server still maintained?

CircuitAgent is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What licence is the CircuitAgent MCP server under?

CircuitAgent declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

What did VerifyMCP test on the CircuitAgent MCP server?

VerifyMCP ran 15 checks on CircuitAgent, covering Known CVEs, Install scripts, Dependency health, Source repository and 11 more. One item could not be completed, a gap on our side rather than a finding about CircuitAgent: Malware scan. Endpoint Security and Transport & Reachability do not apply to a PyPI package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.