search_library_footprints
Find KiCad footprints by name, description, or tags, with optional library and project filtering. Returns ranked matches to help you choose the right footprint for a schematic or board.
Instructions
Search the footprints of the KiCad libraries by name, description and tags.
Each word of the query must be in the library ID ("Resistor_SMD:R_0603_1608Metric"), the description or the tags. The order is that of the footprint chooser of KiCad: an exact name first, then the best score. The first search reads all libraries (some seconds); then an index in the user cache directory is used until a library file changes.
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": "search_library_footprints"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | The maximum number of results in the table. | |
| query | Yes | Words to find, for example "0603 resistor". | |
| library | No | Optional name of one library to search (also when it is hidden). | |
| project_path | No | Optional project (.kicad_pro, .kicad_sch, .kicad_pcb or its directory), to include its libraries. | |
| include_hidden | No | Also search libraries that are hidden in KiCad. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |