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.

Check MC 135797 before I tender this load.

search_carriers

Finds carriers whose legal name or DBA contains some text, optionally in one state and only active USDOT numbers.

Find active carriers with "Hunt" in the name in Arkansas.

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.

Check these 40 MC numbers from my approved-carrier sheet.

add_watch

Adds a carrier to the watchlist and records its current state as the baseline.

Watch USDOT 80806 for authority and insurance changes.

list_watches

Lists watched carriers with last check and next check times.

Which carriers am I watching?

remove_watch

Removes a carrier from the watchlist.

Stop watching USDOT 80806.

check_now

Checks one watched carrier immediately and reports and records any changes.

Re-check USDOT 80806 now.

get_alerts

Recorded alerts, unseen first; marks the returned alerts as seen.

Any carrier changes since yesterday?

account_status

Shows the account email, plan, usage and limits.

Show my account status.

activate_license

Binds a licence key to the account.

Activate licence key XXXX-XXXX.

Plan limits

LimitFreePro
carrier checks253000
watched carriers5500
batch_size1050
csv_batch01

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.