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 AML Testing MCP server is a Node.js application built with TypeScript that connects to the AML Watcher API to perform searches for individuals based on their names. It is designed to run as a command-line tool and integrates with Claude Desktop via the Model Context Protocol (MCP).

⚙️ Configuration

📝 Sign Up

• If you already have an account, Visit the AML Watcher Developer Portal.
• If you don’t have an account, please click here to contact us.

🔑 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:

🟦 Node.js

{
  "mcpServers": {
    "aml": {
      "command": "npx",
      "args": [
        "-y",
        "@amlwatcher-modelcontextprotocol/aml_watcher_mcp"
      ],
      "env": {
        "API_KEY": "your_api_key",
        "PER_PAGE": "5",
        "MATCH_SCORE": "80",
        "ALIAS_SEARCH": "true",
        "RCA_SEARCH": "true"
      }
    }
  }
}

• Replace your_api_key with the API key obtained from the AML Watcher Developer Portal.
• 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: "COUNTRIES":"[US]". | | PER_PAGE | Integer | No | 5 | The maximum number of results to return. | | MATCH_SCORE | Integer | No | 70 | Match accuracy level (0–100). Not applicable for "Adverse Media" category. | | 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

To customize the search behavior, you can add, remove or modify environment variables in the env section of the claude_desktop_config.json. Ensure the variable names match those expected by the server.

For example:

"env": {
  "API_KEY": "your_api_key",
  "PER_PAGE": "3",
  "COUNTRIES":"[UK,USA]"
}

🚀 Installation and Setup

Install the Package:

npm install @amlwatcher-modelcontextprotocol/aml_watcher_mcp

Integrate with Claude Desktop:

• Update claude_desktop_config.json as shown above.
• Ensure the npx command is available in your environment.

💡Tip: If a variable is missing, the server uses the default value listed above.