How to Use the ComplyAdvantage MCP in Vercel AI SDK

Automate KYC and AML screening directly within your Vercel AI SDK frontends to show real-time risk data to your users.

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 Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Real-time screening in Vercel AI SDK

Trigger `create_search` immediately when a user submits their identity details. Your application gets the result back instantly, avoiding the lag of traditional back-office lookups. Since this MCP Server works with the Vercel AI SDK, you can pipe the output straight into your React components. Your users see the status of their screening as it happens.

Manage search status and risk

Use `update_search` to change the state of an entity record without leaving your interface. You keep your dashboard in sync with your compliance backend using specific tool calls. When risk levels change, `update_search_entities` lets you adjust whitelists or internal risk profiles. It’s all handled through typed calls that keep your application state predictable.

Automated monitoring pipelines

Enable ongoing oversight with `update_search_monitors` to watch for new sanctions or PEP alerts. You set the monitoring status and the system tracks changes automatically. Fetch the latest status updates via `get_search_monitors` to ensure your UI displays the most current information. You don't need manual refreshes to stay on top of risk profiles.

Setup guide

Set up ComplyAdvantage MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all ComplyAdvantage tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent ComplyAdvantage transactions",
});

console.log(text);
await mcpClient.close();

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 Vercel AI SDK

You initialize the client with the provided endpoint and map the `create_search` tool to your agent. Once linked, you pass the entity data as arguments to the tool, and the result streams directly into your application state.

Yes, the transport layer is fully compatible with edge runtimes. You just need to ensure your environment variables for the endpoint are configured correctly before initializing the connection.

The SDK treats the server output as a tool call result. You can parse the JSON returned by `get_search_details` and render it immediately in your frontend components without extra overhead.

Yes, Vinkius manages the auth tokens. You only need to provide the single endpoint URL provided in your dashboard to connect the server.

Your agent only transmits the specific PII required for screening. The server operates in a secure sandbox, and no data is stored or logged outside of your authorized account parameters.

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