Partreel

Working · 412 ms

io.github.mingyo186/partreelv1.0.0

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

Developer Tools

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.partreel.com/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

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).

idstring, required

Part id, e.g. 'jst_ph_4pin', 'usb_c_16p'

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (7)

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).

Argument	Type	Description
id*	string	Part id, e.g. 'jst_ph_4pin', 'usb_c_16p'

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Part id, e.g. 'jst_ph_4pin', 'usb_c_16p'"
    }
  }
}

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.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

list_parts

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

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

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.

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

Input schema (JSON)

{
  "type": "object",
  "required": [
    "part_id",
    "result",
    "notes"
  ],
  "properties": {
    "notes": {
      "type": "string",
      "description": "Details: what you built, fab house, what worked or what was wrong (max 1000 chars)"
    },
    "result": {
      "enum": [
        "worked",
        "problem"
      ],
      "type": "string",
      "description": "'worked' = used successfully, 'problem' = issue found"
    },
    "part_id": {
      "type": "string",
      "description": "Part id, e.g. 'jst_ph_4pin'"
    }
  }
}

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.

Argument	Type	Description
pins	integer	for pin_header_* families
family*	string
variant	string	for variant families (e.g. '7350', 'a', '17049')

Input schema (JSON)

{
  "type": "object",
  "required": [
    "family"
  ],
  "properties": {
    "pins": {
      "type": "integer",
      "maximum": 40,
      "minimum": 1,
      "description": "for pin_header_* families"
    },
    "family": {
      "enum": [
        "pin_header_254",
        "pin_header_200",
        "pin_header_127",
        "ht73xx",
        "ht78xx",
        "sy8008",
        "max1704x"
      ],
      "type": "string"
    },
    "variant": {
      "type": "string",
      "description": "for variant families (e.g. '7350', 'a', '17049')"
    }
  }
}

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'.

Argument	Type	Description
query*	string	Search text (name, family, keywords, pin count)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Search text (name, family, keywords, pin count)"
    }
  }
}

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.

Argument	Type	Description
id*	string	part id: lowercase letters/digits/underscore, 3-64 chars, e.g. 'ti_sn74lvc1g08_sot23'
name*	string	human-readable name / MPN
symbol*	string	full .kicad_sym file text
license*	string	CC-BY-4.0 for original work; MIT/Apache-2.0/CERN-OHL-P/CC-BY for imports
category*	string	one of: connector, discrete, ic, passive, switch, module, etc
datasheet	string	datasheet URL (optional)
footprint*	string	full .kicad_mod file text
description