Carrier Intelligence

Official6 toolsLive

by tanahak · HTML

Free FMCSA carrier background checks: authority, insurance, crashes, safety scores. 4.4M carriers.

Captured live from the server via tools/list.

lookup_carrier

Verify a US commercial trucking carrier by USDOT number or legal/DBA name. Returns identity, fleet size, authority status, insurance, recent authority events, and red flags. Data sourced from the FMCSA SAFER census, donated to the TATTOO Foundation by Carso Cybernetics from the SuperTrucker platform.

Parameters2

dot_number	any	optional	USDOT number. Provide either dot_number or name.
name	string	optional	Legal name or DBA name (case-insensitive substring match). Returns up to 10 matches.

Raw schema

{
  "type": "object",
  "properties": {
    "dot_number": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0
        },
        {
          "type": "string",
          "pattern": "^\\d+$"
        }
      ],
      "description": "USDOT number. Provide either dot_number or name."
    },
    "name": {
      "type": "string",
      "minLength": 2,
      "description": "Legal name or DBA name (case-insensitive substring match). Returns up to 10 matches."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

carrier_revocation_history

Full authority-history timeline for a carrier (revocations, grants, suspensions, transfers, etc.) by USDOT number. Returns event-type breakdown and a chronological timeline. Useful for spotting chameleon-carrier patterns and prior revocations.

Parameters2

dot_number	any	required	USDOT number
limit	integer	optional	Max events to return (default 50).

Raw schema

{
  "type": "object",
  "properties": {
    "dot_number": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0
        },
        {
          "type": "string",
          "pattern": "^\\d+$"
        }
      ],
      "description": "USDOT number"
    },
    "limit": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 200,
      "description": "Max events to return (default 50)."
    }
  },
  "required": [
    "dot_number"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

carrier_insurance_status

FMCSA insurance filings for a carrier — active 91X auto liability and other filing types — with insurer, coverage amount, and dates. Flags if no active insurance is on record.

Parameters1

dot_number

any

required

USDOT number

Raw schema

{
  "type": "object",
  "properties": {
    "dot_number": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0
        },
        {
          "type": "string",
          "pattern": "^\\d+$"
        }
      ],
      "description": "USDOT number"
    }
  },
  "required": [
    "dot_number"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

h2b_trucking_employers

DOL H-2B labor disclosure data filtered to trucking SOC codes (53-30xx). Filterable by state, SOC code, fiscal year, and employer name. H-2B is visa-tied employment, structurally close to debt bondage; the TATTOO Foundation surfaces this for driver protection and labor-coercion pattern detection.

Parameters5

state	string	optional	Two-letter US state code (employer state). Optional.
soc_code	string	optional	Specific SOC code (e.g., '53-3032.00' for heavy/tractor-trailer drivers). If omitted, returns all 53-30xx trucking codes.
fiscal_year	integer	optional	Filter to a specific federal fiscal year. Optional.
employer_name_contains	string	optional	Case-insensitive substring match on employer name. Optional.
limit	integer	optional	Max rows (default 50).

Raw schema

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "description": "Two-letter US state code (employer state). Optional."
    },
    "soc_code": {
      "type": "string",
      "description": "Specific SOC code (e.g., '53-3032.00' for heavy/tractor-trailer drivers). If omitted, returns all 53-30xx trucking codes."
    },
    "fiscal_year": {
      "type": "integer",
      "description": "Filter to a specific federal fiscal year. Optional."
    },
    "employer_name_contains": {
      "type": "string",
      "description": "Case-insensitive substring match on employer name. Optional."
    },
    "limit": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 500,
      "description": "Max rows (default 50)."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

carrier_safety_history

Crash record and roadside inspection history for a carrier by USDOT number. Returns crash totals (fatalities, injuries, tow-aways, hazmat), out-of-service rates vs national averages, violations broken down by BASIC category, and recent event lists. 24-month inspection window per FMCSA SMS methodology.

Parameters3

dot_number	any	required	USDOT number
crash_limit	integer	optional	Max recent crashes to list (default 20).
inspection_limit	integer	optional	Max recent inspections to list (default 20).

Raw schema

{
  "type": "object",
  "properties": {
    "dot_number": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0
        },
        {
          "type": "string",
          "pattern": "^\\d+$"
        }
      ],
      "description": "USDOT number"
    },
    "crash_limit": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100,
      "description": "Max recent crashes to list (default 20)."
    },
    "inspection_limit": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100,
      "description": "Max recent inspections to list (default 20)."
    }
  },
  "required": [
    "dot_number"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

carrier_safety_scores

Computed BASIC safety percentiles for a carrier by USDOT number — Unsafe Driving, HOS Compliance, Driver Fitness, Controlled Substances, Vehicle Maintenance, Hazmat Compliance. FMCSA SMS-style scores computed independently from public inspection data; flags intervention-threshold breaches. Percentile 0-100, higher = worse.

Parameters1

dot_number

any

required

USDOT number

Raw schema

{
  "type": "object",
  "properties": {
    "dot_number": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0
        },
        {
          "type": "string",
          "pattern": "^\\d+$"
        }
      ],
      "description": "USDOT number"
    }
  },
  "required": [
    "dot_number"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

mcp/README.md2 KBView on GitHub

TATTOO Foundation MCP Server

Public Model Context Protocol server published by the TATTOO Foundation at mcp.tattoo.foundation. This is the Foundation-branded carrier-intelligence surface — agents and AI clients reach the Foundation here as the publisher.

The dataset behind it was built by Carso Cybernetics on the SuperTrucker platform; query access was donated to the Foundation for free, public, driver-protective use. The same dataset also ships through:

mcp.supertrucker.ai (SuperTrucker product surface — SuperTrucker-Platform/packages/mcp)
mcp.carsocybernetics.com (Carso Cybernetics commercial surface — carso-site/mcp)

Each MCP exposes the same four tools with branded framing.

Tools

lookup_carrier(dot_number | name) — verify any US trucking carrier
carrier_revocation_history(dot_number) — full authority-history timeline
carrier_insurance_status(dot_number) — FMCSA insurance filings
h2b_trucking_employers(state?, soc_code?, fiscal_year?) — DOL H-2B trucking filings

Deploy (manual SSH-pull pattern)

bash

ssh -i ~/.ssh/supertrucker_spine root@198.199.85.122
cd /root/tattoo.foundation && git pull
cd mcp && npm install && npm run build
systemctl restart mcp-tattoo
journalctl -u mcp-tattoo -n 20 --no-pager

CI-driven deploy on push-to-main is queued for the next sprint.

Local dev

bash

npm install
DATABASE_URL=postgresql://... \
  JWT_PRIVATE_KEY_PATH=... \
  JWT_PUBLIC_KEY_PATH=... \
  JWT_KID=... \
  npm run build && node dist/server.js

The server binds to 127.0.0.1:4100 by default; Caddy fronts it for TLS.

Install

Tools (6)

lookup_carriercarrier_revocation_historycarrier_insurance_statush2b_trucking_employerscarrier_safety_historycarrier_safety_scores

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.tattoo.foundation/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "carrier-intelligence": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.tattoo.foundation/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.