Sanctions Screening
company_sanctions_checkCheck companies against global sanctions lists (OFAC, EU, UN) to identify potential compliance risks using automated screening with confidence scores.
Instructions
Screen a company against global sanctions lists (OFAC, EU, UN) via OpenSanctions. Returns match confidence scores. Use company_search first to get an entity_id. IMPORTANT: This is an automated screening, not a legal determination.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| entity_id | Yes | CompanyLens entity ID from company_search (starts with "companylens_") |
Implementation Reference
- src/index.ts:88-107 (handler)The handler function for company_sanctions_check that fetches sanctions data via apiCall and formats the output.
async ({ entity_id }) => { const data = await apiCall(`/v1/company/${entity_id}/sanctions`) as { name: string; is_sanctioned: boolean; matches: Array<{ name: string; score: number; datasets: string[] }>; agent_hint: string; }; let text: string; if (data.is_sanctioned) { const matchLines = data.matches.map((m) => `- ${m.name} (confidence: ${(m.score * 100).toFixed(0)}%, lists: ${m.datasets.join(', ')})` ); text = `WARNING: ${data.name} has potential sanctions matches:\n\n${matchLines.join('\n')}\n\n${data.agent_hint}`; } else { text = `${data.name}: No sanctions matches found.\n\n${data.agent_hint}`; } return { content: [{ type: 'text' as const, text }] }; }, - src/index.ts:81-87 (schema)The input schema and description for company_sanctions_check.
{ title: 'Sanctions Screening', description: 'Screen a company against global sanctions lists (OFAC, EU, UN) via OpenSanctions. Returns match confidence scores. Use company_search first to get an entity_id. IMPORTANT: This is an automated screening, not a legal determination.', inputSchema: z.object({ entity_id: z.string().describe('CompanyLens entity ID from company_search (starts with "companylens_")'), }), }, - src/index.ts:79-80 (registration)Registration of the company_sanctions_check tool.
server.registerTool( 'company_sanctions_check',