X3 Compliance MCP Server

Give your AI assistant real safety and compliance tools. A free Model Context Protocol server that lets Claude, ChatGPT, Cursor, VS Code and other MCP clients check a driver's hours of service and qualification file, explain CSA scores, run DOT random selections, decide whether an injury is OSHA recordable, read safety data sheets, work out when an 811 ticket allows digging, compute pipeline MAOP, check mariner rest hours, quote any federal regulation from the official eCFR, and pull a vessel's Coast Guard record. Every answer comes from the rule text or official government data and cites it.

Built and maintained by X3: X3 Fleet Safety · X3 Workplace Safety · X3 Pipeline · X3 Maritime.

Setup page →

Tools

Tool	What it does	Source
hos_check	Every hours-of-service violation in a driver log, and time left to drive	49 CFR 395 (x3-hos-engine)
osha_is_recordable	300 Log or not, column, privacy case, 8/24-hour OSHA report	29 CFR 1904 (x3-osha-recordkeeping)
osha_coverage	Must the employer keep records and file with OSHA's ITA; due dates	29 CFR 1904.1, .2, .41
osha_rates	TRIR, DART and days-away rates	BLS formula
osha_hearing_shift	Standard Threshold Shift and 25 dB test, optional age correction	29 CFR 1904.10, 1910.95 App. F
dig_clock_811	Earliest legal dig time, utility deadline, ticket expiry (MI, OH, TX)	State one-call law (x3-811-tickets)
parse_811_ticket	Fields, members and coordinates from a ticket email
cfr_lookup	Text of any CFR citation, paragraph by paragraph	eCFR (x3-ecfr-toolkit)
cfr_search	Full-text search of the CFR	eCFR
cfr_changes	Amendments to a part since a date; paragraph diff of a section	eCFR
uscg_vessel_search	Find a vessel in Coast Guard records	USCG PSIX (x3-uscg-psix)
uscg_vessel_profile	Certificates with days left, inspections, deficiencies, flags	USCG PSIX
dq_file_check	Driver qualification file: missing, late, expiring, qualified to drive today	49 CFR 391.51, 391.23, 391.25, 382.701 (x3-dq-file)
dot_random_testing	Random test counts for the year and period, and an unbiased auditable draw	49 CFR 382.305 (x3-dot-random)
csa_explain	CSA BASIC measures from inspections: what drives them, when they drop off	FMCSA SMS methodology (x3-csa-explainer)
osha_state_jurisdiction	Federal OSHA or a State Plan (MIOSHA, Cal/OSHA...) for this employer	29 CFR 1952 (x3-osha-state-plans)
sds_check	Read and check a safety data sheet; workplace label	29 CFR 1910.1200 App. D (x3-sds-reader)
pipeline_design_and_maop	Class location, design pressure, MAOP, % SMYS, impact radius	49 CFR 192 (x3-pipeline-calcs)
mariner_rest_check	STCW hours of rest and the 12-hour towing limit	46 CFR 15.1111, 46 U.S.C. 8104(h) (x3-rest-hours)
us_federal_holidays	Observed federal holidays for a year	5 U.S.C. 6103

All tools are read-only. Nothing about your questions is sent anywhere except the public government APIs the CFR and Coast Guard tools call (ecfr.gov and cgmix.uscg.mil).

Install

Remote server (no install): add https://mcp.x3api.com/mcp as a custom connector in Claude (Settings → Connectors) or any client that supports remote MCP servers.

Claude Desktop, one click: download x3-compliance.mcpb and open it (or drag it into Settings → Extensions). Also listed in the MCP Registry as io.github.x3allamerican/x3-compliance-mcp.

Or run it with npx (Node.js 22.6 or later):

Claude Desktop (Settings → Developer → Edit Config), Cursor (~/.cursor/mcp.json) and most clients:

{
  "mcpServers": {
    "x3-compliance": {
      "command": "npx",
      "args": ["-y", "github:x3allamerican/x3-compliance-mcp"]
    }
  }
}

Claude Code:

claude mcp add x3-compliance -- npx -y github:x3allamerican/x3-compliance-mcp

VS Code (.vscode/mcp.json):

{ "servers": { "x3-compliance": { "type": "stdio", "command": "npx", "args": ["-y", "github:x3allamerican/x3-compliance-mcp"] } } }

Then ask things like:

• "Here's my driver's log for Monday and Tuesday. Any hours-of-service violations?"
• "An employee cut his hand, got 4 stitches and was back the next day. Is it OSHA recordable?"
• "We called in an 811 ticket in Ohio at 3 p.m. Monday. When can we dig?"
• "Quote 49 CFR 192.605(b) and tell me what changed in Part 192 since 2024."
• "Is the Certificate of Inspection current for the towboat ...?"

Use as a library

import { createServer } from '@x3/compliance-mcp';
const server = createServer();
await server.handle({ jsonrpc: '2.0', id: 1, method: 'tools/list' });

The server is dependency-free: JSON-RPC 2.0 over stdio, protocol versions 2025-06-18, 2025-03-26 and 2024-11-05. The engines are vendored in vendor/ from the X3 repos (node scripts/vendor.mjs .. refreshes them).

Privacy

No accounts and no stored data. See the privacy policy.

Limits

Decision support, not legal advice. Federal rules plus the three built-in 811 states. Ask your assistant to show the citation, and check it.

Develop

npm install
npm test             # in-process protocol and tool tests
MCP_E2E=1 npm test   # also runs the built binary over stdio
npm run build

License

MIT. Free for any use, including commercial.