MCP connector
Connect Market Tracker to Claude or ChatGPT over MCP, what each of the twelve read-only lookup tools returns, how authentication works, and the free trial it needs.
Market Tracker exposes its carrier data as an MCP server, so you can ask about any US motor carrier from inside Claude, ChatGPT or any MCP client. This page is the reference: the tools, the auth model and the limits. For setup with a copyable connector URL, use the MCP connector page.
#Endpoint
The server is served over Streamable HTTP at /api/mcp on the Market Tracker domain. It is stateless: each request stands alone; there is no session to keep alive.
#Authentication
Requests need a bearer token. An unauthenticated request gets a 401 with a WWW-Authenticate header pointing at the protected-resource metadata, which walks the client through OAuth: your MCP client opens a browser, you sign in or sign up, you approve access, and the client receives a token.
You do not create or paste a token by hand.
Note
MCP tokens and web session cookies are separate. An MCP token cannot be used as a browser session, and being signed in to the web app does not authenticate an MCP client.
#The tools
All twelve lookup tools are read-only. None of them writes, and nothing changes a carrier's record.
| Tool | Returns |
|---|---|
carrier_profile | The carrier's identity and core record |
carrier_profiles | The same record for a list of carriers in one call (each carrier counts as one lookup) |
carrier_authority_insurance | Operating authority plus the insurance currently on file |
carrier_insurance_history | Filing history over time |
carrier_xdate | Estimated insurance renewal date |
carrier_iss_score | ISS estimate and band |
carrier_risk_score | Loss-risk score and tier |
carrier_related | Other carriers sharing identifiers with this one |
find_carrier_by_name | Resolve a company name to a USDOT |
search_carriers | Filtered search across the carrier market |
search | Generic search entry point |
fetch | Full record for an id returned by search |
A typical chain is find_carrier_by_name → carrier_profile → whichever specific tool answers the question.
#Reading the results
Three things the connector returns that are easy to misread:
- A renewal date flagged unreliable is an approximate month, not a firm date.
- A renewal date carries a basis:
filing(first year, from the filing's effective date),anniversary(a continuous filing projected to its next policy anniversary) ortransaction. Say which one you are quoting. - A risk result with
rated: falsemeans there was not enough inspection data to rate the carrier. It is not a low-risk result. - Active authority with no BI/PD filing is a compliance flag, reconciled daily against FMCSA's live registration record (MOTUS) since September 2026. Report it as "no active filing on record", not as "uninsured".
#The free trial
The connector answers for accounts on a Market Tracker plan or free trial. A new account starts its 7-day trial on the connect screen, right after signing up: a card is required and nothing is charged today. Without a plan or trial, every tool returns subscription_required with a link that opens checkout in one step, and the connection itself stays in place, so nothing needs reconnecting once the trial starts.
#The free tier (older accounts)
Accounts created before October 7, 2026 keep a free tier: a small number of tool calls per UTC day. Past that, calls return a locked result explaining what is withheld and why, rather than failing.
Withheld on the free tier: exact renewal dates, ISS scores, carrier contact details, and search results past the first page. The data exists and is gated: retrying or calling a different tool does not work around it.
Exact numbers: Limits and caps.
#The monthly carrier allowance
A paid plan includes a monthly number of distinct carriers across the connector and exports, per seat. A carrier already pulled that month is free to look up again. Past the allowance, a lookup returns carrier_allowance_reached instead of the record, and searches and batches return only the carriers already pulled.
The team's owner or an admin can add a top-up from the chat with buy_lookup_pack. It always takes two calls: the first returns the price and the card and charges nothing, the second charges the card on file and only runs after you say yes. Along with start_paid_plan (which ends a free trial early), it is one of two billing tools on the connector; every other tool is read-only.
#What the connector cannot answer
No public source carries these, so the connector does not have them:
- premiums, rates, or what a carrier pays
- claims detail or loss runs
- driver-level personal data: counts only
- IFTA mileage and fuel-tax records
- telematics, real-time location, ELD data
- credit or financial statements
- non-US carriers, except foreign carriers registered to operate in the US
Last reviewed