How to Use the Nuvei MCP in Claude

Q: How do I connect Nuvei to my Claude Desktop app?

You add the configuration to your local claudedesktopconfig.json file. Put the Nuvei MCP server under the mcpServers key with your Vinkius API credentials. Save the file and restart Claude Desktop to see the tools appear in your chat.

Q: Can Claude Desktop execute partial refunds on Nuvei payments?

Yes, the refundpayment tool accepts partial amounts directly from your chat prompt. Claude Desktop passes the exact refund value to the processor, allowing you to handle customer service partial returns instantly.

Q: How does the Nuvei tokenization process work inside Claude Desktop?

When you provide card details, Claude Desktop uses createcardtoken to securely vault the card information. The server returns a secure token, preventing raw card data from being exposed in your desktop chat history.

Q: Can I capture pre-authorized payments through Claude Desktop?

Yes, the capturepayment tool processes authorized transactions directly. If you omit the amount parameter, Claude Desktop automatically captures the full authorized total on the processor's end.

Q: Where does my sensitive Nuvei card data go when using Claude Desktop?

Raw card details are sent straight to the secure vault via createcardtoken and are never saved locally. The desktop application only handles the resulting token references, keeping your local environment clean of PCI scope.

Run real-time Nuvei transactions and tokenize cards directly from your Claude Desktop app using this secure 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 Nuvei MCP to Claude Desktop

Create your Vinkius account to connect Nuvei to Claude Desktop 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 Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run instant Nuvei charges inside Claude Desktop

Look, here's the thing. `create_payment` initiates real-time payment authorization and charge requests to the processor network. When you paste raw order details into Claude Desktop, your agent maps the fields and triggers the charge. You see the immediate transaction ID and payment status right in your chat window. If you need to stop a charge before settlement, `void_payment` cancels pending authorizations before they capture. For settled funds, `refund_payment` executes partial or full refunds. This setup lets you manage the entire lifecycle of a transaction without leaving your desktop app.

Vault customer cards with Claude Desktop MCP Server

It comes down to this: `create_card_token` tokenizes plain card details into secure, vaulted payment tokens. Your agent takes raw numbers from your customer support chat in Claude Desktop and vaults them instantly. This keeps raw card numbers completely out of your local logs. You can inspect these details later using `get_token` to check metadata or update expiry dates with `update_token`. If a customer cancels their subscription, `delete_token` stops future recurring attempts by purging the reference immediately.

Track payment status and histories in chat

`get_payment` retrieves the live settlement status mapped to any specific Nuvei payment ID. This MCP integration lets your agent query the processor to verify if the async payment cleared when customers ask about pending transfers. To run larger reviews, your agent runs `get_transactions` to list and filter historical transaction records. You get the raw data sorted and ready to analyze without ever loading a separate merchant dashboard.

Setup guide

Set up Nuvei MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Nuvei MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Nuvei MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under nuvei-mcp.

json

{
  "mcpServers": {
    "nuvei-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Claude Desktop

You add the configuration to your local `claude_desktop_config.json` file. Put the Nuvei MCP server under the `mcpServers` key with your Vinkius API credentials. Save the file and restart Claude Desktop to see the tools appear in your chat.

Yes, the `refund_payment` tool accepts partial amounts directly from your chat prompt. Claude Desktop passes the exact refund value to the processor, allowing you to handle customer service partial returns instantly.

When you provide card details, Claude Desktop uses `create_card_token` to securely vault the card information. The server returns a secure token, preventing raw card data from being exposed in your desktop chat history.

Yes, the `capture_payment` tool processes authorized transactions directly. If you omit the amount parameter, Claude Desktop automatically captures the full authorized total on the processor's end.

Raw card details are sent straight to the secure vault via `create_card_token` and are never saved locally. The desktop application only handles the resulting token references, keeping your local environment clean of PCI scope.

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