# ComplyAdvantage MCP

> ComplyAdvantage MCP automates Anti-Money Laundering (AML) and Know Your Customer (KYC) compliance checks right within your agent. Use this connector to screen individuals, companies, and entities for risk factors. You can run new searches with customizable filters, manage ongoing monitoring alerts, retrieve full search histories, and add detailed case notes without leaving your workflow.

## Overview
- **Category:** security-compliance
- **Price:** Free
- **Tags:** aml, kyc, entity-screening, risk-management, compliance-automation

## Description

This MCP lets you handle complex financial compliance tasks using natural conversation. Instead of logging into separate platforms to check regulatory databases or pull audit trails, your agent performs the work for you. You can instantly run new searches against millions of records, filtering results by fuzziness and specific criteria. Need to track a client's risk over time? Start or stop ongoing monitoring alerts with ease. The system also helps keep case files organized; add internal notes directly to an entity record or update a search status for assignment tracking. If you need more connectors like this—spanning compliance, legal, or finance—Vinkius hosts thousands of MCPs in one place, letting your agent access everything without juggling subscriptions.

## Tools

### acknowledge_monitor
Marks a change made to an entity's monitored search as acknowledged.

### create_comment
Adds internal notes or context to a specific search or entity record.

### create_search
Initiates a new compliance check for an individual or company, allowing optional fuzziness and filters.

### delete_search_tag
Removes specific tags attached to a search record.

### get_search_details
Retrieves the full, detailed results set for any completed compliance search.

### get_search_monitors
Pulls details about all currently active risk monitoring services on accounts.

### get_search
Provides a high-level overview of a specific compliance search attempt.

### list_comments
Retrieve comments for a specific search

### list_searches
Generates a list of all previous screening attempts conducted in the account history.

### update_search_entities
Modifies an entity's details, such as updating its risk level or adding it to a whitelist.

### update_search_monitors
Starts or stops the automated monitoring process for specific entities.

### update_search_profile
Updates the general search profile associated with a continuously monitored search record.

### update_search
Changes key administrative details of a search, like its status or assigned owner.

### list_users
Retrieves the list of authorized users within the ComplyAdvantage account.

## Prompt Examples

**Prompt:** 
```
Search for a person named 'John Smith' with a fuzziness of 0.7.
```

**Response:** 
```
I've initiated the search for 'John Smith'. The search ID is 'SR-99283'. I found 3 potential matches. Would you like to see the full details for these results?
```

**Prompt:** 
```
List the most recent searches performed in my account.
```

**Response:** 
```
Retrieving your search history... Here are the last 5 searches: 'Acme Corp' (ID: 101), 'Jane Doe' (ID: 102), 'Global Tech' (ID: 103), etc. Which one would you like to inspect?
```

**Prompt:** 
```
Add a comment to search ID 12345 saying 'Verified identity via passport'.
```

**Response:** 
```
Comment successfully added to search 12345. The note 'Verified identity via passport' is now recorded in the case history.
```

## Capabilities

### Run Entity Screening
You can initiate new searches for any individual or company using specific filters and fuzziness settings.

### Retrieve Search History
Fetch a complete list of all past screening attempts, making audit trail gathering simple.

### Manage Risk Monitoring
Start or halt automated monitoring on an entity to track changes in their risk profile over time.

### Update Case Details
Modify search statuses, assignees, and add internal notes directly to the case file for collaboration.

### Refine Entity Records
Adjust entity classifications or place entities on a whitelist using direct tool calls.

## Use Cases

### Client Onboarding Due Diligence
A Compliance Officer needs to onboard a new corporate client. Instead of running checks on three separate vendor dashboards for identity screening, they simply ask their agent to run the search using `create_search`. The MCP returns the results, and the officer uses `get_search_details` to pull all necessary data into one conversation flow.

### Monitoring Suspicious Activity
A Risk Analyst identifies a client that needs continuous scrutiny. They use `update_search_monitors` to activate alerts on the entity's risk profile. Later, when the agent reports a change, they can immediately acknowledge it using `acknowledge_monitor`, documenting the event.

### Audit and Reporting Prep
A Legal Team member needs proof of all screening done last quarter for an audit. They ask the MCP to list previous searches via `list_searches`. The system compiles a comprehensive history, which they can then use to retrieve specific details using `get_search_details`.

### Internal Team Collaboration
A Compliance Officer finishes an initial review of a high-risk entity. They immediately add detailed internal findings and observations by running `create_comment`. This ensures the next analyst picking up the case sees all necessary context.

## Benefits

- Saves time on documentation: Instead of opening multiple tabs to manually record findings, you use `create_comment` to add context directly into the case file. This keeps a perfect audit trail automatically.
- Reduces human error in screening: You can initiate new checks with `create_search`, ensuring that every client review uses customizable filters and fuzziness levels right away.
- Keeps compliance continuous: Using `update_search_monitors` means you don't have to manually check for risk changes. The MCP tracks those alerts, so your team always knows when something shifts.
- Simplifies case management: You can use tools like `update_search` or `create_comment` to change the status or assign an owner to a search record instantly, keeping workflow clear.
- Provides complete visibility: Reviewing past work is easy. The ability to run `list_searches` means you never lose track of who was checked, when, and under what criteria.

## How It Works

The bottom line is that your compliance workflow stays entirely within your AI client, eliminating dashboard hopping.

1. Subscribe to the ComplyAdvantage MCP and provide your required API key.
2. Tell your agent what you need to check—for instance, 'Screen John Smith with a 0.7 fuzziness level.'
3. The MCP executes the search, returns the results, and lets you continue managing or updating the record through conversation.

## Frequently Asked Questions

**How do I run initial entity checks using ComplyAdvantage MCP?**
You initiate new compliance searches by asking the agent to use `create_search`. You can specify fuzzy matching and filters right in your prompt, making sure the check is targeted immediately.

**Can I track a client's risk changes with ComplyAdvantage MCP?**
Yes. Use `update_search_monitors` to put an entity under continuous monitoring. The system then alerts you when its risk profile changes, and you can acknowledge it using `acknowledge_monitor`.

**What is the best way to document findings with ComplyAdvantage MCP?**
Use `create_comment`. This tool ensures that your notes are permanently attached to the search record, creating an official part of the audit trail rather than just floating in a chat history.

**Does ComplyAdvantage MCP help me see old searches?**
Absolutely. You can run `list_searches` to get a summary list of all past checks, and then use `get_search_details` on any specific ID for the full report.

**Can I update an entity's risk level using ComplyAdvantage MCP?**
Yes. The `update_search_entities` tool lets you adjust classification details or whitelist status directly within your workflow, maintaining compliance accuracy.