Quick start

Requires Python 3.10 or newer. KiCad's kicad-cliis optional; only the commands that wrap it (such as kct erc,kct drc and kct export-formats) need it.

  1. Install

    pip install kicad-tools
    kct --version

    Optional extras: [mcp] for the agent server,[native] for the C++ router backend (kct build-native), [all] for everything.

    Installation guide
  2. Inspect and check

    kct symbols project.kicad_sch
    kct nets project.kicad_sch --format json
    kct bom project.kicad_sch --format csv
    kct check board.kicad_pcb --mfr jlcpcb

    kct check is a pure-Python design-rule check against a manufacturer profile; add --format json for a machine-readable report.

    CLI reference
  3. Connect an agent

    pip install "kicad-tools[mcp]"
    kct mcp setup --client claude-code
    kct skills install
    kct agent-guide

    Registers the MCP server, installs the kct skills and prints the agent primer. Use --client /--harness codex or opencode for other harnesses.

    Harness setup

From design data to checked copper

v0.27.0

Use the CLI for a single check, the Python API for a repeatable workflow, or the MCP server to give an agent access to your design tools.

Agent skills

Shipped in the wheel and installed with kct skills install. Invocation syntax varies by harness; Claude Code's is shown.

Skill contracts and install options

Demo boards

Reference designs that exercise the workflow. Each board reports its own available artifacts and validation; inclusion here is not a readiness claim.