FMCSA Carrier Vetting

io.github.santex85由 GitHub 帳號 santex85 發布v0.1.0更新於 Nov 19, 2026

Vet US motor carriers and brokers from FMCSA open data: authority, insurance, OOS, safety.

發布方自己的服務:Carrier

已驗證STDIO僅桌面資料與分析商業與電商

概覽

AI 產生的概覽

以 FMCSA 公開資料查核美國汽車運輸業者與經紀人:查詢、名稱搜尋、營業權與保險合規檢查,以及啟發式詐欺風險標記。

可以做什麼
  • 依 USDOT 或 MC/FF/MX 編號查詢業者檔案,含狀態、登記項目、地址、車隊規模與安全評等
  • 依法定名稱或 DBA 名稱搜尋業者,可依州、城市、僅營業中、僅營業性運輸篩選
  • 檢視完整營業權與保險合規情形:各類營業權及狀態、已登記的 BIPD/貨物險/保證金、核發日期、取消紀錄、撤銷與停駛命令,以及 24 個月檢查與事故次數
  • 執行啟發式詐欺/風險篩檢,回傳依嚴重度編碼的標記、分數與風險等級
適用情境
適合貨運經紀商、託運人與第三方物流在派車前確認業者身分、是否持有有效營業權與保險,以及是否有詐欺跡象。
執行需求
以本機 Python 程序執行(stdio 或 streamable HTTP);README 說明需建立虛擬環境並安裝相依套件,清單另提供 mcpb 套件。不需 API 金鑰或登入,直接查詢 data.transportation.gov 上的 FMCSA 開放資料集。可選環境變數 HOST、PORT、MCP_TRANSPORT。需要網路連線。
安裝前請注意
風險標記僅為啟發式判斷,並非詐欺認定,應撥打 FMCSA 列出的電話確認。資料可能比 SAFER/L&I 即時頁面落後一天以上,檢查與事故數字為原始計數,並非官方 SMS 百分位。大量正式流量可能觸發匿名 Socrata 限流。僅回傳 FMCSA 公開的企業聯絡資訊。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 FMCSA Carrier Vetting,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

FMCSA Carrier Vetting MCP server

An MCP server for freight brokers, shippers and 3PLs that need to vet US motor carriers and brokers before tendering a load. It answers "who is this carrier, are they allowed to haul, are they insured, and does anything look like fraud?" in one call. It uses FMCSA's own open data on data.transportation.gov (Socrata SODA API, no key, no login).

Tools

ToolWhat it does
lookup_carrierCompany profile by USDOT or MC/FF/MX number: legal/DBA name, USDOT status, entity class, dockets, address, business phone, power units, drivers, cargo types, MCS-150 date, safety rating, prior-revocation flag, and an operating-authority summary
search_carriersName search (legal or DBA, substring) with state, city, active-only and for-hire-only filters, up to 100 rows, largest fleets first
check_authorityFull compliance view: every authority (carrier/broker/HHG/passenger) with status, BIPD required vs on file, cargo/bond, authority grant dates and status history, insurance filings, cancellations, revocation/suspension orders, out-of-service orders, plus 24-month inspection and crash counts
red_flagsHeuristic fraud/risk screen with severity, evidence and a risk level (see below)

Example calls

jsonc
// lookup_carrier{"usdot": "80806"}{"mc_number": "MC-136818"}          // also "MC136818", "136818", "FF-51075"
// search_carriers{"name": "swift transportation", "state": "AZ", "active_only": true, "limit": 10}{"name": "express", "state": "TX", "city": "HOUSTON", "for_hire_only": true}
// check_authority{"usdot": "80806"}
// red_flags{"mc_number": "MC-1589648"}

Sample red_flags output for a carrier whose authority was granted the day before:

json
{"usdot": "6951245", "riskLevel": "high", "score": 80, "flags": [{"severity": "high", "code": "NEW_USDOT", "message": "USDOT number added 14 days ago"},           {"severity": "high", "code": "NEW_AUTHORITY", "message": "Oldest operating-authority grant on record is only 1 days old"}]}

Red-flag checks

CodeSeveritySignal
NOT_FOUND, USDOT_INACTIVEhighUSDOT unknown or not active
NO_ACTIVE_AUTHORITYhigh (low for private/intrastate entities)no active MC/FF/MX authority
NEW_AUTHORITY, NEW_USDOThigh < 90 days, medium < 180 daysfreshly created identity, typical of fraud
PENDING_REVOCATION, RECENT_INVOLUNTARY_SUSPENSIONhigh / mediumFMCSA orders not yet effective; suspensions in the last 12 months
OUT_OF_SERVICE / PAST_OUT_OF_SERVICEhigh / lowFMCSA OOS order in effect / rescinded
INSURANCE_MISSING, INSURANCE_CANCELLATION_PENDING, INSURANCE_CHURNhigh / high / mediumBIPD below required, cargo or bond missing, future cancellation, 2+ cancellations in 12 months
PRIOR_REVOCATIONhighFMCSA census prior-revocation flag (possible "chameleon" carrier)
SHARED_PHONE, SHARED_ADDRESShigh/medium/lowthe census phone or physical address appears on other USDOTs (downgraded for fleets of 100+ trucks, whose affiliates share numbers)
NAME_MISMATCH, ADDRESS_MISMATCHlowCompany Census vs Motus L&I record differ
STALE_MCS150low/mediumMCS-150 older than 2 / 3 years
UNSATISFACTORY_RATING, CONDITIONAL_RATINGhigh / mediumFMCSA safety rating
NO_POWER_UNITS, HIGH_OOS, NO_INSPECTIONSmedium / medium / lowcarrier authority with 0 trucks; many OOS violations; no inspections despite 5+ trucks

