Documentation
Tools exposed by Carrier Vetting Watch and the limits that apply.
Connect
Server URL: https://carriers.tidybutton.com/mcp. Authentication is OAuth with dynamic client registration and an email sign-in code. Claude: Settings, Connectors, Add custom connector.
Tools
check_carrier
Full FMCSA check of one carrier, broker or freight forwarder: status, authority, insurance on file, fleet, address, MCS-150 date and plain-language red flags.
- Inputs: identifier (USDOT, MC/MX/FF number or exact name), id_type (optional), expected_name (optional)
- Limits: Counts one check. Names must match the legal name or DBA exactly; an ambiguous name returns the candidates and uses no allowance.
search_carriers
Finds carriers whose legal name or DBA contains some text, optionally in one state and only active USDOT numbers.
- Inputs: query, state (optional), active_only (optional), limit (optional)
- Limits: Counts one check. Up to 25 results.
check_batch
Checks a list of USDOT or MC numbers, pasted or from a CSV URL, and returns a table with red flags plus a CSV of the results.
- Inputs: ids or csv_url, id_column (optional), offset (optional)
- Limits: One slice per call: 10 numbers on Free, 50 on Pro (CSV URLs are Pro only). One check per valid identifier. next_offset continues a longer list.
add_watch
Adds a carrier to the watchlist and records its current state as the baseline.
- Inputs: identifier (USDOT or MC/MX/FF number)
- Limits: Counts one check. Watched-carrier limit by plan. Checked daily.
list_watches
Lists watched carriers with last check and next check times.
- Inputs: none
- Limits: No quota.
remove_watch
Removes a carrier from the watchlist.
- Inputs: identifier
- Limits: No quota.
check_now
Checks one watched carrier immediately and reports and records any changes.
- Inputs: identifier
- Limits: Counts one check.
get_alerts
Recorded alerts, unseen first; marks the returned alerts as seen.
- Inputs: limit (optional), include_seen (optional)
- Limits: No quota.
account_status
Shows the account email, plan, usage and limits.
- Inputs: none
- Limits: none
activate_license
Binds a licence key to the account.
- Inputs: license_key (string)
- Limits: Key must belong to this product.
Plan limits
| Limit | Free | Pro |
|---|---|---|
| carrier checks | 25 | 3000 |
| watched carriers | 5 | 500 |
| batch_size | 10 | 50 |
| csv_batch | 0 | 1 |
Network behaviour
Outbound requests use the user agent TidyButtonBot/1.0 (+https://carriers.tidybutton.com/bot), time out after 8 seconds and are blocked from private, loopback and link-local addresses.