Documentation
Tools exposed by Sanctions Screener and the limits that apply.
Connect
Server URL: https://sanctions.tidybutton.com/mcp. Authentication is OAuth with dynamic client registration and an email sign-in code. Claude: Settings, Connectors, Add custom connector.
Tools
screen_names
Screens up to 50 names (optional date of birth and country each) against the OFAC SDN and Consolidated, UK, EU and UN lists.
- Inputs: names, threshold (optional), lists (optional), max_matches_per_name (optional)
- Limits: Counts one screen per name, only when the screening ran. Screening aid only, not a legal determination.
list_sources
Shows each source list with its publication date, version, entry count, licence and last refresh.
- Inputs: none
- Limits: No quota.
add_watch
Saves a named list of names for re-screening, creating it or replacing (or appending to) a list of the same name.
- Inputs: name, names, threshold (optional), append (optional)
- Limits: Saved-list and names-per-list limits by plan. Does not run a screen.
list_watches
Lists saved lists with name counts, last screening, the list versions screened and the number of current potential matches.
- Inputs: none
- Limits: No quota.
remove_watch
Deletes a saved list and its alerts.
- Inputs: name
- Limits: Cannot be undone.
check_now
Screens a saved list immediately and reports potential matches, up to 250 names per call.
- Inputs: name, offset (optional)
- Limits: Counts one screen per name screened. Larger lists continue with offset.
get_alerts
Returns alerts for new potential matches, unseen first, and marks them 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 |
|---|---|---|
| name screens | 25 | 5000 |
| saved lists | 1 | 20 |
| names per saved list | 25 | 2000 |
Network behaviour
Outbound requests use the user agent TidyButtonBot/1.0 (+https://sanctions.tidybutton.com/bot), time out after 8 seconds and are blocked from private, loopback and link-local addresses.