Minimal MCP Config

Use an absolute KiCad project path:

{
  "servers": {
    "kicad": {
      "type": "stdio",
      "command": "uvx",
      "args": ["kicad-mcp-pro"],
      "env": {
        "KICAD_MCP_PROJECT_DIR": "/absolute/path/to/your/kicad-project",
        "KICAD_MCP_WORKSPACE_ROOT": "/absolute/path/to/your/workspace",
        "KICAD_MCP_PROFILE": "pcb_only"
      }
    }
  }
}

More client examples:

• Client configuration
• Claude Desktop
• Cursor
• Claude Code
• KiCad Studio

What It Does

• Project-aware setup with safe path handling and recent-project discovery.
• PCB tools for board state, tracks, vias, footprints, layers, zones, placement, and sync.
• Schematic tools for symbols, wires, labels, buses, annotation, templates, routing, and IPC reload.
• Validation gates for schematic quality, connectivity, PCB quality, placement, transfer, DFM, and manufacturing.
• Gated release handoff through export_manufacturing_package().
• Export tools for Gerber, drill, BOM, PDF, netlist, STEP, render, pick-and-place, IPC-2581, SVG, and DXF.
• SI, PI, EMC, routing, simulation, library, and version-control helper surfaces.
• Server profiles such as minimal, pcb_only, schematic_only, manufacturing, analysis, and agent_full.
• Machine-readable CLI diagnostics for editors and MCP clients.

Common Workflow

kicad_set_project()
project_get_design_spec()
sch_build_circuit()
pcb_sync_from_schematic()
project_quality_gate_report()
export_manufacturing_package()

Demo media guidance lives in docs/demo-media.md.

Documentation

• Installation
• Configuration
• Tools reference
• Troubleshooting
• FAQ
• API stability
• Release process
• Maintenance policy
• Workflow security
• Security threat model
• Comparison

Repository Operations

Normal CI and security workflows run on pull requests, pushes, and merge queue events. Release, publish, mirroring, deployment, and token-backed jobs remain guarded behind explicit repository checks and protected environments.

The project uses Dependabot, Renovate, CodeQL, Gitleaks, Trivy, OpenSSF Scorecard, Codecov, release-please, SBOM generation, Sigstore signing, and GitHub artifact attestations for release hardening.

Operational references:

• Repository operations
• Autonomy model
• Doppler setup
• Branch protection

Contributing and Support

• Contributing
• Support
• Governance
• Security policy
• Roadmap
• Changelog