How to Use the ComplyAdvantage MCP in Google ADK

Q: How do I connect the ComplyAdvantage MCP Server to my Google ADK agent?

Install the library via pip install google-adk and create an McpToolset pointing to your Vinkius HTTP URL. Pass this toolset into your LlmAgent constructor under the tools list. This exposes all fourteen compliance tools to your Gemini model.

Q: How does Google ADK handle complex AML matches returned by ComplyAdvantage?

The agent uses getsearchdetails to fetch the full match report. Gemini's long-context window allows the agent to read through hundreds of pages of adverse media to determine if the match is a true positive.

Q: Can I restrict which ComplyAdvantage tools my Google ADK agent can access?

Yes, you can use the toolnames filter in your McpToolset configuration to limit the agent's access. This prevents the agent from calling tools like updatesearchentities unless specifically authorized.

Run high-volume ComplyAdvantage AML checks directly from your Google ADK enterprise agents using our MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect ComplyAdvantage MCP to Google ADK

Create your Vinkius account to connect ComplyAdvantage to Google ADK and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup ComplyAdvantage with Google ADK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Screen customer lists directly from BigQuery

Running bulk AML checks starts with `create_search`, allowing your Google ADK agent to screen thousands of names pulled directly from BigQuery. The agent uses Gemini's million-token context window to analyze massive customer lists in one go. You feed the raw database rows directly to the agent. It runs the compliance checks and logs the results back to your database without any manual data entry.

Continuous risk tracking via MCP Server

Continuous risk tracking uses `update_search_monitors` to start or stop active monitoring on the ComplyAdvantage MCP Server. This tool lets your enterprise agent manage dynamic risk profiles automatically. When Vertex AI detects a change in customer behavior, your Google ADK agent triggers this tool to enable ongoing sanctions tracking. The agent handles the API calls in the background while keeping your compliance records updated.

Extract detailed PEP and sanction reports

Retrieving detailed risk reports depends on `get_search_details` to pull PEP lists and adverse media hits for your Google ADK agent to review. The agent reads the full compliance payload to make complex risk decisions. By combining Gemini's reasoning with this detailed data, your agent can draft internal compliance memos. It extracts the exact match reasons and stores them in your cloud storage.

Setup guide

Set up ComplyAdvantage MCP in Google ADK

Prerequisites

Python 3.10+ installed
google-adk package (pip install google-adk)
Active Vinkius subscription with a valid endpoint token

1

Install Google ADK

Run pip install google-adk to install the Agent Development Kit. MCP support is included via the McpToolset class.
2

Connect via SSE transport

Use McpToolset.from_server() with SseServerParams pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create an LlmAgent

Pass the returned mcp_tools list directly to LlmAgent(tools=mcp_tools). The ADK maps each MCP tool to a native Gemini function call — no manual schema definitions required.
4

Run with any Gemini model

The agent works with any Gemini model (gemini-2.0-flash, gemini-2.5-pro, etc.). Copy the full example on the right to get started with ComplyAdvantage tools in your ADK agent.

agent.py

from google.adk.agents import LlmAgent
from google.adk.tools.mcp_tool.mcp_toolset import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import SseServerParams

# Connect to the MCP via SSE
mcp_tools, exit_stack = await McpToolset.from_server(
    connection_params=SseServerParams(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    )
)

# Create your agent with auto-discovered tools
agent = LlmAgent(
    name="ComplyAdvantage_agent",
    model="gemini-2.0-flash",
    instruction="You have access to ComplyAdvantage tools via MCP.",
    tools=mcp_tools,
)

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by ComplyAdvantage. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect ComplyAdvantage now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about ComplyAdvantage MCP in Google ADK

Install the library via `pip install google-adk` and create an `McpToolset` pointing to your Vinkius HTTP URL. Pass this toolset into your `LlmAgent` constructor under the tools list. This exposes all fourteen compliance tools to your Gemini model.

Yes, your agent can read customer tables from BigQuery and pass those names to `create_search`. It processes the compliance results and updates your database tables in real time.

The agent uses `get_search_details` to fetch the full match report. Gemini's long-context window allows the agent to read through hundreds of pages of adverse media to determine if the match is a true positive.

Yes, you can use the `tool_names` filter in your `McpToolset` configuration to limit the agent's access. This prevents the agent from calling tools like `update_search_entities` unless specifically authorized.

All entity details and search histories are handled through ephemeral Vinkius sandboxes that destroy your session data immediately after execution. Your compliance data never trains Google's models or leaves your secure cloud parameter boundary.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript