Skip to main content
Glama
Kairo

Kairo

by JoshChomps

Kairo

An MCP server that turns a described circuit into a checked KiCad project. Every voltage and current is worked out twice, by formulas with cited sources and by simulation (ngspice and Xyce), and anything that could not be checked is marked unverified instead of guessed.

Kairo gives a model in any MCP client the tools to design and check electronics without making numbers up:

  • Designs from a description. Pins come only from the KiCad libraries, never from memory; each build is checked by KiCad's own netlist and electrical rules check before anything is written.

  • Numbers with sources. Every value comes from a formula with a cited source and its worst case over the parts' tolerances; each requirement is pass, fail or unverified, with what would settle it.

  • Simulation in two engines. ngspice and Xyce, judged at the worst case; Monte Carlo is a report and never decides.

  • Schematics you drew. Read any KiCad project, check it against the facts you state, simulate parts of it, and change values or parts with KiCad confirming nothing else moved.

  • Real parts. Resistors, capacitors, inductors, LEDs and regulators from a parts catalogue; datasheets fetched and their limit tables read.

  • Boards. Placement by block and edge, pours, Kairo's own router, and KiCad's DRC against net classes and voltage spacing, with fab files.

  • A review. Faults and suggestions, each with its source: rails with no decoupling, switches bypassed by a body diode, floating inputs, crossed UARTs, and on a prototype, rails with no test point, light or link to open, and spare I/O left unreachable.

Install

You need uv and KiCad 10. No release is published yet, so install from a clone of this repository, which also needs Rust. Releases will carry a desktop extension (kairo.mcpb) and a wheel for Windows, macOS and Linux. See docs/getting-started.md for each client.

Then ask for a circuit in your own words:

A 3.3 V rail from 5 V USB for a sensor that draws 120 mA

Related MCP server: KiCAD MCP Server

Documentation

Development

uv sync                                       # builds the compiled loops; needs Rust
uv run pytest -m "not kicad and not spice"    # drop -m when KiCad and ngspice are installed
uv run ruff check && uv run ruff format --check && uv run pyright
uv run sphinx-build -W docs docs/_build/html  # the documentation site

Licence

GNU Affero General Public License v3.0 only (AGPL-3.0-only); see LICENSE. Kairo is free to use, share and change. Anyone who shares a changed Kairo, or runs one as a service for others, must offer its source under the same licence, so it stays free.

The circuits are yours. The licence covers Kairo's own code, not the schematics, boards and other files it writes for you; those carry no terms from Kairo.

Versions published before 6 November 2026 were released under the Apache License 2.0. Third-party licences, and the licences of the open-hardware boards used as test data, are listed in NOTICE.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      Enables AI assistants to design PCBs in KiCAD through natural language, with transactional preview-verify-commit workflow, undo/redo, and an engineering knowledge base.
      14
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to interact with KiCAD for PCB design automation. Users can design PCBs using natural language, including component placement, routing, checks, and export.
      1
      MIT
    • F
      license
      B
      quality
      B
      maintenance
      Enables users to transform natural-language requirements into KiCad electronic projects, with tools to create workspaces, generate designs, validate them, and export manufacturing files when checks pass.
      2
      4
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to turn plain-language requests into complete, routed and design-rule-checked printed circuit boards, including engineering review, part search and inventory use, and export to Gerber, KiCad, BOM and pick-and-place files.
      MIT