Documentation

Tools exposed by Recall Watch and the limits that apply.

Connect

Server URL: https://recalls.tidybutton.com/mcp. Authentication is OAuth with dynamic client registration and an email sign-in code. Claude: Settings, Connectors, Add custom connector.

Tools

search_recalls

Searches recalls by keyword, brand or product across the chosen sources and a date range; optionally a vehicle make, model and year.

Any recalls this year for "Costway" high chairs or booster seats?

check_vins

Decodes up to 25 VINs and lists NHTSA recalls for each vehicle's make, model and model year.

Check these 12 fleet VINs for open recalls.

get_recall

Returns the details of one recall by source and id.

Show CPSC recall 27040.

add_watch

Saves a watch: keywords with sources, or a list of up to 200 VINs. Checked daily.

Watch my supplier "Acme Housewares" and my product "bamboo cutting board".

list_watches

Lists watches with last check time, next check time and unread alert counts.

Show my recall watches.

remove_watch

Deletes a watch and its alerts.

Remove the watch for Acme Housewares.

check_now

Runs one watch immediately and reports new alerts and current matches.

Check my fleet watch now.

get_alerts

Returns alerts for new recalls, unread first, and marks them read.

Any new recall alerts?

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
searches502000
watches3100

Network behaviour

Outbound requests use the user agent TidyButtonBot/1.0 (+https://recalls.tidybutton.com/bot), time out after 8 seconds and are blocked from private, loopback and link-local addresses.