MC

mcp-sanctions

Created 5 months ago

A powerful sanctions screening API MCP Server leveraging OFAC API for risk assessments.

development documentation public API sanctions

What is mcp-sanctions?

Screen individuals and organizations against global sanctions lists (OFAC, SDN, UN, etc). Query by prompt or document upload.

Documentation

Sanctions MCP Server

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
```\n\n#### 2. Install dependencies
```sh
npm install
```\n\n#### 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
```json
{
  "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?"\n\n### Screening an Organization You can ask Claude to check organizations: "Is there a sanctioned entity called Tech Solutions Ltd based in Tehran, Iran?"\n\n### 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\n\n### 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.

Server Config

{
  "mcpServers": {
    "mcp-sanctions-server": {
      "command": "npx",
      "args": [
        "mcp-sanctions"
      ]
    }
  }
}

Links & Status

Repository: github.com
Hosted: No
Global: No
Official: No

Project Info

Hosted Featured
Created At: Jul 02, 2025
Updated At: Aug 07, 2025
Author: madupay
Category: community
License: MIT
Tags:
development documentation public