Score: high = 40, medium = 15, low = 5, capped at 100. Risk level is high if any high flag (or score ≥ 60), medium if score ≥ 15, otherwise low. These are heuristics, not a finding of fraud. Always confirm by calling the phone number FMCSA lists, not the one in an e-mail.

Data sources

All are FMCSA datasets on data.transportation.gov, read live per call (nothing is downloaded or cached except the per-dataset "last updated" timestamp, kept 1 hour):

DatasetIdUsed for
Company Census Fileaz4n-8mr2profile, search, shared phone/address
Motus Carrier - All With Historyinys-ebihoperating authority per type, BIPD/cargo/bond on file
Motus AuthHist - All With Historyyu5v-wbh6grant dates, status changes
Motus Insur - All With Historyc5y8-a4uzactive/pending insurance filings
Motus InsHist - All With History3uet-3z4iinsurance cancellations
Motus RevokeSuspend - All With Historywb4f-nekirevocation/suspension orders
Out Of Service Ordersp2mt-9igeOOS orders
Vehicle Inspection Filefx4q-ay7w24-month inspection/OOS counts
Crash Fileaayw-vxb324-month crash counts
AuthHist - All With History (legacy L&I)9mw4-x3tugrant dates before the Motus migration

Freshness. Every response has a dataFreshness list with each dataset's rowsUpdatedAt. FMCSA refreshes these daily (all were updated 2026-11-17 when this was built). Data can lag the live SAFER / L&I web pages by a day or more. Motus is FMCSA's current registration system. The legacy L&I files are still published, but the legacy authority history has no new actions after about May 2026, so this server reads authority and insurance from the Motus files and uses the legacy history only for older grant dates.

Terms / licence. The datasets carry no explicit licence field on data.transportation.gov. They are US federal government works published as open data, generally public domain in the US (17 U.S.C. § 105); this was not confirmed against a dataset-specific licence. No key is used. Socrata throttles anonymous clients, so for heavy production traffic register a free Socrata app token (not used here). The optional FMCSA QCMobile API needs a webKey via login.gov and is not used.

Privacy. Only what FMCSA publishes is returned, with no enrichment. The census file also contains company officer names, e-mail addresses and cell phones. This server deliberately leaves those out and returns only the business phone and addresses that the SAFER Company Snapshot shows.

Limits

  • 90 s timeout per tool call, 45 s per HTTP request, 2 retries on 429/5xx.
  • search_carriers: name of 3+ characters, at most 100 results (scans up to 500 matches to sort by fleet size).
  • History lists are capped (50 status changes, 50 insurance filings, 25 cancellations, 50 orders, 10 shared-contact examples).
  • Inspection/crash numbers are raw counts from FMCSA files, not the official SMS BASIC percentiles.
  • One SODA query per dataset per call; red_flags and check_authority make about 10 to 13 requests and usually take 5 to 12 s.

Run

bash
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt.venv/bin/python src/server.py                         # streamable-http on 0.0.0.0:8080, endpoint /mcp, GET /healthPORT=8094 .venv/bin/python src/server.py               # other portMCP_TRANSPORT=stdio .venv/bin/python src/server.py     # stdio, for local MCP clients.venv/bin/python tests/live_test.py                    # live test of every tool

Environment variables: HOST (default 0.0.0.0), PORT (default 8080), MCP_TRANSPORT (streamable-http, stdio or sse; default streamable-http). No API key is needed.

mcpize.yaml is included for MCPize (runtime: python, startCommand.type: http).

Use with Claude Desktop or another MCP client

Local (stdio). Clone the repo, create the venv as above, then add this to claude_desktop_config.json (or your client's MCP config), with the paths changed to where you cloned it:

json
{  "mcpServers": {    "fmcsa-carrier": {      "command": "/path/to/fmcsa-carrier-mcp/.venv/bin/python",      "args": ["/path/to/fmcsa-carrier-mcp/src/server.py"],      "env": {"MCP_TRANSPORT": "stdio"}    }  }}

Remote (streamable HTTP). Run .venv/bin/python src/server.py on a server and point any client that supports remote MCP servers at http://<host>:8080/mcp. GET /health returns {"status": "healthy"}.

License

MIT, see LICENSE. The data returned by the tools stays under the terms of its sources (see above).

來源:README.md,提交 72d3f91

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.1.0最新Nov 19, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Carrier 整合