Search parts
parts_searchSearch electronic parts by value spec, MPN, or category across configured providers. Returns ranked results with package, stock, price, and match quality for schematic import.
Instructions
Find parts. The project's parts providers are asked in order and the first with results answers (provider in the
result says which; 'local' = the user's own catalogue file, 'kicad' = generic library parts). Results are ranked by
spec match, then by the provider's part class (parts without a setup fee first), stock and price.
query: a value spec ('10k 0603', '100nF 16V 0402 X7R', 'LED red 0603', '12MHz crystal', 'LDO 3.3V SOT-223'), an MPN
('AMS1117-3.3') or a category phrase ('USB-C 16P', 'Header 1x4 2.54mm').
Each result: provider, id (the provider's part number), mpn, package, stock, price, match ('partial' = not every
term confirmed) and next = the exact sch_apply op. Passives by spec and known part numbers need no search:
sch_apply place resolves and imports them itself.
Example: parts_search(query='USB-C 16P', limit=5)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "parts_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| live | No | query live supplier data (default true); false = offline data only | |
| limit | No | max results (default 8) | |
| query | Yes | value spec, MPN, or a description of the part | |
| package | No | optional package filter, e.g. '0603', 'SOT-23', 'SOIC-8' | |
| category | No | optional kind/category filter: resistor, capacitor, led, diode, mosfet, ldo, crystal, usb_connector, header, mcu, module, … or catalogue wording ('sensor', 'gas sensors', 'wifi module') | |
| in_stock | No | only parts in stock (default: the config policy, true) | |
| provider | No | parts provider to ask (default: the project's parts.providers, in order): lcsc | local | kicad | a third-party name | |
| min_stock | No | ||
| basic_only | No | only the provider's cheapest assembly class (JLC Basic) |