# sanctions-screening-mcp-server

sanctions-screening-mcp-server screens people, companies, vessels and aircraft against the OFAC, EU, UK and UN lists, and resolves legal entities to GLEIF LEIs. Matching runs on a local mirror.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 156 installs · ★ 4 repo stars
- Author: cyanheads
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cyanheads/sanctions-screening-mcp-server
- Updated: 2026-10-20
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/sanctions-screening-mcp-server

## What it does

The server keeps a local SQLite + FTS5 mirror of the consolidated OFAC, EU, UK and UN lists and matches against it. `sanctions_screen_name` checks a person, company, vessel or aircraft across every loaded list; `sanctions_screen_identifier` looks up an IMO number, SWIFT/BIC, wallet address or passport. `sanctions_resolve_entity` ranks GLEIF LEI candidates, `sanctions_get_entity` returns the Level 1 record, `sanctions_trace_ownership` walks parents and children, and `sanctions_get_designation` plus `sanctions_list_sources` give the full record and source metadata.

\`matchMode` takes `strict` (the default) or `fuzzy`. Approximate hits carry a Jaro-Winkler score and query token coverage, and comparison covers both native spellings and a deterministic romanization of Russian script. The `sanctions_vet_counterparty` prompt runs a whole counterparty pass.

Output is a lead. Check any hit against the official list yourself, and do not read an empty result as clearance. The determination stays with a human reviewer.

## Requirements
- Remote server: `https://sanctions-screening-mcp-server--cyanheads.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http sanctions-screening-mcp-server https://sanctions-screening-mcp-server--cyanheads.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add sanctions-screening-mcp-server --url https://sanctions-screening-mcp-server--cyanheads.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "sanctions-screening-mcp-server": {
            "url": "https://sanctions-screening-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "sanctions-screening-mcp-server": {
            "type": "http",
            "url": "https://sanctions-screening-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http sanctions-screening-mcp-server https://sanctions-screening-mcp-server--cyanheads.run.tools
```

## When to use it
- screen a counterparty against OFAC, EU, UK and UN lists before signing
- find a company's LEI by name and jurisdiction
- trace an ownership chain up and down from one LEI
- check an IMO number or wallet address against sanctions records
- pull a full designation record by its reference number

## Example prompts
- Screen this counterparty name against every loaded list with `sanctions_screen_name` and show the scores.
- Resolve “Baltic Freight Ltd” to GLEIF LEI candidates and trace its parents with `sanctions_trace_ownership`.
- Run the `sanctions_vet_counterparty` prompt on this company and summarize the ownership chain.

## Similar
- [Verifex sanctions screening](https://affpapa.org/en/nevibecode/mcp/verifex-sanctions-screening.md) — MCP server · ★ 1 repo stars
- [sanctions](https://affpapa.org/en/nevibecode/mcp/sanctions.md) — MCP server · ★ 6 repo stars
- [Clearparty](https://affpapa.org/en/nevibecode/mcp/clearparty.md) — MCP server
- [trust-check-mcp](https://affpapa.org/en/nevibecode/mcp/trust-check-mcp.md) — MCP server
- [GLEIF MCP Server](https://affpapa.org/en/nevibecode/mcp/gleif-mcp-server.md) — MCP server · ★ 8 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
