Documentation
Tools exposed by Tender Watch and the limits that apply.
Connect
Server URL: https://tenders.tidybutton.com/mcp. Authentication is OAuth with dynamic client registration and an email sign-in code. Claude: Settings, Connectors, Add custom connector.
Tools
search_tenders
Searches open and recent procurement notices by keyword, CPV or NAICS code, country, source, minimum value and deadline.
- Inputs: keywords (up to 3), cpv_codes, naics_codes, countries, sources (optional), min_value, deadline_after, published_from, published_to, limit (optional)
- Limits: Counts one search when at least one source answered. Up to 50 results. UK feeds are read in a limited number of pages and the result says how far they got.
get_tender
Returns the details of one notice by source and id.
- Inputs: source, id
- Limits: Counts one search when the notice is found.
award_history
Lists past US federal contract awards for a recipient, awarding agency, NAICS or PSC code, largest first.
- Inputs: recipient, agency, naics_codes, psc_codes, date_from, date_to, min_amount, limit (optional)
- Limits: Counts one search. Up to 25 awards, US federal contracts only; the amount is the award value as reported.
add_watch
Saves a search: keywords, codes, countries, sources and a minimum value, optionally with a deadline reminder.
- Inputs: name, keywords, cpv_codes, naics_codes, countries, sources (optional), min_value, deadline_alert
- Limits: Saved-search limit by plan. The first check records current notices without alerting.
list_watches
Lists saved searches with last check time, next check time and unread alert counts.
- Inputs: none
- Limits: No quota.
remove_watch
Deletes a saved search and its alerts.
- Inputs: watch_id
- Limits: No quota. Cannot be undone.
check_now
Runs one saved search immediately and reports new alerts and current matches.
- Inputs: watch_id
- Limits: Counts one search when the check completes.
get_alerts
Returns alerts for new notices and deadline reminders, 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 |
| saved searches | 3 | 100 |
Network behaviour
Outbound requests use the user agent TidyButtonBot/1.0 (+https://tenders.tidybutton.com/bot), time out after 8 seconds and are blocked from private, loopback and link-local addresses.