[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Supermicro product search](https://spiral.ai/integrations/codex/supermicro-product-search)

# How to Use Supermicro product search in Codex

Returns matching servers and parts from the Supermicro US eStore catalog. Use it to find candidate models before inspecting an exact product or exploring a server's configuration.

|  |  |
| --- | --- |
| Model | Supermicro product search |
| 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 Supermicro product search in Codex

- Use Supermicro product search to find 1U AMD EPYC servers, then add the matching model names and product links to our hardware shortlist.
- Use Supermicro product search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Supermicro product search and tell me what changed since last week.
- Check Supermicro product search and summarize what you find in three bullet points.
- Pull the newest data from Supermicro product search and give me the result as a table.

## How to set up Supermicro product search in Codex

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

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex 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 Supermicro product search**: 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": "store-supermicro-com/products/search_products",
    "input": {
      "query": "<query>"
    }
  }'
```

Then paste one of the prompts above: Codex finds Supermicro product search on Spiral, shows the price and runs it.

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

## Supermicro product search tools and prices

- [Supermicro eStore · Search products](https://spiral.ai/tools/alexandria/store-supermicro-com/products/search_products) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| page | 1 to 100 | 1 | page |
| page_size | 1 to 50 | 20 | page_size |

## What can you do with Supermicro product search in Codex?

Turn a project's server requirements into a comparison of Supermicro eStore products and proposed builds. A coding agent can use the repository's hardware requirements to organize product specifications, selectable components, and configuration calculations.

### Compare virtualization node builds

Find candidate rack servers, inspect their specifications, check selectable memory and networking, and evaluate matching builds for a virtualization hardware decision.

### Plan a storage server

Find storage candidates, compare advertised bay capacity with the selected chassis layout, inspect drive choices, and evaluate the resulting build. Include controller and cable requirements in the review.

### Compare Intel and AMD proposals

Find Xeon and EPYC systems, inspect their specifications, select comparable memory and storage where offered, and compare the resulting configuration totals.

### Review an AI inference hardware shortlist

Find candidate servers, inspect their published specifications, check which accelerator and networking choices the store offers, and evaluate the selected builds for a hardware review.

### Resolve model names in a hardware shortlist

Search model names from an existing shortlist and inspect the matching product records so reviewers can distinguish systems, individual parts, and differently named configurations.

## Overview

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

## Supermicro product search in other agents

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

## More Codex guides

- [Supermicro product details](https://spiral.ai/integrations/codex/supermicro-product-details)
- [Supermicro server configuration options](https://spiral.ai/integrations/codex/supermicro-server-configuration-options)
- [StockX recent product sales](https://spiral.ai/integrations/codex/stockx-recent-product-sales)
- [Supermicro server configuration total](https://spiral.ai/integrations/codex/supermicro-server-configuration-total)
- [StockX product search](https://spiral.ai/integrations/codex/stockx-product-search)
- [Target homepage products](https://spiral.ai/integrations/codex/target-homepage-products)

## Questions about Supermicro product search in Codex

**Can Codex use Supermicro product search?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Supermicro product search like any built-in tool.

**How much does Supermicro product search cost in Codex?**

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

**Do I need an Alexandria account to use Supermicro product search in Codex?**

No. Spiral runs Supermicro product search on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Supermicro product search in Codex?**

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

**Does Codex wait while Supermicro product search runs?**

Supermicro product search runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

**Which regional catalog does this data cover?**

It covers Supermicro's US eStore. The storefront states that its items can only be delivered within the United States.

**Does the source include individual parts?**

Yes. The documented catalog scope includes servers and parts, with individual product specifications as well as server configuration tools.

**How often does Supermicro update the information?**

Supermicro makes no commitment to update its site materials, products, or services. Its published terms therefore provide no guaranteed refresh schedule.

**Does a server's maximum capacity describe its starting build?**

The eStore distinguishes defaults from supported capacity. For example, SYS-112H-TN defaults to eight drive bays while its description lists support for up to 12 drives.

**Does public access allow unrestricted reuse of the catalog?**

Supermicro's single-copy license limits downloaded materials to personal, internal, noncommercial use. Written permission or applicable accompanying license terms can provide different rights.

