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.

Screen "Ivan Petrovich Sidorov", born 1968, Russia, against all lists.

list_sources

Shows each source list with its publication date, version, entry count, licence and last refresh.

How current are the sanctions lists you screen against?

add_watch

Saves a named list of names for re-screening, creating it or replacing (or appending to) a list of the same name.

Save my supplier names as the list "suppliers".

list_watches

Lists saved lists with name counts, last screening, the list versions screened and the number of current potential matches.

Show my saved lists.

remove_watch

Deletes a saved list and its alerts.

Remove the saved list "suppliers".

check_now

Screens a saved list immediately and reports potential matches, up to 250 names per call.

Screen my "suppliers" list now.

get_alerts

Returns alerts for new potential matches, unseen first, and marks them seen.

Any new sanctions alerts?

account_status

Shows the account email, plan, usage and limits.

Show my account status.

activate_license

Binds a licence key to the account.

Activate licence key XXXX-XXXX.

Plan limits

LimitFreePro
name screens255000
saved lists120
names per saved list252000

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.