Sanctions

A powerful sanctions screening MCP Server that leverages OFAC data to assess individuals and organizations for risk.

javascript

2

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can run the Sanctions MCP Server locally to screen individuals and organizations against major global sanctions lists using a Node.js-based MCP. It integrates with an external OFAC API to provide risk assessments, supports customizable match thresholds, and lets you target specific sanctions lists for compliance checks.

How to use

Use the Sanctions MCP Server from your preferred MCP client to screen people or entities against sanctions lists. You can perform individual or organizational screenings and apply a minimum match score to filter results. Typical usage patterns include checking a person with identifying details (name, date of birth, citizenship, address, and documents) or screening an organization by name and location. You can also select which sanctions lists to reference (SDN, UN, OFSI, etc.) to align with your compliance requirements.

How to install

Prerequisites you need before installing:

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

Installation steps

Clone the MCP project and install dependencies exactly as shown here.

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

Configure the MCP server for Claude desktop integration

Add the following configuration to your claude_desktop_config.json to enable sanctions screening through the MCP server. Update paths to match your local Node.js installation and repository location. Insert 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

Screen an individual named John Smith born on 1980-01-15 from Syria: “Can you check if John Smith born on 1980-01-15 from Syria is on any sanctions lists?”

How the tool works

The Sanctions MCP Server processes screening requests with the following parameters: cases (array of entities), type ("person" or "organization"), minScore (0–100, default 95), and sources (lists to check like SDN, NONSDN, DPL, UN, OFSI). The server returns detailed match information, including sanctioned entity details, match scores, and source information.

Data format

Input includes detailed entity information such as name, date of birth for individuals, gender, citizenship, address, contact information, and identification documents. The response contains match details, scores, source information, and 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.