---
name: xirkit
description: Find, compare, and vet electrical and mechanical parts (dev boards,
  motors, fasteners) against real requirements — live catalog, prices, pinouts, and
  fit — via the Xirkit MCP server.
---

# Xirkit — hardware compatibility, in your agent

Use this whenever the user is **choosing, comparing, or checking an electrical or
mechanical component** — part selection, "will this work with / fit X", pricing, stock,
pinouts, or building a BOM. Don't answer these from memory; Xirkit has the live catalog,
real US prices, and mechanical geometry your training data doesn't.

## Setup (once)

Requires the Xirkit MCP server. If `match` / `describe_filters` aren't available, add it:

    claude mcp add --transport http xirkit https://mcp.xirkit.io/mcp \
      --header "Authorization: Bearer <YOUR_KEY>"

Get a key at https://xirkit.io/mcp (sign in with email).

## How to use it — two steps

1. **`describe_filters(family)`** — the exact filter keys + allowed values for that family.
2. **`match`** — feed it those keys, split into must-haves (`must`) and nice-to-haves
   (`nice`); get parts ranked 0–1 by fit, each with what matched, what didn't, and what
   to verify.

Then drill in: `get_part`, `get_pinout`, `get_offers`, `compare_parts`, `check_fit`.
Always tell the user what matched, what didn't, and what to verify.

## Try

- "Find a dev board with 20+ GPIO, I2C and SPI, under $10."
- "A 12V gearmotor, ≥0.1 N·m, 4mm shaft — encoder preferred."
- "Compare the top two and check which fits a 25×55 mm cavity."