# X3 Compliance MCP Server

**Give your AI assistant real safety and compliance tools.** A free [Model Context Protocol](https://modelcontextprotocol.io) 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](https://x3fleetsafety.com) · [X3 Workplace Safety](https://x3workplacesafety.com) · [X3 Pipeline](https://x3pipeline.com) · [X3 Maritime](https://x3maritime.com).

**[Setup page →](https://x3allamerican.github.io/x3-compliance-mcp/)**

## 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](https://github.com/x3allamerican/x3-hos-engine)) |
| `osha_is_recordable` | 300 Log or not, column, privacy case, 8/24-hour OSHA report | 29 CFR 1904 ([x3-osha-recordkeeping](https://github.com/x3allamerican/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](https://github.com/x3allamerican/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](https://github.com/x3allamerican/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](https://github.com/x3allamerican/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](https://github.com/x3allamerican/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](https://github.com/x3allamerican/x3-dot-random)) |
| `csa_explain` | CSA BASIC measures from inspections: what drives them, when they drop off | FMCSA SMS methodology ([x3-csa-explainer](https://github.com/x3allamerican/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](https://github.com/x3allamerican/x3-osha-state-plans)) |
| `sds_check` | Read and check a safety data sheet; workplace label | 29 CFR 1910.1200 App. D ([x3-sds-reader](https://github.com/x3allamerican/x3-sds-reader)) |
| `pipeline_design_and_maop` | Class location, design pressure, MAOP, % SMYS, impact radius | 49 CFR 192 ([x3-pipeline-calcs](https://github.com/x3allamerican/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](https://github.com/x3allamerican/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](https://github.com/x3allamerican/x3-compliance-mcp/releases/latest/download/x3-compliance.mcpb) and open it (or drag it into Settings → Extensions). Also listed in the [MCP Registry](https://registry.modelcontextprotocol.io) 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:

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

**Claude Code:**

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

**VS Code** (`.vscode/mcp.json`):

```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

```ts
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](https://x3allamerican.github.io/x3-compliance-mcp/privacy.html).

## 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

```sh
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.