# Nuvei MCP for AI Agents AI Agent Connect

> Nuvei MCP connects your AI agent to your Nuvei merchant account. You can track global payments, manage transactions, and handle card tokenization through natural conversation. It lets your agent act as a direct interface for your payment gateway, handling everything from live order authorizations to refunding and auditing.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_51Syt4DGAHWALff9VkisRN0rIeEAhRTwfgvkTXCY/ai-agent-connect
- **Tags:** global-payments, transaction-auditing, tokenization, merchant-services, ecommerce-payments, api-integration

## Description

Imagine you're trying to reconcile a messy batch of international payments. Usually, that means jumping into a heavy merchant dashboard, hunting for specific transaction IDs, and manually checking statuses. With this Connector, you just tell your agent what to find. It pulls the data directly from your Nuvei account and puts it in front of you. If a customer claims they were charged but the order is still pending, your agent can check the live status or confirm a refund in seconds. You can also manage card vaulting without ever touching sensitive raw data, which keeps your security posture tight. Because Vinkius hosts this connection, you get a unified way to manage these payment actions across different workflows. It turns a multi-tab headache into a single conversation where you can authorize charges, handle returns, and audit your history without leaving your workspace.

## Tools

### capture_payment
Capture a previously authorized card payment. You can choose to capture the full amount or a specific value.

### create_payment
Initialize a new payment intent with Nuvei. This returns the transaction ID and status.

### delete_token
Permanently delete a vaulted payment token. Use this to stop future recurring charges or one-click purchases.

### get_payment
Retrieve the current status mapped to a Nuvei Payment ID. Use this to check if an async payment cleared.

### get_token
View details of a previously vaulted Nuvei Card or Payment Token. You can check expiry dates and card types.

### get_transactions
List or enumerate historical transaction records. This helps with auditing and seeing recent account activity.

### refund_payment
Refund a fully captured Nuvei payment. This tool supports both full and partial refund amounts.

### update_token
Mutate specific fields inside a vaulted token. You can update an expiry date without needing the full card details again.

### void_payment
Cancel a pending authorized payment to prevent capture. This only works for payments that haven't cleared yet.

### create_card_token
Tokenize plain card details into a vaulted payment token. This keeps sensitive data out of your systems.

## Prompt Examples

**Prompt:** 
```
Fetch the status of transaction ID 987654321.
```

**Response:** 
```
I've queried Nuvei and the transaction `987654321` was **Declined**. 

**Gateway Details:**
- **Reason:** Insufficient Funds
- **Card Type:** Visa
- **Status:** Failed
```

**Prompt:** 
```
Show me the 10 most recent transactions on my account.
```

**Response:** 
```
Here is a summary of your 10 most recent Nuvei transactions:

| Transaction ID | Amount | Status | Date |
| :--- | :--- | :--- | :--- |
| TXN_001 | $45.00 | Approved | 2026-07-10 |
| TXN_002 | $12.50 | Refunded | 2026-07-09 |
| TXN_003 | $120.00 | Approved | 2026-07-09 |
| TXN_004 | $30.00 | Pending | 2026-07-08 |
```

**Prompt:** 
```
Retrieve the token details for Customer UUID usr-88 in the vault.
```

**Response:** 
```
I've pulled the vault details for `usr-88`:

- **Token ID:** `tok_882391`
- **Card Type:** Visa
- **Expiry:** 12/28
- **Status:** Active

Would you like me to initiate a new payment using this token?
```

## Capabilities

### Authorize and charge payments
Start a new payment intent and get back the transaction ID and status instantly.

### Check transaction status
Retrieve the current status mapped to a specific Nuvei Payment ID.

### Pull transaction history
List or enumerate historical transaction records from your merchant account.

### Securely vault card tokens
Turn plain card details into a vaulted payment token to keep sensitive data out of your logs.

### Process refunds
Issue a full or partial refund for any fully captured Nuvei payment.

### Void pending charges
Cancel a pending authorized payment to prevent it from being captured.

### Manage vaulted tokens
Delete, update, or view details of previously vaulted card and payment tokens.

## Use Cases

### Failed Payment Audit
A finance lead sees a discrepancy. They ask the agent to list transactions from last Tuesday to find the specific failed ID using get_transactions.

### Support Verification
A customer calls about a charge. The support rep asks the agent to check the status of a specific payment ID to see if it cleared using get_payment.

### Secure Checkout Testing
An engineer wants to test a new checkout flow. They ask the agent to create a card token to simulate a returning customer using create_card_token.

### Subscription Cleanup
A user wants to cancel a recurring plan. The agent uses delete_token to stop the charges without needing the card number again.

## Benefits

- Stop manual dashboard hunting by using get_transactions to pull history instantly.
- Secure your data by using create_card_token to keep raw card info out of your internal logs.
- Speed up support by using get_payment to check live statuses during customer calls.
- Handle refunds faster with refund_payment to resolve customer issues in one step.
- Manage subscriptions easily by using delete_token to stop recurring charges immediately.
- Reduce engineering overhead by using create_payment to automate order authorizations.

## How It Works

The bottom line is you get a direct line from your chat interface to your global payment gateway.

1. Connect your Nuvei API credentials and merchant details to the Connector.
2. Open your preferred AI client like Claude, Cursor, or Windsurf.
3. Ask your agent to pull transaction logs, check payment statuses, or process refunds.

## Frequently Asked Questions

**Can the Nuvei MCP handle international payments?**
Yes, it connects to the Nuvei platform which is built for global transactions. It allows you to manage payments across different regions directly through your AI agent.

**How do I use Nuvei MCP to check if a payment cleared?**
You can ask your agent to check a specific payment ID. It will pull the live status from your merchant account and tell you if the funds were successfully captured.

**Does Nuvei MCP keep my customer data safe?**
Yes, it uses card tokenization. This means your AI agent handles secure tokens rather than raw card numbers, keeping your sensitive customer data out of the chat history.

**Can I process refunds through the Nuvei MCP?**
Yes, you can ask your agent to issue a full or partial refund for any captured payment. It handles the request and confirms the status for you.

**Is the Nuvei MCP good for subscription management?**
It is excellent for managing recurring charges. You can use it to delete vaulted tokens to stop subscriptions or update token details without needing the card info again.

**How do I find old transactions with Nuvei MCP?**
Your agent can pull a list of historical records from your merchant account instantly. You just need to tell it the timeframe or the specific transaction details you are looking for.

**How can I securely pass card inputs if the chat format is plain text?**
The integration routes direct requests to Nuvei's sandbox or live vault using the `create_card_token` feature natively. Since the AI environment is localized and isolated by default, inputs made within Claude or Cursor are ephemeral and pass straight into Nuvei via the secure connection layer without persisting in logs.

**Can I query why a specific transaction was declined?**
Yes. Ask the agent to use `get_payment` with your transaction ID. The AI will parse the complex payload returned by Nuvei and summarize the error message (e.g., Insufficient Funds, Do Not Honor) directly in human language.

**Is it possible to track batch settlements?**
Use the `get_transactions` capability. Your prompt can specify that you want to list out the last 20 payments, and the AI will structure them neatly as a tabular view in your chat interface.