io.github.mingyo186/partreel

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Verified KiCad footprints, symbols & 3D models for AI agents. No signup, CC-BY-4.0, quality-gated.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "partreel": {
      "url": "https://mcp.partreel.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (7)

• search_parts

  Search the PartReel registry of verified KiCad components (footprint + symbol + 3D STEP/GLB, no login, CC-BY-4.0). Returns matching parts with ids. Use get_part for download URLs. Example queries: 'usb-c', 'jst ph 4pin', 'esp32', 'microsd', 'screw terminal'.

  Parameters:

  • query (required) — string — Search text (name, family, keywords, pin count)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_part

  Get full detail for one part by id: parameters, verification status, datasheet, and absolute download URLs for .kicad_mod (footprint), .kicad_sym (symbol), .step and .glb (3D).

  Parameters:

  • id (required) — string — Part id, e.g. 'jst_ph_4pin', 'usb_c_16p'

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_parts

  List all parts in the registry (id, name, family, pins).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• report_feedback

  Report real-world usage feedback for a part (e.g. 'fabricated 5 boards at JLCPCB, footprint fit perfectly' or 'pad 3 misaligned'). Feedback is recorded publicly on GitHub and builds the part's field-proven trust score. Please report after actually using a part — both successes and problems help.

  Parameters:

  • part_id (required) — string — Part id, e.g. 'jst_ph_4pin'
  • result (required) — string — 'worked' = used successfully, 'problem' = issue found
  • notes (required) — string — Details: what you built, fab house, what worked or what was wrong (max 1000 chars)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• request_part

  Request on-demand generation of a parametric part that isn't in the registry yet. The registry generates it (footprint+symbol+3D), runs quality gates, and publishes it within ~5 minutes. Pin-count families (use 'pins'): pin_header_254 (2.54mm), pin_header_200 (2.0mm), pin_header_127 (1.27mm) — pins 1-40. Variant families (use 'variant'): ht73xx (LDO Vout code: 7318,7325,7327,7330,7333,7335,7341,7350), ht78xx (7818,7825,7827,7830,7833,7850), sy8008 (grade a/b/c = 0.6A/1A/1.2A), max1704x (17048,17049). Always try get_part / search_parts first.

  Parameters:

  • family (required) — string
  • pins — integer — for pin_header_* families
  • variant — string — for variant families (e.g. '7350', 'a', '17049')

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• how_to_contribute

  Get machine-readable instructions for adding a new part to the registry (file layout, metadata schema, quality gates, PR process). Use when a part is missing.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• submit_part

  Upload a part you built so it is SHARED IMMEDIATELY (status 'staging', unverified). It becomes searchable and downloadable right away; hourly CI then runs the full quality gates and opens a PR to promote it to the verified registry. Provide the full text of the .kicad_sym and .kicad_mod files plus metadata. Cite real datasheet dimensions in dimensions_source — copies of the official KiCad (CC-BY-SA) library are auto-rejected at promotion.

  Parameters:

  • id (required) — string — part id: lowercase letters/digits/underscore, 3-64 chars, e.g. 'ti_sn74lvc1g08_sot23'
  • name (required) — string — human-readable name / MPN
  • description (required) — string
  • category (required) — string — one of: connector, discrete, ic, passive, switch, module, etc
  • license (required) — string — CC-BY-4.0 for original work; MIT/Apache-2.0/CERN-OHL-P/CC-BY for imports
  • dimensions_source (required) — string — datasheet URL + page/figure the dimensions came from (min 20 chars)
  • symbol (required) — string — full .kicad_sym file text
  • footprint (required) — string — full .kicad_mod file text
  • datasheet — string — datasheet URL (optional)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.