Plumb · components
plumb_componentsLists every Figma component definition and its instance usage to map a design system, with optional health checks for unused components, duplicates, and variant outliers.
Instructions
List every Figma component definition in the file and the instance usages of each — useful for understanding the design system before building. Each component carries an instance count; each instance carries the component id, so you can match usage to definition. Pass health: true to also get a design-system health report: unused components (zero instances), possible duplicates (near-identical names — 'Button', 'Button copy', 'Button 2'), and variant outliers (an instance whose prop overrides don't match any other instance of the same component, among components with enough instances for a pattern to mean something). Plugin path; needs the Plumb plugin paired.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "plumb_components"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Filter components and instances to a single Figma page by name (case-insensitive, substring-friendly). Massive token saver on files that hide a 200-variant style guide on one page. | |
| health | No | Also compute a design-system health report (unused components, possible duplicates, variant outliers) over the (page-filtered) component/instance list. Default false — purely additive to the response, existing callers see no shape change when omitted. |