[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [JLCPCB component categories](https://spiral.ai/integrations/windsurf/jlcpcb-component-categories)

# How to Use JLCPCB component categories in Windsurf

Returns JLCPCB's two-level component category taxonomy. Use it to find the right category and subcategory before looking for components.

|  |  |
| --- | --- |
| Model | JLCPCB component categories |
| Available through | Alexandria |
| Category | E-commerce |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with JLCPCB component categories in Windsurf

- Use JLCPCB component categories to identify where capacitors belong, and add the returned category names to this project's component research notes.
- Use JLCPCB component categories to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from JLCPCB component categories and tell me what changed since last week.
- Check JLCPCB component categories and summarize what you find in three bullet points.
- Pull the newest data from JLCPCB component categories and give me the result as a table.

## How to set up JLCPCB component categories in Windsurf

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: `~/.config/devin/mcp_config.json` on macOS and Linux, `%APPDATA%\devin\mcp_config.json` on Windows. Add this:

```json
{
  "mcpServers": {
    "spiral": {
      "url": "https://api.spiral.ai/mcp"
    }
  }
}
```

2. **Sign in**: Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

```bash
devin mcp login spiral
```

3. **Check it**: Spiral is listed under This computer in Customize › MCPs. From the terminal:

```bash
devin mcp list
```

### Use the Spiral skill

1. **Send Windsurf this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run JLCPCB component categories**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "jlcpcb-com/electronic-components/list_categories",
    "input": {
      "category_id": 1
    }
  }'
```

Then paste one of the prompts above: Windsurf finds JLCPCB component categories on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/windsurf

## JLCPCB component categories tools and prices

- [JLCPCB parts library · List categories](https://spiral.ai/tools/alexandria/jlcpcb-com/electronic-components/list_categories) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| category_id | 1 to … | — | Top-level category id (source componentSortKeyId) to expand. |

## What can you do with JLCPCB component categories in Windsurf?

Turn a project's bill of materials into a JLCPCB component review with catalog matches, package checks, and stock findings. Use category names and search suggestions to guide discovery, then attach component specifications and datasheet links to the review.

### Find decoupling capacitors for a new board

Review available search suggestions, locate the capacitor categories, and search for 100 nF parts. Check each candidate's voltage rating, tolerance, package, and stock before choosing a part.

### Build a power supply component shortlist

Use search suggestions and the category taxonomy to plan searches for voltage regulators. Retrieve candidate details for an engineer to compare against the board's electrical and package requirements.

### Research components for a sensor board

Review suggested search wording and sensor categories, then find candidate components. Collect their specifications, package information, stock, and datasheet links for design review.

### Explore ferrite beads for an input filter

Review search suggestions and category names before searching for ferrite beads. Compare candidate descriptions and detailed attributes against the filter's current, impedance, and footprint requirements.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Windsurf guides](https://spiral.ai/integrations/windsurf)

## JLCPCB component categories in other agents

- [Amp](https://spiral.ai/integrations/amp/jlcpcb-component-categories)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/jlcpcb-component-categories)
- [Claude](https://spiral.ai/integrations/claude-desktop/jlcpcb-component-categories)
- [Claude Code](https://spiral.ai/integrations/claude-code/jlcpcb-component-categories)
- [Cline](https://spiral.ai/integrations/cline/jlcpcb-component-categories)
- [Codex](https://spiral.ai/integrations/codex/jlcpcb-component-categories)
- [Cursor](https://spiral.ai/integrations/cursor/jlcpcb-component-categories)
- [Devin](https://spiral.ai/integrations/devin/jlcpcb-component-categories)
- [dots](https://spiral.ai/integrations/dots/jlcpcb-component-categories)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/jlcpcb-component-categories)
- [Gemini](https://spiral.ai/integrations/gemini/jlcpcb-component-categories)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/jlcpcb-component-categories)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/jlcpcb-component-categories)
- [goose](https://spiral.ai/integrations/goose/jlcpcb-component-categories)
- [Grok](https://spiral.ai/integrations/grok/jlcpcb-component-categories)
- [Grok Build](https://spiral.ai/integrations/grok-build/jlcpcb-component-categories)
- [Hermes](https://spiral.ai/integrations/hermes/jlcpcb-component-categories)
- [Instinct](https://spiral.ai/integrations/instinct/jlcpcb-component-categories)
- [Manus](https://spiral.ai/integrations/manus/jlcpcb-component-categories)
- [Muse](https://spiral.ai/integrations/muse/jlcpcb-component-categories)
- [Muse Code](https://spiral.ai/integrations/muse-code/jlcpcb-component-categories)
- [n8n](https://spiral.ai/integrations/n8n/jlcpcb-component-categories)
- [Notion](https://spiral.ai/integrations/notion/jlcpcb-component-categories)
- [OpenClaw](https://spiral.ai/integrations/openclaw/jlcpcb-component-categories)
- [opencode](https://spiral.ai/integrations/opencode/jlcpcb-component-categories)
- [Perplexity](https://spiral.ai/integrations/perplexity/jlcpcb-component-categories)
- [Raycast](https://spiral.ai/integrations/raycast/jlcpcb-component-categories)
- [VS Code](https://spiral.ai/integrations/vscode/jlcpcb-component-categories)
- [Zapier](https://spiral.ai/integrations/zapier/jlcpcb-component-categories)

## More Windsurf guides

- [IronPlanet upcoming auctions](https://spiral.ai/integrations/windsurf/ironplanet-upcoming-auctions)
- [JLCPCB component details](https://spiral.ai/integrations/windsurf/jlcpcb-component-details)
- [IronPlanet equipment search suggestions](https://spiral.ai/integrations/windsurf/ironplanet-equipment-search-suggestions)
- [JLCPCB component search](https://spiral.ai/integrations/windsurf/jlcpcb-component-search)
- [IronPlanet equipment preview](https://spiral.ai/integrations/windsurf/ironplanet-equipment-preview)
- [JLCPCB component suggestions](https://spiral.ai/integrations/windsurf/jlcpcb-component-suggestions)

## Questions about JLCPCB component categories in Windsurf

**Can Windsurf use JLCPCB component categories?**

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run JLCPCB component categories like any built-in tool.

**How much does JLCPCB component categories cost in Windsurf?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Windsurf plan is separate.

**Do I need an Alexandria account to use JLCPCB component categories in Windsurf?**

No. Spiral runs JLCPCB component categories on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up JLCPCB component categories in Windsurf?**

About two minutes: add the server, then sign in, then check it.

**Does Windsurf wait while JLCPCB component categories runs?**

JLCPCB component categories runs in the background. Windsurf starts the run, checks on it and gives you the json when it's ready.

**Does a listed component mean JLCPCB has it in stock?**

JLCPCB distinguishes public warehouse stock from other sourcing routes. Its pre-order terms say those components become usable for assembly only after they arrive at the warehouse.

**How quickly can component availability change?**

JLCPCB says inventory may change each second. A stock count can therefore change between component selection and the assembly order.

**Does JLCPCB list every component I might need?**

JLCPCB acknowledges that a missing component may not have been listed yet. Its documentation provides a new-part request route for that situation.

**How is the component catalog organized?**

JLCPCB exposes a two-level category taxonomy. Category discovery helps identify the appropriate category and subcategory before searching for parts.

**How specific are the component descriptions?**

Descriptions can include electrical values and package details. For example, C1525 specifies 100 nF, 16 V, X7R, ±10% tolerance, and a 0402 package.

