sanctions-screening-mcp-server: get designation
sanctions_get_designationFetch the full record for one sanctions designation by source list + entry ID, the list's published reference number, or, for a UK or EU designation, the UN reference number it implements — the drill-in after sanctions_screen_name or sanctions_screen_identifier surfaces a candidate, or the lookup for a reference a notice cites (UN QDe.004, EU EU.27.28, UK OFSI Group ID, or UN TAe.010 on the UK list). Returns all published aliases, identifiers (passport, national ID, tax and registration numbers, SWIFT/BIC codes, digital-currency addresses, vessel call signs, aircraft tail and serial numbers, phone numbers, email addresses, websites), addresses, dates and places of birth at the precision the source published, nationalities, descriptive features (a vessel's flag, type, and tonnage; an aircraft's model and operator; a title or gender; sanctions notes; the UK measures imposed and designation source), sanctioning program, legal basis, designation date, and the UN reference number a UK or EU designation implements. The record reflects exactly what the source published; missing fields mean the source omitted them. This is a screening aid — the designation record supports a compliance review, it is not itself a determination.
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": {
"source": "<source>",
"entryId": "<entryId>"
},
"name": "sanctions_get_designation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| source | Yes | Which source list the entry belongs to. | |
| entryId | Yes | The source list's own entry ID (the sourceEntryId from sanctions_screen_name), the reference number the list publishes for the entry (UN QDe.004, EU EU.27.28, UK OFSI Group ID 14196), or, on uk and eu, the UN reference number the entry implements (TAe.010). Matched trimmed and case-insensitive: entry ID first, then reference number, then UN reference number, then a UN reference number in another zero padding (LYi.28, LYi.028). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present when the call failed. Absent on success. | |
| caveat | No | Decision-support caveat — this is a screening aid, not a compliance determination. | |
| source | No | Source list the entry belongs to. | |
| aliases | No | All published aliases / name variants. | |
| program | No | Sanctioning program / regime, when published. | |
| remarks | No | Free-form remarks published by the source, when present. | |
| features | No | Values the source publishes to describe the party rather than identify it, in published order: OFAC's vessel flag, type, and tonnage, aircraft model and operator, title, gender, and sanctions notes; the UK list's designation source and measures imposed (DesignationSource, SanctionsImposed), then its ship details. Empty when the source publishes none. Screening never matches on them. | |
| addresses | No | Published addresses. | |
| entityType | No | Entity classification as published. | |
| legalBasis | No | Statutory / regulatory basis as the list publishes it — OFAC's legal-basis references, the EU regulation title, the UK regime's regulations — several joined with '; '. Absent when unpublished; the UN list publishes none. | |
| identifiers | No | Published identifiers: identity documents (passport, national ID, tax, registration) and, where the source publishes them, SWIFT/BIC codes, digital-currency addresses, vessel call signs, aircraft tail and serial numbers, phone numbers, email addresses, and websites. | |
| primaryName | No | Primary published name. | |
| sourceLabel | No | Human-readable name of the source list. | |
| datesOfBirth | No | Published dates and places of birth (persons). | |
| nationalities | No | Published nationalities / citizenships. | |
| sourceEntryId | No | The source list's own entry ID. | |
| designationDate | No | Designation date in YYYY-MM-DD when known to day precision, or published date text otherwise; absent when unpublished. An OFAC party's date can differ between its ofac_sdn and ofac_consolidated records. | |
| referenceNumber | No | The list's published reference number (UN, EU, UK OFSI Group ID); absent when the list publishes none for the entry. OFAC publishes none — its entry ID is its published number. | |
| unReferenceNumber | No | The UN reference number this UK or EU designation implements, as the list publishes it; absent when it publishes none. Never corrected: it can differ from the UN list's own in case or padding, name no current UN listing, or be carried by two designations — a link to check against the un record, not proof of identity. |