Documentation
Tools exposed by Grantee Verifier and the limits that apply.
Connect
Server URL: https://grantee.tidybutton.com/mcp. Authentication is OAuth with dynamic client registration and an email sign-in code. Claude: Settings, Connectors, Add custom connector.
Tools
check_ein
Checks one EIN: format, legal name, location, subsection, public charity or private foundation, deductibility, revocation, ruling date, latest reported revenue and assets, and plain-language red flags.
- Inputs: ein, name (optional, to test for a name mismatch)
- Limits: Counts one check when the IRS data answered. A malformed EIN or an unavailable data service does not count.
check_list
Checks a list of EINs or name and EIN pairs and returns a table of red flags plus a CSV of the results.
- Inputs: items (EINs or {ein, name}), offset (optional)
- Limits: 50 EINs per call, up to 200 accepted; next_offset continues a longer list. One check per distinct valid EIN checked. A list with a malformed EIN is rejected without using allowance.
save_list
Saves a named list of EINs (with optional names) for re-checking when the IRS files update.
- Inputs: name, items, append (optional)
- Limits: Number of lists and EINs per list by plan. Does not run a check and uses no checks.
list_saved
Lists saved lists with size, last check and the IRS file dates last checked against.
- Inputs: none
- Limits: No quota.
remove_list
Deletes a saved list and its alerts.
- Inputs: name
- Limits: No quota. Cannot be undone.
check_now
Checks a saved list immediately and reports red flags and changes since its last check.
- Inputs: name, offset (optional)
- Limits: Counts one check per EIN checked, 50 per call. Changes are recorded when one call covers the whole list.
list_sources
Lists the IRS files used with their file dates, row counts and licence.
- Inputs: none
- Limits: No quota.
get_alerts
Recorded alerts for saved lists, unseen first; marks the returned alerts as seen.
- Inputs: limit (optional), include_seen (optional)
- Limits: No quota.
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 |
|---|---|---|
| EIN checks | 25 | 3000 |
| saved lists | 1 | 20 |
| EINs per saved list | 25 | 2000 |
Network behaviour
Outbound requests use the user agent TidyButtonBot/1.0 (+https://grantee.tidybutton.com/bot), time out after 8 seconds and are blocked from private, loopback and link-local addresses.