Documentation
Tools exposed by Patch Priority Watch and the limits that apply.
Connect
Server URL: https://patches.tidybutton.com/mcp. Authentication is OAuth with dynamic client registration and an email sign-in code. Claude: Settings, Connectors, Add custom connector.
Tools
kev_search
Searches the CISA KEV catalogue by vendor, product, keyword and date-added range.
- Inputs: vendor (optional), product (optional), keyword (optional), added_from, added_to (optional), limit (optional)
- Limits: Counts one lookup. Up to 100 entries per call, newest first.
prioritize_cves
Takes CVE ids and returns, for each, KEV status (date added, due date, ransomware flag), EPSS score and percentile, and a Patch now, This week or Monitor bucket by a documented rule.
- Inputs: cve_ids (1 to 100)
- Limits: Counts one lookup per CVE id. NVD details only for CVEs outside KEV and only when the server has an NVD key.
product_exposure
Returns the KEV entries for a vendor and optional product, with EPSS for each and the bucket the rule assigns.
- Inputs: vendor, product (optional), limit (optional)
- Limits: Counts one lookup. EPSS is looked up for the 100 most recently added matches.
add_watch
Saves a watchlist of vendor and product pairs.
- Inputs: name, products (list of vendor with optional product)
- Limits: No quota. Watchlists and products per watchlist limited by plan. The first check records current entries without alerting.
list_watches
Lists watchlists with their products, last and next check time and unread alert counts.
- Inputs: none
- Limits: No quota.
remove_watch
Deletes a watchlist and its alerts.
- Inputs: watch_id
- Limits: No quota. Cannot be undone.
check_now
Runs one watchlist immediately and reports new alerts and current matches.
- Inputs: watch_id
- Limits: Counts one lookup when the check completes.
get_alerts
Returns alerts for new KEV entries and EPSS scores of 0.5 or higher on watched products, 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 |
|---|---|---|
| lookups (one per CVE id prioritised, one per search, exposure lookup or watch check) | 50 | 3000 |
| watchlists | 1 | 20 |
| products per watchlist | 10 | 300 |
Network behaviour
Outbound requests use the user agent TidyButtonBot/1.0 (+https://patches.tidybutton.com/bot), time out after 8 seconds and are blocked from private, loopback and link-local addresses.