OFAC Sanctions Screening — Fuzzy SDN List Matching

MCP OFAC Sanctions Screening

A Model Context Protocol (MCP) server for screening names against the US Treasury OFAC SDN (Specially Designated Nationals) list. Production-grade fuzzy matching with Jaro-Winkler, phonetic, and token-set algorithms.

Why this exists

Every company processing USD transactions is legally required to screen against the OFAC sanctions list. Penalties for non-compliance start at $356,579 per violation. Enterprise screening tools cost $10,000-100,000/year. This server gives you the same capability for a fraction of the cost.

Tools (5 total)

Tool	Description
ofac_screen	Screen a name with fuzzy matching. Returns scored matches with confidence levels (exact/strong/partial/weak). Optionally filter by type, DOB, and country.
ofac_screen_batch	Screen up to 100 names in one call. Each name can include type, DOB, and country for improved accuracy.
ofac_entity	Get full details of an SDN entry by UID — aliases, addresses, IDs, programs, DOB, nationalities, vessel info.
ofac_search	Search/browse the SDN list by keyword, entity type, or sanctions program.
ofac_stats	List statistics — entries by type, program, top countries, data freshness.

Data

• 18,712 entries from the OFAC SDN list (published 03/13/2026)
• Entity types: 9,521 entities, 7,394 individuals, 1,455 vessels, 342 aircraft
• 73 sanctions programs (RUSSIA, SDGT, IRAN, CUBA, DPRK, CYBER2, etc.)
• Data updates available via npm run build-data

Matching Algorithm

Multi-strategy fuzzy matching pipeline:

1. Jaro-Winkler similarity (40%) — handles transpositions and typos
2. Token-set matching (30%) — handles word reordering ("BANK OF IRAN" vs "IRAN BANK")
3. Double Metaphone phonetic (20%) — catches spelling variations of same-sounding names
4. Exact substring (10%) — partial name containment
5. Exact token boost — single-name queries like "PUTIN" match "Vladimir Vladimirovich PUTIN"
6. DOB/country boost — cross-reference date of birth and nationality to reduce false positives

Every result includes a confidence score, match type classification, and detailed breakdown explaining why it matched.

Install

npx @easysolutions906/mcp-ofac

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "ofac": {
      "command": "npx",
      "args": ["-y", "@easysolutions906/mcp-ofac"]
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "ofac": {
      "command": "npx",
      "args": ["-y", "@easysolutions906/mcp-ofac"]
    }
  }
}

REST API

Set PORT env var to run as an HTTP server:

PORT=3000 STRIPE_SECRET_KEY=sk_live_... ADMIN_SECRET=your_secret node src/index.js

Method	Endpoint	Description
POST	/screen	Screen a single name
POST	/screen/batch	Screen multiple names (max 100)
GET	/entity/:uid	Get full SDN entry details
GET	/search	Search/browse the SDN list
GET	/programs	List all sanctions programs
GET	/stats	Data statistics
POST	/checkout	Create Stripe checkout session for paid plans
GET	/data-info	Data freshness and record counts

Example

curl -X POST https://your-server.com/screen \
  -H 'Content-Type: application/json' \
  -d '{"name": "PUTIN", "country": "Russia"}'

{
  "matchCount": 1,
  "matches": [{
    "entity": {
      "name": "Vladimir Vladimirovich PUTIN",
      "sdnType": "Individual",
      "programs": ["RUSSIA-EO14024"],
      "title": "President of the Russian Federation"
    },
    "score": 0.86,
    "matchType": "strong",
    "matchedOn": "alias",
    "matchedName": "Vladimir PUTIN"
  }],
  "listVersion": "03/13/2026",
  "screenedAt": "2026-03-15T17:27:07.651Z"
}

Pricing

Plan	Screens/day	Batch	Rate	Price
Free	10	5	5/min	$0
Starter	100	25	15/min	$4.99/mo
Pro	1,000	50	60/min	$29.99/mo
Business	5,000	100	200/min	$99.99/mo
Enterprise	50,000	100	500/min	$299.99/mo

Audit Trail

Every response includes listVersion (OFAC publish date) and screenedAt (ISO timestamp) for compliance documentation.

Transport

• stdio (default) — for local use with Claude Desktop and Cursor
• HTTP — set PORT env var for Streamable HTTP mode on /mcp

Disclaimer

This tool is provided for informational and screening purposes only. It does not constitute legal advice. Compliance decisions remain the responsibility of the user. Always consult qualified legal counsel for sanctions compliance matters.