carrierscore

CarrierScore MCP 服务

通过 Model Context Protocol 为 AI Agent 提供美国联邦汽车运输安全管理局（FMCSA）汽车承运商风险情报。

CarrierScore 为货运经纪人和 AI 订舱／调度 Agent 解答 “这家承运商的风险有多高？在某个日期，对它有哪些已知信息？”。它根据每日归档的 FMCSA／美国交通部公开安全数据，构建长期风险评分（0–100，分数越高风险越大）和带时间戳的承运商选择证据报告（“Montgomery 文件”）。数据包括普查、检查、事故、停运令、运营许可和保险备案。

网站： carrierscore.io · Agent 文档： carrierscore.io/llms.txt

托管端点（推荐）

无需安装——托管的 Streamable HTTP MCP 端点现已上线：

https://mcp.carrierscore.io/mcp

无密钥请求可使用受速率限制的免费层（查询、评分、文本证据报告）。付费层增加承运商列表监控、结构化 JSON 证据报告和更高的使用量，详见定价。付费层通过 X-API-Key 标头进行身份验证（自托管时使用 CARRIERSCORE_API_KEY）。

工具

工具	功能
carrier_lookup	根据美国 DOT 编号查询承运商身份：法定名称、DBA、运营状态、FMCSA 安全评级、车队规模、地址和注册日期。首先使用此工具，确认 DOT 编号真实有效，且与运价确认书一致。
carrier_score	CarrierScore 风险评分（0–100，分数越高风险越大），包含完整的组成部分明细、硬性标记（有效停运令、无有效保险、承运商转世关联）和数据充分性指标。
montgomery_file	带时间戳的承运商选择证据报告——经纪人在订舱时留存的记录文件（根据 Montgomery v. Caribe Transport II）。免费层提供文本格式；付费层提供 JSON 格式。
monitor_carriers	每次调用最多对 100 个 DOT 编号进行批量评分汇总并标记风险——可筛查货运任务的候选承运商，或重新检查现有承运商名单。

从客户端连接

Claude Code

claude mcp add --transport http carrierscore https://mcp.carrierscore.io/mcp

Claude Desktop / claude.ai

设置 → 连接器 → 添加自定义连接器 → URL https://mcp.carrierscore.io/mcp。

Cursor

.cursor/mcp.json：

{
  "mcpServers": {
    "carrierscore": {
      "url": "https://mcp.carrierscore.io/mcp"
    }
  }
}

通用 MCP 客户端（Streamable HTTP）

{
  "mcpServers": {
    "carrierscore": {
      "type": "streamable-http",
      "url": "https://mcp.carrierscore.io/mcp"
    }
  }
}

自托管

本仓库中的服务是一个精简的 Streamable HTTP 客户端，通过 CarrierScore REST API（https://api.carrierscore.io）工作。

npm install
npm run build
CARRIERSCORE_API_URL=https://api.carrierscore.io npm start
# MCP endpoint: POST http://127.0.0.1:8322/mcp

环境变量：

变量	默认值	用途
CARRIERSCORE_API_URL	http://127.0.0.1:8321	CarrierScore REST API 的基础 URL
CARRIERSCORE_API_KEY	(未设置)	付费层的可选 API 密钥；未设置时使用受速率限制的免费层
PORT	8322	MCP HTTP 端点（POST /mcp）的端口

免责声明

CarrierScore 评分是根据公开 FMCSA 数据，按照有文档记录且透明的方法（总体百分位数加硬性标记）计算出的统计指标。它们不是安全资质认定，未获 FMCSA 背书，也不能替代承运商的官方安全评级或您自己的判断。每项评分和证据报告都包含此免责声明——存储或引用结果时请保留免责声明。

许可证

MIT © SYMBOLIQ LLC。联系方式：[email protected]