Return current session state: open project, available capabilities. Use this to orient yourself before calling other tools.

Create a new KiCad project with .kicad_pro, .kicad_sch, and .kicad_pcb files. Example: create_project(name='my_board', directory='/path/to/dir')

Open an existing KiCad project. Sets session context for all subsequent tools. Example: open_project(path='/path/to/project.kicad_pro')

List KiCad projects (.kicad_pro files) in a directory. Example: list_projects(directory='/home/user/projects')

[Requires open project] Save all open project files (schematic + PCB).

Get detailed documentation for a tool or topic. Use when unsure about parameters or workflow. Example: help(topic='workflow')

Add a symbol to the schematic. Use search_symbols first to find the symbol ID. Example: add_component(symbol='Device:R', ref='R1', value='10k', x=100, y=50)

Add a power symbol (VCC, GND, +3V3, etc). Creates global net connection. Example: add_power_symbol(name='+3V3', x=100, y=30)

Set the value property of a component. Example: set_value(ref='R1', value='4.7k')

Set the reference designator of a component.

Set a custom field on a component (MPN, supplier, tolerance, voltage rating).

Delete a component from the schematic by reference.

Move a component to a new position.

Add a wire between two points. Coordinates must be exact. Example: add_wire(x1=100, y1=50, x2=150, y2=50)

Add a net label at a position. Primary wiring mechanism for named nets. Example: add_net_label(name='SDA', x=120, y=50)

Add a global label (connects across hierarchical sheets).

Mark an unused pin with a no-connect flag. Required to pass ERC.

Auto-assign reference designators to all unannotated components.

List all components in the schematic with references, values, and positions.

[Requires open project] Draw the PCB board outline. Every PCB must have this. Example: create_board_outline(width=50, height=30)

[Requires open project] Set global design rules: min trace width, clearance, drill size.

[Requires open project] Create a net class with specific trace width and clearance. Example: create_net_class(name='Power', trace_width=0.5, clearance=0.3)

[Requires open project] Route a trace between two points. Straight segments only. Example: route_trace(x1=100, y1=100, x2=110, y2=100, width=0.25, layer='F.Cu')

[Requires open project] Place a via at a position. Example: place_via(x=105, y=100, drill=0.3, diameter=0.6)

[Requires open project] Fill all zones. Must be done before DRC or Gerber export.

[Requires open project] Add text to PCB silkscreen or other layer. Example: add_text(text='REV A', x=110, y=105, layer='F.SilkS')

[Requires open project] Add a line or shape to a PCB layer.

[Requires open project] Board summary: dimensions, component count, net count, via count, min trace/space. Use before export as a sanity check.

[Requires open project] List all footprints on the PCB with positions and layers.

[Requires open project] Export a netlist from the schematic. Use before syncing PCB with schematic.

[Requires open project] Run Electrical Rules Check on the schematic. Finds unconnected pins, missing power, etc.

[Requires open project] Run Design Rules Check on the PCB. Must pass before exporting Gerbers.

[Requires open project] Export Gerber manufacturing files. Blocked if DRC has unresolved errors — run kicad.run_drc first.

[Requires open project] Export Bill of Materials from the schematic.

[Requires open project] Export schematic or PCB to PDF. Example: export_pdf(output_path='/tmp/sch.pdf', target='schematic')

[Requires open project] Export schematic or PCB to SVG. Example: export_svg(output_path='/tmp/sch.svg', target='schematic')

Search for symbols (components) in KiCad libraries. Example: search_symbols(query='STM32', limit=10)

Search for footprints in KiCad libraries. Example: search_footprints(query='QFP-48', limit=10)

Get detailed info for a specific symbol: pins, properties, datasheet. Example: get_symbol_info(library='Device', symbol='R')