io.carrierscore/carrierscore
FMCSA motor-carrier risk scores, monitoring, and carrier-selection evidence reports for AI agents.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http carrierscore 'https://mcp.carrierscore.io/mcp'
{
"mcpServers": {
"carrierscore": {
"type": "http",
"url": "https://mcp.carrierscore.io/mcp"
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
CarrierScore MCP Server
FMCSA motor-carrier risk intelligence for AI agents, over the Model Context Protocol.
CarrierScore answers "how risky is this carrier, and what was knowable about it on a given date?" for freight brokers and AI booking/dispatch agents. It builds longitudinal risk scores (0–100, higher = riskier) and timestamped carrier-selection evidence reports ("Montgomery files") from daily archives of public FMCSA / US DOT safety data: census, inspections, crashes, out-of-service orders, operating authority, and insurance filings.
Website: carrierscore.io · Agent docs: carrierscore.io/llms.txt
Hosted endpoint (recommended)
No install needed — a hosted Streamable HTTP MCP endpoint is live:
https://mcp.carrierscore.io/mcp
Keyless requests get a rate-limited free tier (lookups, scores, text evidence reports). Paid tiers add carrier-list monitoring, structured JSON evidence reports, and higher volume — see pricing. Paid tiers authenticate with an X-API-Key header (or CARRIERSCORE_API_KEY when self-hosting).
Tools
| Tool | What it does |
|---|---|
carrier_lookup | Carrier identity by US DOT number: legal name, DBA, operating status, FMCSA safety rating, fleet size, address, registration dates. Use first to confirm a DOT is real and matches the rate confirmation. |
carrier_score | The CarrierScore risk score (0–100, higher = riskier) with full component breakdown, hard flags (active OOS order, no active insurance, reincarnated-carrier link), and data-sufficiency indicator. |
montgomery_file | Timestamped carrier-selection evidence report — the documented artifact a broker retains at the moment of booking (post Montgomery v. Caribe Transport II). Text format on the free tier; JSON on paid tiers. |
monitor_carriers | Batch score summary + flags for up to 100 DOT numbers per call — screen candidates for a load or re-check an active roster. |
Connect from a client
Claude Code
claude mcp add --transport http carrierscore https://mcp.carrierscore.io/mcp
Claude Desktop / claude.ai
Settings → Connectors → Add custom connector → URL https://mcp.carrierscore.io/mcp.
Cursor
.cursor/mcp.json:
{
"mcpServers": {
"carrierscore": {
"url": "https://mcp.carrierscore.io/mcp"
}
}
}
Generic MCP client (Streamable HTTP)
{
"mcpServers": {
"carrierscore": {
"type": "streamable-http",
"url": "https://mcp.carrierscore.io/mcp"
}
}
}
Self-hosting
The server in this repo is a thin Streamable HTTP client over the 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
Environment variables:
| Variable | Default | Purpose |
|---|---|---|
CARRIERSCORE_API_URL | http://127.0.0.1:8321 | Base URL of the CarrierScore REST API |
CARRIERSCORE_API_KEY | (unset) | Optional API key for paid tiers; unset = rate-limited free tier |
PORT | 8322 | Port for the MCP HTTP endpoint (POST /mcp) |
Disclaimer
CarrierScore scores are computed statistical indicators built from public FMCSA data under a documented, transparent methodology (population percentiles plus hard flags). They are not safety fitness determinations, are not endorsed by FMCSA, and do not substitute for a carrier's official safety rating or your own judgment. Every score and evidence report embeds this disclaimer — retain it when storing or quoting results.
License
MIT © SYMBOLIQ LLC. Contact: business@colesprout.com
Questions fréquentes
Qu'est-ce que io.carrierscore/carrierscore ?
FMCSA motor-carrier risk scores, monitoring, and carrier-selection evidence reports for AI agents.
Comment installer io.carrierscore/carrierscore ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http carrierscore 'https://mcp.carrierscore.io/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.carrierscore/carrierscore ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
io.carrierscore/carrierscore est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.carrierscore/carrierscore ?
Il est publié par csprout3. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.