How to Use the ComplyAdvantage MCP in Pydantic AI

Q: How do I register the ComplyAdvantage MCP Server in my Pydantic AI application?

Install the slim package with pip install "pydantic-ai-slimmcp" and initialize MCPToolset with your Vinkius HTTP endpoint. Pass this toolset directly to your Agent instance using the toolsets argument. This registers the compliance tools with full type validation.

Q: Can Pydantic AI handle continuous AML monitoring updates with ComplyAdvantage?

Yes, your agent can call updatesearchmonitors to toggle active tracking on any entity. The framework validates the return payload to confirm the monitor is active before completing the run.

Q: Does this setup support offline testing of ComplyAdvantage MCP tools?

You can mock the MCPToolset responses in your test suite to verify your agent's behavior. This lets you test how your application handles complex match results without hitting the live API.

Force type-safe ComplyAdvantage compliance checks in Pydantic AI to stop silent AML screening failures on this 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 Pydantic AI

Create your Vinkius account to connect ComplyAdvantage to Pydantic AI 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 Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Type-safe screening via MCP Server

Type-safe screening begins with `create_search`, ensuring every AML query sent through this MCP Server matches your exact schema. Pydantic AI validates the search parameters at runtime before the API call is made. If your agent tries to pass an invalid country code or empty name, the framework blocks the call. This prevents bad data from corrupting your compliance audit logs.

Validate match results at runtime

Fetching screening results relies on `get_search_details` to return structured PEP and sanction data directly to your Pydantic AI agent. The framework validates the API response against strict Python types. If the ComplyAdvantage API structure changes, your application raises an immediate validation error instead of processing corrupted data. This keeps your compliance pipeline predictable and safe.

Enforce strict monitoring controls

Modifying monitoring status uses `update_search_monitors` to guarantee that starting or stopping a monitor follows your strict application logic. Your agent executes this tool to manage ongoing risk tracking. Pydantic AI ensures the monitor status update returns the exact expected response model. You don't have to worry about silent failures where a monitor fails to activate.

Setup guide

Set up ComplyAdvantage MCP in Pydantic AI

Prerequisites

Python 3.10+ installed
pydantic-ai-slim[fastmcp] package
Active Vinkius subscription with a valid endpoint token

1

Install Pydantic AI with FastMCP
Run pip install "pydantic-ai-slim[fastmcp]". The FastMCP toolset replaces the deprecated MCPServerHTTP class with full protocol support.
2

Configure the FastMCPToolset
Pass a JSON-style config dict to FastMCPToolset with your Vinkius URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports Streamable HTTP, SSE, and Stdio transports.
3

Create and run your agent
Pass the toolset to Agent(toolsets=[toolset]) and call agent.run(). Swap openai:gpt-4o for any supported model — Anthropic, Google, Mistral, or Groq.

agent.py

from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset

toolset = FastMCPToolset({
    "mcpServers": {
        "complyadvantage-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to ComplyAdvantage tools.",
)

result = await agent.run("List recent ComplyAdvantage transactions")
print(result.output)

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 Pydantic AI

Install the slim package with `pip install "pydantic-ai-slim[mcp]"` and initialize `MCPToolset` with your Vinkius HTTP endpoint. Pass this toolset directly to your `Agent` instance using the `toolsets` argument. This registers the compliance tools with full type validation.

The framework will raise a validation error instantly rather than letting your agent make decisions on malformed data. This strict validation prevents compliance bypasses caused by API payload changes.

Yes, your agent can call `update_search_monitors` to toggle active tracking on any entity. The framework validates the return payload to confirm the monitor is active before completing the run.

You can mock the `MCPToolset` responses in your test suite to verify your agent's behavior. This lets you test how your application handles complex match results without hitting the live API.

Your search parameters and whitelist decisions are processed inside zero-trust V8 isolates managed by Vinkius. No compliance logs are persisted on disk, and all API tokens are encrypted in transit.

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