Use Haulroll MCP with Claude Code

FMCSA carrier vetting API + MCP: authority, insurance, OOS. Keys $19/mo; 50 free calls/day.

Remote MCP server (Streamable HTTP), nothing to install. Free: 50 free calls/day · Paid: Keys $19/mo

Set it up

Run the command in your terminal (add --scope user to use it in every project, or --scope project to write .mcp.json).
Start Claude Code and type /mcp to see the server and its tools.
Ask a question the tools can answer; Claude Code asks permission before each tool call unless you allow it.

Run:

claude mcp add --transport http haulroll-api 'https://haulroll-api.cybermaxtools.com/mcp?via=use-with-claude-code'

Or share it with your team in .mcp.json (project scope)::

{
  "mcpServers": {
    "haulroll-api": {
      "type": "http",
      "url": "https://haulroll-api.cybermaxtools.com/mcp?via=use-with-claude-code"
    }
  }
}

With a paid key:

claude mcp add --transport http haulroll-api 'https://haulroll-api.cybermaxtools.com/mcp?via=use-with-claude-code' \
  --header "x-api-key: YOUR_KEY"

In .mcp.json, ${CYBERMAX_API_KEY} is read from the environment so the key is not committed.

Where it goes:

stored by the CLI: local scope (default, you in this project), project scope (.mcp.json, shared), user scope (you, every project)

Config format checked 2026-10-09 against Claude Code's MCP documentation.

Tools you get

Endpoint checked 2026-10-09: https://haulroll-api.cybermaxtools.com/mcp answered an MCP initialize (protocol 2025-06-18) and tools/list with 3 tools, all marked read-only. No key was used and no tool was called.

Tool	What it does	Required inputs
`vet_carriers`	Verdict for 1-25 US motor carriers by USDOT or MC/MX/FF number: USDOT status and age, operating authority, liability insurance on file vs required, out-of-service orders, 24-month inspections (driver/vehicle OOS rates vs national) and crashes, with flags. Riskiest first.	`carriers`
`carrier_alerts`	FMCSA events in the last N days for up to 25 carriers: out-of-service orders, authority suspension notices and status changes, insurance cancellations. Empty = nothing new.	`carriers`
`new_carriers`	Carriers FMCSA added in the last N days (active only), filterable by state, cargo, hazmat, interstate and for-hire. Company facts only.	none

Test the endpoint from a terminal

This lists the tools without a key and without calling any of them:

curl -s https://haulroll-api.cybermaxtools.com/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

If it does not work

If a project-scoped server does not load, Claude Code asks you to approve servers from .mcp.json the first time.
The free tier has a daily limit (see the pricing line above); a paid key raises it.

Haulroll in other clients

Cursor VS Code (GitHub Copilot)Claude Desktop and claude.ai Windsurf (Devin Desktop)Cline OpenAI Codex CLI Gemini CLI

More MCP servers for Claude Code

All Haulroll setups · All Claude Code setups · All