AML-watcher-MCP-Server

AML-watcher-MCP-Server

3.1

If you are the rightful owner of AML-watcher-MCP-Server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This document provides detailed instructions for configuring the AML Watcher MCP server, focusing on the environment arguments used in the `claude_desktop_config.json` file.

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.

ArgumentTypeRequiredDefault ValueDescription
API_KEYStringYesN/AThe API key for authentication.
COUNTRIESArrayNoN/AArray of countries to filter reports. Note: ISO 3166-1 alpha-2 country codes are supported. Example: [\"CA\", \"IN\"]. See supported countries
PER_PAGEIntegerNo5The maximum number of results to return.
MATCH_SCOREIntegerNo80Match accuracy level (0–100).
CATEGORIESArrayYesN/AFilters reports by categories (e.g., [\"SIP\", \"PEP Level 1\"]). See available categories
RCA_SEARCHBooleanNoTrueWhether to search within Relatives and Close Associates (RCA).
ALIAS_SEARCHBooleanNoTrueWhether 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.