---
name: mouser
description: Search Mouser Electronics for components, pricing, stock, and part numbers. Use when the user asks to find components on Mouser, check Mouser pricing, look up a Mouser part number, search for in-stock parts, get price breaks, compare alternatives, or find a datasheet or product page for a specific part.
---

# Mouser Electronics Search

Search Mouser's catalog of millions of electronic components from thousands of manufacturers. Real-time pricing, stock, lead times, and product links.

## Architecture

The Mouser search runs as a **shared remote service** on a dedicated container. User containers access it via the `adom-mouser` MCP server, which proxies requests to the shared service over HTTP.

```
Dedicated Service Container (john/service-mouser)
  Mouser API v2 proxy (port 8775, 10-min LRU cache)
    ↓ (proxied via Coder)
  HTTP API: https://coder.john-service-mouser-93c1a4bed95fb9ac.containers.adom.inc/proxy/8775
  MCP:      https://coder.john-service-mouser-93c1a4bed95fb9ac.containers.adom.inc/proxy/8776/mcp

User Containers (any Gallia-enabled container)
  MCP Tools (adom-mouser) ──→ HTTP fetch to shared service URL
    ↓
  pushToViewer() ──→ Viewer API (port 8771) ──→ WebSocket ──→ Gallia Viewer
```

The service URL is hardcoded in `mouser/mcp/tools.js` — no `MOUSER_API_KEY` env var needed on user containers. The API key lives only on the service container.

### Service Container Details

- **Container:** `john/service-mouser` on Adom (`john-service-mouser-93c1a4bed95fb9ac`)
- **Port 8775:** HTTP API — `GET /health`, `GET /search?keyword=...`, `GET /part?partNumber=...`, or `POST /` with JSON body
- **Port 8776:** Streamable HTTP MCP endpoint at `/mcp` — add to `.mcp.json` as `{ "type": "streamable-http", "url": "...proxy/8776/mcp" }`
- **Bootstrap:** `bash <(curl -fsSL https://coder.john-gallia-f280e93ffec7e79d.containers.adom.inc/proxy/9999/bootstrap.sh) --service mouser`
- **Update:** `cd ~/gallia && git pull && pkill -f 'node.*services/mouser/server.js'; bash services/mouser/start-mouser.sh`

## Available MCP Tools

### `mouser_search` — Keyword / Part Number Search

Search by keyword, description, manufacturer part number (MPN), or Mouser part number.

**Parameters:**
| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `keyword` | string | required | Part number, keyword, description, or category + specs |
| `limit` | number | 10 | Max results (1–50) |
| `inStockOnly` | boolean | false | Only return parts currently in stock |

**Example uses:**
- `keyword: "STM32F103RBT6"` — find by MPN
- `keyword: "511-STM32F103RBT6"` — find by Mouser PN
- `keyword: "ESP32 WiFi Bluetooth"` — keyword search
- `keyword: "LDO 3.3V 500mA SOT-23"` — parametric-style search
- `keyword: "STM32F4 microcontroller"`, `inStockOnly: true` — in-stock only

### `mouser_part` — Exact Part Lookup

Get full details for a specific part by Mouser PN or MPN. Returns complete price break table, packaging options, RoHS status, lifecycle, datasheet URL, and product page.

**Parameters:**
| Parameter | Type | Description |
|-----------|------|-------------|
| `partNumber` | string | Mouser PN (e.g. `511-STM32F103RBT6`) or MPN (e.g. `STM32F103RBT6`) |

Use `mouser_search` first to discover parts, then `mouser_part` to get full details.

### `mouser_health` — Health Check

Verify the API key is set and Mouser API is reachable. No parameters.

## What's in a Result

Each part includes:
- **Mouser part number** — use this for BOM ordering
- **Manufacturer part number (MPN)** — use this in schematics/footprints
- **Manufacturer name**
- **Description and category**
- **Stock** — in-stock quantity at Mouser (live)
- **Lead time** — estimated delivery if ordering from factory
- **Price breaks** — quantity pricing tiers (1+, 10+, 25+, 100+, etc.)
- **Min order qty / order multiple**
- **RoHS status** — compliance flag
- **Lifecycle status** — e.g. New Product, Active, NRND, Obsolete
- **Product page URL** — direct link to Mouser product listing
- **Datasheet URL** *(verbose mode)* — direct PDF link if available

## Workflow

### Finding a part from scratch
1. Use `mouser_search` with a keyword or description
2. Scan results for the right part (check stock, price, lifecycle)
3. Use `mouser_part` to get full pricing and product details
4. Copy the **Mouser PN** for BOM and the **MPN** for schematic/footprint use

### Checking price for a known MPN
Use `mouser_search` with the MPN as the keyword — typically returns exact or near-exact matches as the first results.

### Checking in-stock alternatives
Use `mouser_search` with `inStockOnly: true` and a descriptive keyword (e.g. `"32-bit ARM Cortex-M3 flash 128KB LQFP-48 in stock"`).

## Files

| File | Purpose |
|------|---------|
| `services/mouser/server.js` | HTTP API server (port 8775), Mouser API proxy, landing page |
| `services/mouser/start-mouser.sh` | Idempotent start script (used by container boot) |
| `services/mouser/test.js` | Test suite with GV output |
| `mouser/mcp/server.js` | MCP stdio transport entry point |
| `mouser/mcp/tools.js` | 3 MCP tools + fire-and-forget push to Gallia Viewer (hardcoded service URL) |

## Notes

- Results are sorted by Mouser's internal relevance algorithm (not necessarily by stock)
- Mouser prices do not include shipping or any applicable tariffs
- Stock levels are live at time of query (10-minute cache on the service)
- The API key lives only on the service container — user containers don't need it