sanctions-screening-mcp-server: screen identifier
sanctions_screen_identifierLook up an identifier — a vessel or company IMO number, a SWIFT/BIC code, a digital-currency wallet address, a passport or national ID number, or any other identifier a list publishes — against loaded sanctions and export-control watchlists — OFAC SDN + Consolidated, EU, UK, UN, and the six BIS/State CSL lists. Check sanctions_list_sources for coverage. Exact match after normalization, with no fuzzy or partial matching and no score: spacing, letter case, and the separators - . / are ignored, an IMO number matches with or without its IMO prefix, a SWIFT/BIC code compares on its first eight characters so a branch code matches its institution, and a wallet address folds case only where its encoding is case-insensitive (hex, bech32, cashaddr — never base58). Returns every designation that publishes a matching identifier, one per designation — an OFAC party both OFAC lists publish under one entry ID is one hit, its sources naming both lists — with the identifiers that matched as published; sanctions_get_designation pulls the full record. This is a screening AID for a human/compliance review, NOT a compliance determination: a hit means "review this candidate against the official source," and an empty result never means "cleared" — an identifier a list prints only in free-text remarks, or bundled with other numbers in one field, does not match.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"value": "<value>"
},
"name": "sanctions_screen_identifier"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Restrict to one identifier category, or "any" (default) to search all published identifiers, including MMSI, call signs, tax and registration numbers. Published label categories take precedence. An otherwise unclassified label with an IMO prefix and exactly seven digits is indexed as imo, including company numbers. | any |
| value | Yes | The identifier to look up, as you hold it (e.g. "IMO 7406784", "DCBKKPPY", a wallet address, a passport number). Must contain at least one character other than whitespace and - . / | |
| sources | No | Restrict to specific source lists. Omit to search all loaded lists. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hits | No | Designations that publish a matching identifier, one per designation (an OFAC party on both OFAC lists once), ordered by source list then entry ID. Not paged — the most widely shared published identifiers map to about a dozen designations. | |
| error | No | Present when the call failed. Absent on success. | |
| caveat | No | Decision-support caveat — this is a screening aid, not a compliance determination. | |
| notice | No | Guidance when no designation matched — what to try next, and what an empty result does NOT mean. | |
| totalCount | No | Number of designations returned. |