Sanctions

What is Sanctions about?

Sanctions offers an API‑driven service that checks persons and companies against major global sanctions lists (OFAC SDN, UN, OFSI, etc.) and returns detailed match information, scores, and source data.

How to use Sanctions?

1. Clone the repository and install dependencies with npm install.
2. Configure claude_desktop_config.json to point to your Node.js executable and the index.js entry point, adding the OFAC_API_API_KEY environment variable.
3. Restart Claude Desktop so the server becomes available.
4. Send JSON requests containing cases, type, minScore, and sources to the MCP endpoint; receive structured JSON responses with match results.

Key features of Sanctions

• Screening against multiple sanctions lists (OFAC SDN, NON‑SDN, DPL, UN, OFSI, etc.)
• Customizable minimum risk score threshold
• Support for both individuals and organizations
• Rich identification methods: name, DOB, passport, address, etc.
• Configurable source selection to fit compliance policies

Use cases of Sanctions

• Financial institutions validating customers and counterparties for AML/KYC compliance.
• Export companies checking business partners before shipping restricted goods.
• Legal firms performing due‑diligence investigations on entities.
• Travel agencies verifying travelers against watch‑lists.
• Government agencies monitoring sanctions‑related activities.

FAQ from the Sanctions

Q: Which Node.js version is required? A: Node.js v20 or higher.

Q: How do I set the API key? A: Add OFAC_API_API_KEY to the env section of claude_desktop_config.json.

Q: Can I limit the lists being searched? A: Yes, specify desired lists in the sources array of the request.

Q: What is the default minimum match score? A: The default minScore is 95 (scale 0‑100).

Q: How are responses formatted? A: The server returns a JSON object containing match details, scores, source information, and the screened entity's profile.

Sanctions MCP Server

A powerful sanctions screening API MCP Server, leveraging OFAC API to provide comprehensive risk assessments for individuals and organizations.

🎉 Ready for integration with Claude through the Model Context Protocol 🎉

https://github.com/user-attachments/assets/41ea6318-5b17-4da1-8d6d-8cb60b5342ea

Key Features

• Sanctions Screening: Screen individuals and organizations against major global sanctions lists including OFAC SDN, UN, OFSI, and more
• Customizable Risk Threshold: Set minimum risk scores to determine match relevance
• Comprehensive Entity Support: Screen both individuals and organizations with detailed information
• Multiple Identification Methods: Support for various identifiers including names, addresses, identification documents, and more
• Source Selection: Choose which sanctions lists to check against based on your compliance needs

How to Use

You can run the Sanctions MCP Server using Node.js directly.

Requirements

1. Node.js v20 or higher
2. npm or yarn for dependency management
3. git

Installation

1. Clone the repository

git clone https://github.com/yourusername/mcp-ofac
cd mcp-ofac

2. Install dependencies

npm install

3. Configure claude_desktop_config.json

Add the following configuration to your claude_desktop_config.json file. Make sure to:

• Update the paths to match your local Node.js installation and repository location
• Add your OFAC API key if required

{
  "mcpServers": {
    "sanctions": {
      "command": "/path/to/your/node",
      "args": ["/path/to/your/mcp-ofac/index.js"],
      "env": {
        "OFAC_API_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Usage Examples

Screening an Individual

You can ask Claude to screen individuals against sanctions lists:

"Can you check if John Smith born on 1980-01-15 from Syria is on any sanctions lists?"

Screening an Organization

You can ask Claude to check organizations:

"Is there a sanctioned entity called Tech Solutions Ltd based in Tehran, Iran?"

Custom Screening Parameters

You can specify custom parameters for more targeted screening:

"Check if Maria Rodriguez with passport number AB123456 from Venezuela is on the OFAC SDN list with a minimum match score of 90."

How the Tool Works

The Sanctions MCP Server processes screening requests with the following parameters:

• cases: Array of entities to screen (individuals or organizations) with identifying information
• type: Entity type ("person" or "organization")
• minScore: Minimum score threshold for matches (0-100, default: 95)
• sources: Which sanctions lists to check against (SDN, NONSDN, DPL, UN, OFSI, etc.)

The tool returns detailed match information, including sanctioned entity details, match scores, and source information.

Data Format

Input Schema

The server accepts detailed entity information including:

• Name
• Date of birth (for individuals)
• Gender (for individuals)
• Citizenship/Nationality
• Address details
• Contact information
• Identification documents

Response Format

The server returns a JSON response with:

• Match details
• Match scores
• Source information
• Entity profiles

Restart Claude Desktop

After configuring your claude_desktop_config.json, restart Claude Desktop to apply the changes and enable the sanctions screening capability.