[Integrations](https://spiral.ai/integrations) › [Claude Code](https://spiral.ai/integrations/claude-code) › [FMCSA SAFER carrier snapshot](https://spiral.ai/integrations/claude-code/fmcsa-safer-carrier-snapshot)

# How to Use FMCSA SAFER carrier snapshot in Claude Code

Get a carrier’s registration, fleet size, cargo, inspection summary, crash counts, and safety rating when available. Use it to check company identity and registration alongside its safety record.

|  |  |
| --- | --- |
| Model | FMCSA SAFER carrier snapshot |
| 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 snapshot in Claude Code

- Use FMCSA SAFER carrier snapshot for USDOT 264184 and build a registration summary component using the returned fleet, cargo, and safety information.
- Use FMCSA SAFER carrier snapshot 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 snapshot and tell me what changed since last week.
- Check FMCSA SAFER carrier snapshot and summarize what you find in three bullet points.
- Pull the newest data from FMCSA SAFER carrier snapshot and give me the result as a table.

## How to set up FMCSA SAFER carrier snapshot in Claude Code

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

### Use Spiral's MCP server

1. **Add the hosted server**: This adds Spiral to the current project. Add `--scope user` to use it in every project.

```bash
claude mcp add --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `claude`, type `/mcp`, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.

### Use the Spiral skill

1. **Send Claude Code 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 snapshot**: 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/get_carrier_snapshot",
    "input": {
      "mc_mx_number": "<mc_mx_number>"
    }
  }'
```

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

Setup guide in the docs: https://spiral.ai/docs/quickstarts/claude-code

## FMCSA SAFER carrier snapshot tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| mc_mx_number |  | — | MC or MX docket number, digits with an optional MC-/MX- prefix (`MC-138328` or `138328`). One of usdot_number or mc_mx_number. |
| usdot_number |  | — | USDOT number (digits), or a SAFER query.asp / SMS /SMS/Carrier/{dot}/ URL. One of usdot_number or mc_mx_number. |

## What can you do with FMCSA SAFER carrier snapshot in Claude Code?

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.

### Explain the evidence behind a carrier review

Pair the registration and safety summaries with supporting inspection, violation, and crash records so a reviewer can see which events prompted follow-up questions.

### 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 Claude Code guides](https://spiral.ai/integrations/claude-code)

## FMCSA SAFER carrier snapshot in other agents

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

## More Claude Code guides

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

## Questions about FMCSA SAFER carrier snapshot in Claude Code

**Can Claude Code use FMCSA SAFER carrier snapshot?**

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

**How much does FMCSA SAFER carrier snapshot cost in Claude Code?**

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

**Do I need an Alexandria account to use FMCSA SAFER carrier snapshot in Claude Code?**

No. Spiral runs FMCSA SAFER carrier snapshot 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 snapshot in Claude Code?**

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

**Does Claude Code wait while FMCSA SAFER carrier snapshot runs?**

FMCSA SAFER carrier snapshot runs in the background. Claude Code 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.

