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.
- Inputs: keywords (up to 3), sources (optional), vehicle (optional), date_from, date_to (optional), limit (optional)
- Limits: Counts one search when at least one source answered. Up to 100 results. Matching is by keyword and may miss or over-match.
check_vins
Decodes up to 25 VINs and lists NHTSA recalls for each vehicle's make, model and model year.
- Inputs: vins (up to 25)
- Limits: Counts one search. Requests per call are capped; vehicles not reached are reported. Confirm a specific VIN at nhtsa.gov/recalls.
get_recall
Returns the details of one recall by source and id.
- Inputs: source, id
- Limits: Counts one search. EU Safety Gate ids are looked up in the most recent weekly reports only.
add_watch
Saves a watch: keywords with sources, or a list of up to 200 VINs. Checked daily.
- Inputs: name, keywords or vehicles or vins, sources (optional)
- Limits: Watch limit by plan. The first check records current recalls without alerting.
list_watches
Lists watches with last check time, next check time and unread alert counts.
- Inputs: none
- Limits: No quota.
remove_watch
Deletes a watch and its alerts.
- Inputs: watch_id
- Limits: No quota. Cannot be undone.
check_now
Runs one watch immediately and reports new alerts and current matches.
- Inputs: watch_id
- Limits: Counts one search when the check completes. Request count per call is capped; a large VIN list may need a repeat call.
get_alerts
Returns alerts for new recalls, unread first, and marks them read.
- Inputs: include_read (optional), watch_id (optional), limit (optional)
- Limits: No quota. Up to 50 per call.
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 |
|---|---|---|
| searches | 50 | 2000 |
| watches | 3 | 100 |
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.