developers
carrier lookup mcp.
Remote MCP over HTTPS. Same FMCSA QCMobile first-look as the public tools, gated to a Verifreta Desk account (trial or paid). Confirm L&I before you book.
endpoint
https://verifreta.com/api/mcp
Streamable HTTP (POST JSON-RPC). Requires a Desk account. ChatGPT and other OAuth clients open https://verifreta.com/oauth/authorize — sign in, start the $0 trial if needed, then Allow. Cursor-style clients can send Authorization: Bearer vr_live_… from Settings → MCP API keys.
ChatGPT / OAuth clients
Paste the endpoint as a custom connector (developer mode) or install from the directory when listed. The client runs OAuth; you land on Verifreta for Google sign-in and Paddle ($0 due today, then Desk). No API key to copy.
install (OAuth)
Clients that support MCP OAuth only need the URL:
{
"mcpServers": {
"verifreta": {
"url": "https://verifreta.com/api/mcp"
}
}
}install (API key)
Create a key in Desk settings, then:
{
"mcpServers": {
"verifreta": {
"url": "https://verifreta.com/api/mcp",
"headers": {
"Authorization": "Bearer vr_live_YOUR_KEY"
}
}
}
}access
- Included with Desk trial and paid plans. Same entitlement as the dashboard.
- Lookups are unlimited while Desk is active; per-account rate limits protect the FMCSA key.
- When trial or billing lapses, tools return
desk_access_paused. Manage billing on the site — not in the chat.
tools
- lookup_dot — USDOT number → full census first look (same fields as DOT lookup).
- lookup_mc — MC, MX, or FF docket → full census first look (same as MC number lookup).
- lookup_name — legal or DBA name → match list (same as carrier name search); pick a row, then run DOT or MC for the enriched report.
Response JSON includes census fields (legal name, allowed-to-operate, out-of-service, fleet, dockets, cargo, authority lines where QCMobile returns them) and a fixed L&I disclaimer.
source of truth
Verifreta reads FMCSA QCMobile for a snapshot. Confirm operating authority and insurance on FMCSA Licensing & Insurance (L&I) and cross-check FMCSA SAFER Company Snapshot. We are not FMCSA and do not replace L&I filings.
examples
lookup_dot—{ "query": "3847261" }lookup_mc—{ "query": "MC-123456" }lookup_name—{ "query": "Summit Line" }