[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [FMCSA SAFER carrier search](https://spiral.ai/integrations/opencode/fmcsa-safer-carrier-search)

# How to Use FMCSA SAFER carrier search in opencode

Find carrier and trade-name matches with locations in SAFER. Use it to resolve a company name before requesting its snapshot; broad searches stop at 500 matches.

|  |  |
| --- | --- |
| Model | FMCSA SAFER carrier search |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with FMCSA SAFER carrier search in opencode

- Use FMCSA SAFER carrier search to find Schneider National Carriers and add the returned company matches and locations to our carrier review fixture.
- Use FMCSA SAFER carrier search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from FMCSA SAFER carrier search and tell me what changed since last week.
- Check FMCSA SAFER carrier search and summarize what you find in three bullet points.
- Pull the newest data from FMCSA SAFER carrier search and give me the result as a table.

## How to set up FMCSA SAFER carrier search in opencode

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

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

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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 FMCSA SAFER carrier 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": "safer-fmcsa-dot-gov/carriers/search_carriers",
    "input": {
      "name": "<name>"
    }
  }'
```

Then paste one of the prompts above: opencode finds FMCSA SAFER carrier search on Spiral, shows the price and runs it.

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

## FMCSA SAFER carrier search tools and prices

- [FMCSA SAFER and SMS carrier registry · Search carriers](https://spiral.ai/tools/alexandria/safer-fmcsa-dot-gov/carriers/search_carriers) (Alexandria): $0.00873 per call.

## What can you do with FMCSA SAFER carrier search in opencode?

Build a carrier review table that connects company identity, fleet size, and public safety evidence by USDOT number. Use name lookups to resolve business records before adding SAFER snapshots and SMS summaries to the project.

### Prepare a carrier onboarding review

Resolve a proposed carrier’s name with SMS suggestions and SAFER search, compare the SMS listing, and assemble its registration snapshot, safety overview, and supporting records for review.

### Compare carriers bidding for freight

Match bidder names to registered businesses, compare fleet sizes and public safety summaries, and examine records behind questions raised during the bid review.

### Separate similarly named transportation companies

Collect recognized name spellings and search matches, distinguish businesses by location and USDOT identifier, and prepare separate registration and safety reviews for each candidate.

### Review a changing carrier shortlist

Resolve names as businesses enter a procurement shortlist, then refresh their registration and public safety reviews. Inspect underlying events when a carrier’s summary changes.

### Correct a business carrier directory

Use name suggestions and search results to reconcile trade names, legal names, locations, and registered company profiles in a transportation business directory.

### Research fleet service prospects

Resolve public transportation business names, compare fleet sizes in SMS listings, and review registered cargo and operations information to identify companies relevant to a fleet service.

## Overview

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

## FMCSA SAFER carrier search in other agents

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

## More opencode guides

- [FCC test lab directory](https://spiral.ai/integrations/opencode/fcc-test-lab-directory)
- [FMCSA SAFER carrier snapshot](https://spiral.ai/integrations/opencode/fmcsa-safer-carrier-snapshot)
- [FCC grantee search](https://spiral.ai/integrations/opencode/fcc-grantee-search)
- [FMCSA SMS carrier name suggestions](https://spiral.ai/integrations/opencode/fmcsa-sms-carrier-name-suggestions)
- [FCC equipment grant](https://spiral.ai/integrations/opencode/fcc-equipment-grant)
- [FMCSA SMS carrier safety overview](https://spiral.ai/integrations/opencode/fmcsa-sms-carrier-safety-overview)

## Questions about FMCSA SAFER carrier search in opencode

**Can opencode use FMCSA SAFER carrier search?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run FMCSA SAFER carrier search like any built-in tool.

**How much does FMCSA SAFER carrier search cost in opencode?**

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

**Do I need an Alexandria account to use FMCSA SAFER carrier search in opencode?**

No. Spiral runs FMCSA SAFER carrier 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 FMCSA SAFER carrier search in opencode?**

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

**Does opencode wait while FMCSA SAFER carrier search runs?**

FMCSA SAFER carrier search runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

**How often does FMCSA update the data?**

FMCSA documents daily updates for the SAFER Company Snapshot and monthly updates for SMS. SMS search results and safety summaries therefore reflect a monthly snapshot.

**How much safety history does SMS summarize?**

The SMS overview summarizes 24 months of inspections and crash history. It also lists the five most recent investigations.

**Are all property-carrier safety results public?**

No. The Crash Indicator and Hazardous Materials Compliance BASICs remain hidden from the public property-carrier view.

**Why might a broad carrier-name search miss a company?**

SAFER returns a maximum of 500 name matches. If results are truncated, narrow the company name and search again.

**Do listed crashes establish that the carrier was responsible?**

No. SAFER reports a carrier’s involvement in reportable crashes without determining responsibility.

