Use Haulroll MCP with Cursor

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

Open or create the mcp.json file (global or per project).
Add the server under "mcpServers" as shown and save.
Open Cursor's settings, find the MCP section and check that the server is enabled and lists its tools.
Ask the agent a question the tools can answer and approve the tool call.

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "haulroll-api": {
      "url": "https://haulroll-api.cybermaxtools.com/mcp?via=use-with-cursor"
    }
  }
}

With a paid key:

{
  "mcpServers": {
    "haulroll-api": {
      "url": "https://haulroll-api.cybermaxtools.com/mcp?via=use-with-cursor",
      "headers": {
        "x-api-key": "${env:CYBERMAX_API_KEY}"
      }
    }
  }
}

Cursor fills ${env:CYBERMAX_API_KEY} from your environment, so the key never sits in the file.

Where it goes:

~/.cursor/mcp.json (every project)
.cursor/mcp.json (this project only)

Config format checked 2026-10-09 against Cursor'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

Cursor uses the top-level key "mcpServers" (VS Code uses "servers"); a file copied from VS Code will not load.
After editing the file, toggle the server off and on in settings if the tools do not appear.
The free tier has a daily limit (see the pricing line above); a paid key raises it.

Haulroll in other clients

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

More MCP servers for Cursor

All Haulroll setups · All Cursor setups · All