How to Use the Nuvei MCP in Pydantic AI

Q: How do I register the Nuvei MCP Server in Pydantic AI?

Use the MCPToolset class with the MCP Server URL. Pass this toolset into the toolsets argument of your Agent constructor to expose tools like createpayment.

Q: How does Pydantic AI handle the security of raw card details?

Raw card data passed to createcardtoken is transmitted securely over HTTPS and never logged. The Vinkius runtime executes the server in an isolated V8 sandbox, preventing sensitive payment details from leaking into your application logs.

Run type-safe payment pipelines with Pydantic AI and Nuvei, validating every transaction payload at runtime.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Nuvei MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Validate Nuvei payment payloads with Pydantic AI

Stop silent failures in your payment pipelines. When your agent calls `create_payment`, Pydantic AI validates the returned transaction ID and status against strict Python models at runtime. If the API returns unexpected data, the system fails loudly. This strict validation extends to capture flows. The agent uses `capture_payment` to finalize charges, and the MCP Server ensures the returned status matches your expected schema before your application state updates.

Securely tokenize cards using a type-safe MCP Server

Ensure your payment tokens are formatted correctly before saving them. Your agent runs `create_card_token` to vault card details, and Pydantic AI checks that the returned token matches your precise data models. The agent manages these tokens safely over time. Using `get_token` and `update_token`, the agent modifies card details knowing that any validation mismatch will trigger an immediate runtime error rather than corrupting your database.

Reconcile payments with strict runtime validation

Pull transaction lists with absolute confidence. The agent calls `get_transactions` to fetch historical records, and Pydantic AI parses the list into typed Python objects, catching any missing fields or malformed dates. For dispute resolution, the agent calls `get_payment` to check the exact status of a charge. If a refund is needed, the agent calls `refund_payment` or cancels authorizations with `void_payment` using fully validated inputs.

Setup guide

Set up Nuvei 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": {
        "nuvei-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

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

result = await agent.run("List recent Nuvei 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 Nuvei. 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 Nuvei 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 Nuvei MCP in Pydantic AI

Use the `MCPToolset` class with the MCP Server URL. Pass this toolset into the `toolsets` argument of your `Agent` constructor to expose tools like `create_payment`.

Pydantic AI raises a validation error immediately. Instead of proceeding with corrupt data, the agent halts execution, allowing your code to handle the schema mismatch safely.

Yes, Pydantic AI is model-agnostic. You can run this server with Anthropic, Gemini, or local models while maintaining strict type safety across all payment tools.

Yes, Pydantic AI supports both Streamable HTTP and SSE transports. You can connect to this externally hosted MCP Server using whichever transport fits your deployment architecture.

Raw card data passed to `create_card_token` is transmitted securely over HTTPS and never logged. The Vinkius runtime executes the server in an isolated V8 sandbox, preventing sensitive payment details from leaking into your application logs.

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