aml-watcher-mcp-server

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

• Navigate to the **AML Watcher Developer Portal**.
• Click on “API Key” and copy it.

🖥️ 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.

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.