AML Watcher MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add -e "API_KEY=${API_KEY}" -e "CATEGORIES=${CATEGORIES}" aml-watcher -- docker run -i --rm -e API_KEY -e PER_PAGE -e MATCH_SCORE -e CATEGORIES -e ALIAS_SEARCH -e RCA_SEARCH -e COUNTRIES techamlw/aml-watcher
Required:API_KEYCATEGORIES+ 5 optional
README.md

Real-time access to AML Watcher's sanctions, watchlist, and PEP databases.

This README provides detailed documentation for the AML Watcher MCP server configuration, focusing on the environment arguments used in the claude_desktop_config.json file. It explains each argument, how to set or modify its values, and how to add new arguments if needed.

Overview

The MCP server is configured to run a Docker container for AML (Anti-Money Laundering) screening. The configuration is defined in the claude_desktop_config.json file, which specifies the Docker command, arguments, and environment variables. The environment variables (env) control the behavior of the AML screening process, such as search parameters, filtering options, and monitoring settings.

βš™οΈ Configuration

πŸ“ Sign Up

πŸ”‘ How to Generate Your API Key

πŸ–₯️ Usage with Claude Desktop

Add this to your claude_desktop_config.json:

🐳 Docker

{
  "mcpServers": {
    "aml": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "API_KEY",
        "-e", "PER_PAGE",
        "-e", "MATCH_SCORE",
        "-e", "CATEGORIES",
        "-e", "ALIAS_SEARCH",
        "-e", "RCA_SEARCH",
        "-e", "COUNTRIES",
        "techamlw/aml-watcher"
      ],
      "env": {
        "API_KEY": "api_key",
        "PER_PAGE": "1"
      }
    }
  }
}
  • After this integration, the user has to provide a username.

🌐 Environment Arguments

Below is a detailed explanation of each environment argument specified in the env section of the claude_desktop_config.json. Each argument includes its purpose, type, default value, constraints, and instructions for setting or modifying its value.

Argument Type Required Default Value Description
API_KEY String Yes N/A The API key for authentication.
COUNTRIES Array No N/A Array of countries to filter reports. Note: ISO 3166-1 alpha-2 country codes are supported. Example: [\"CA\", \"IN\"]. See supported countries
PER_PAGE Integer No 5 The maximum number of results to return.
MATCH_SCORE Integer No 80 Match accuracy level (0–100).
CATEGORIES Array Yes N/A Filters reports by categories (e.g., [\"SIP\", \"PEP Level 1\"]). See available categories
RCA_SEARCH Boolean No True Whether to search within Relatives and Close Associates (RCA).
ALIAS_SEARCH Boolean No True Whether to search within aliases.

You can define custom parameters inside the env section of your configuration file. These parameters are passed to the Docker container as environment variables.

πŸ› οΈ How to Add Environment Variables

Each variable listed in the args array using -e must have a matching key in the env section. If a variable is not defined in the env block, the system may use a default value.

For example, if your args list contains:

"args": [
  "-e", "PER_PAGE",
  "-e", "MATCH_SCORE"
]

Then your env should include:

"env": {
  "PER_PAGE": "1",
  "MATCH_SCORE": "80"
}

πŸ’‘Tip : If you want to manually set the value of a variable, make sure to use the exact same name as listed in the args section. Variable names must match exactly, otherwise the Docker container won't receive the value correctly.

Environment Variables

API_KEYrequiredThe API key for authentication.
COUNTRIESArray of ISO 3166-1 alpha-2 country codes to filter reports.
PER_PAGEThe maximum number of results to return.
MATCH_SCOREMatch accuracy level (0–100).
CATEGORIESrequiredFilters reports by categories (e.g., SIP, PEP Level 1).
RCA_SEARCHWhether to search within Relatives and Close Associates (RCA).
ALIAS_SEARCHWhether to search within aliases.

Configuration

claude_desktop_config.json
{"mcpServers": {"aml": {"command": "docker", "args": ["run", "-i", "--rm", "-e", "API_KEY", "-e", "PER_PAGE", "-e", "MATCH_SCORE", "-e", "CATEGORIES", "-e", "ALIAS_SEARCH", "-e", "RCA_SEARCH", "-e", "COUNTRIES", "techamlw/aml-watcher"], "env": {"API_KEY": "api_key", "PER_PAGE": "1"}}}}

Try it

β†’Check if the individual 'John Doe' appears on any international sanctions lists.
β†’Screen the entity 'Global Corp' for PEP (Politically Exposed Person) status.
β†’Find all high-risk profiles in Canada and India with a match score above 90.
β†’Search for potential matches for 'Jane Smith' including aliases and relatives.

Frequently Asked Questions

What are the key features of AML Watcher?

Access to 215+ sanctions regimes. Coverage of 2.6M+ PEP profiles. Global coverage across 235+ countries. Configurable match accuracy and filtering options. Support for alias and relative/close associate searching.

What can I use AML Watcher for?

Automated customer onboarding screening for financial institutions.. Real-time monitoring of business partners against global sanctions lists.. Compliance teams performing due diligence on high-risk entities.. Integrating AML checks directly into internal agentic workflows..

How do I install AML Watcher?

Install AML Watcher by running: docker run -i --rm -e API_KEY -e PER_PAGE -e MATCH_SCORE -e CATEGORIES -e ALIAS_SEARCH -e RCA_SEARCH -e COUNTRIES techamlw/aml-watcher

What MCP clients work with AML Watcher?

AML Watcher works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep AML Watcher docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare