Documentation
Tools exposed by Grant Watch and the limits that apply.
Connect
Server URL: https://grants.tidybutton.com/mcp. Authentication is OAuth with dynamic client registration and an email sign-in code. Claude: Settings, Connectors, Add custom connector.
Tools
search_grants
Searches US Grants.gov and EU Funding & Tenders calls for proposals by keywords with optional agency, eligibility, category and close-date filters.
- Inputs: keywords, sources (optional), statuses (optional), agencies, eligibility, categories (optional), close_after, close_before (optional), limit (optional)
- Limits: Counts one search when at least one source answers. Up to 50 results. Agency, eligibility and category filters apply to Grants.gov only.
get_grant
Returns one opportunity by source and id: description, eligibility, award ceiling and floor, dates and the official link.
- Inputs: source, id
- Limits: Counts one search when found. The EU search interface does not publish budgets; the official link has them.
add_watch
Saves a search that is checked daily; new matches become alerts, and on Pro approaching deadlines trigger a reminder.
- Inputs: name, keywords, sources, statuses, agencies, eligibility, categories (optional), remind_days (optional, default 14)
- Limits: Saved search and bookmark limit by plan. The first check records current matches without alerting.
bookmark_grant
Follows one opportunity: alerts when its close date or status changes, and on Pro reminds before the close date.
- Inputs: source, id, remind_days (optional, default 14)
- Limits: Counts one search (the opportunity is looked up) and one saved search or bookmark slot.
list_watches
Lists saved searches and bookmarks with last check, next check and unread alert counts.
- Inputs: none
- Limits: No quota.
remove_watch
Deletes a saved search or bookmark and its alerts.
- Inputs: watch_id
- Limits: No quota. Cannot be undone.
check_now
Runs one saved search or bookmark 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 opportunities, approaching deadlines and changes, 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 and bookmarks | 3 | 100 |
Network behaviour
Outbound requests use the user agent TidyButtonBot/1.0 (+https://grants.tidybutton.com/bot), time out after 8 seconds and are blocked from private, loopback and link-local addresses.