[Integrations](https://spiral.ai/integrations) › [Hermes](https://spiral.ai/integrations/hermes) › [CPSC recall search](https://spiral.ai/integrations/hermes/cpsc-recall-search)

# How to Use CPSC recall search in Hermes

Find CPSC recall records matching product names, titles, descriptions, or businesses involved. Use it to discover relevant notices before checking the affected models and remedy instructions in detail.

|  |  |
| --- | --- |
| Model | CPSC recall 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 CPSC recall search in Hermes

- Every weekday, use CPSC recall search to find notices mentioning Peloton. Report newly discovered notices with their titles, recall dates, descriptions, and source links.
- Each week, use CPSC recall search to check for notices with IKEA in the title. Include only notices not already included in the previous digest.
- Every weekday, use CPSC recall search to find stroller notices mentioning Graco in the description. Report newly discovered notices and include the descriptions needed to assess the affected products.
- Every Monday at 9am: use CPSC recall search to look this up and give me the result as a table.
- Pull the latest numbers from CPSC recall search and tell me what changed since last week.

## How to set up CPSC recall search in Hermes

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

### Use the Spiral skill

1. **Send Hermes 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 Spiral's MCP server

1. **Add the server and sign in**: Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.

```bash
hermes mcp add spiral \
  --url https://api.spiral.ai/mcp \
  --auth oauth \
  --connect-timeout 300
```

2. **Check it**: In a chat that was already open, run `/reload-mcp`.

```bash
hermes mcp list
hermes mcp test spiral
```

### 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 CPSC recall 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": "saferproducts-gov/product-recalls/search_recalls",
    "input": {
      "limit": 25
    }
  }'
```

Then paste one of the prompts above: Hermes finds CPSC recall search on Spiral, shows the price and runs it.

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

## CPSC recall search tools and prices

- [CPSC Recalls (SaferProducts.gov) · Search recalls](https://spiral.ai/tools/alexandria/saferproducts-gov/product-recalls/search_recalls) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| limit | 1 to 100 | 25 | Recalls per page. |
| title |  | — | Case-insensitive substring of the recall title (CPSC RecallTitle). |
| cursor |  | — | Continuation from a previous page (meta.page.next_cursor): the offset of the next recall. Pattern: ^[0-9]+$. |
| importer |  | — | Substring of an importer name. |
| retailer |  | — | Substring of the retailer text (where sold), e.g. Walmart, Amazon. |
| description |  | — | Substring of the recall description. |

## What can you do with CPSC recall search in Hermes?

Maintain a recall review digest for a business's consumer product inventory. Revisit relevant CPSC notices to surface changed remedy instructions as well as newly discovered recalls.

### Review resale inventory

Find recall notices for products offered by a resale business, then compare the descriptions and models with inventory before deciding which listings need review.

### Prepare a product support brief

Find a product's recall notices and assemble the hazard, affected product description, remedy instructions, and consumer contact information for support staff.

### Check equipment before purchasing

Review CPSC notices for exercise equipment, furniture, or appliances under consideration, using the detailed descriptions to compare the offered models.

### Monitor remedy changes

Find relevant recalls and revisit their notices on a schedule to identify changes in remedy instructions or consumer contact information.

### Research product hazards

Collect notices for a product category and compare the hazards, reported incidents, and affected unit counts described in those notices.

### Draft a recall explainer

Find the relevant CPSC announcement and turn its product description, hazard, remedy, and source link into a factual brief for an editor to review.

## Overview

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

## CPSC recall search in other agents

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

## More Hermes guides

- [CPSC recall details](https://spiral.ai/integrations/hermes/cpsc-recall-details)
- [CarGurus car makes](https://spiral.ai/integrations/hermes/cargurus-car-makes)
- [CARFAX vehicle listing details](https://spiral.ai/integrations/hermes/carfax-vehicle-listing-details)
- [CarGurus car models](https://spiral.ai/integrations/hermes/cargurus-car-models)
- [CARFAX car listings search](https://spiral.ai/integrations/hermes/carfax-car-listings-search)
- [CarGurus model owner reviews](https://spiral.ai/integrations/hermes/cargurus-model-owner-reviews)

## Questions about CPSC recall search in Hermes

**Can Hermes use CPSC recall search?**

Yes. Add Spiral to Hermes as an MCP server, and Hermes can find and run CPSC recall search like any built-in tool.

**How much does CPSC recall search cost in Hermes?**

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

**Do I need an Alexandria account to use CPSC recall search in Hermes?**

No. Spiral runs CPSC recall 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 CPSC recall search in Hermes?**

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

**Does Hermes wait while CPSC recall search runs?**

CPSC recall search runs in the background. Hermes starts the run, checks on it and gives you the json when it's ready.

**How far back does CPSC recall history go?**

CPSC makes recall data available from 1973 forward. That history is useful when checking older consumer products offered for resale.

**Does this cover food, medicines, and car recalls?**

CPSC's jurisdiction excludes foods, drugs, medical devices, and motor vehicles, among other categories. These records cover recalls within CPSC's consumer product jurisdiction.

**Can recall details change after the announcement?**

Yes. CPSC says remedy data may change daily as company operating status or remedy availability changes.

**Does every recall have a UPC?**

No. CPSC includes UPC codes when they are available, so barcode matching alone cannot cover every recall.

**Are search matches exact product matches?**

CPSC documents case-insensitive wildcard matching, including matches within words. Check the returned product description and model information before treating a search result as a product match.

