# Hyperswitch MCP for AI Agents AI Agent Connect

> Hyperswitch lets your AI agents handle payment infrastructure tasks directly. It gives your agent the ability to manage customer records, process refunds, track payment disputes, and monitor payouts through the Hyperswitch API. Use it to automate your fintech operations, handle high-volume refund requests, and keep a real-time eye on your payout status without manual dashboard hopping.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_fpj7tS8GsefUH9b6f08rDfPwfDVpt0GMOH75AHWw/ai-agent-connect
- **Tags:** payment-gateway, open-source, refund-management, dispute-resolution, payouts, fintech-api

## Description

Instead of switching between tabs to check why a payment failed or manually digging through a database to find a customer's refund status, you can let your AI agent handle it. This Connector connects your AI client to the Hyperswitch payment gateway, allowing it to pull specific transaction details or list all active disputes in seconds. If a customer asks for a refund, your agent can check the status and provide an update or trigger the process immediately. It turns your AI into a functional member of the payments team, capable of auditing payouts and managing customer data. You'll find it's much easier to keep your revenue operations organized when your AI can actually interact with your payment data. By hosting this through Vinkius, you get a reliable way to plug these fintech capabilities into your existing AI workflow.

## Tools

### get_dispute
Pulls the current status and details for a specific payment dispute. Use this to see why a chargeback happened.

### get_payment
Retrieves the full transaction history for a specific payment record. It shows the exact status of a single charge.

### get_payout
Gets the details for a specific payout from your account. Use this to track where your funds are going.

### list_customers
Shows a complete list of all customers in your Hyperswitch account. It's great for high-level auditing.

### get_customer
Fetches the specific profile and details for a single customer. This helps your agent provide accurate info to users.

### get_refund
Pulls the specific details for a single refund request. Use this to confirm if a customer's money was sent back.

### list_disputes
Lists every active and past dispute associated with your account. This helps you stay on top of chargebacks.

### list_payments
Shows a full list of all processed and pending payments. Use this to get a bird's-eye view of your revenue.

### list_payouts
Provides a list of all payouts currently in your system. Use this to monitor your outgoing funds.

### list_refunds
Shows a complete list of all refunds processed through the gateway. It helps you track total refund volume.

## Prompt Examples

**Prompt:** 
```
Show me the last 5 refunds and their status.
```

**Response:** 
```
### Recent Refunds

| Refund ID | Amount | Status | Date |
| --- | --- | --- | --- |
| `ref_9921` | $45.00 | **Completed** | Oct 24 |
| `ref_9918` | $120.00 | **Pending** | Oct 23 |
| `ref_9915` | $12.50 | **Completed** | Oct 23 |
| `ref_9910` | $200.00 | **Failed** | Oct 22 |
| `ref_9908` | $88.00 | **Completed** | Oct 22 |
```

**Prompt:** 
```
Are there any open disputes right now?
```

**Response:** 
```
I found **3** active disputes that need your attention:

*   **Dispute #882** - $450.00 (High Priority)
*   **Dispute #885** - $22.00 (Low Priority)
*   **Dispute #889** - $115.00 (Medium Priority)

Would you like me to pull the full details for any of these?
```

**Prompt:** 
```
Get the details for customer cust_99.
```

**Response:** 
```
### Customer Profile: `cust_99`

*   **Name:** Alex Rivera
*   **Email:** alex.r@example.com
*   **Account Status:** Active
*   **Total Spent:** $1,450.20
*   **Last Transaction:** $89.00 (Completed on Oct 25)
```

## Capabilities

### Pull customer records
Get specific profile details or list every customer in your account.

### Track payment history
View individual transaction details or see a full list of all processed payments.

### Handle refund requests
Check the status of specific refunds or list all processed refund history.

### Manage payment disputes
Identify and retrieve details for every active dispute in your system.

### Monitor payout status
Check specific payout details or list all payouts for your records.

## Use Cases

### Processing a customer refund
A customer asks for a refund. The agent uses get_refund to see if it was processed and list_refunds to check the history.

### Weekly payout auditing
An ops manager needs a weekly report. The agent uses list_payments and list_payouts to summarize the week's volume.

### Resolving a missing payment ticket
A support ticket comes in about a missing payment. The agent uses get_payment to find the transaction ID and status.

### Identifying high-risk disputes
A dispute is flagged. The agent uses list_disputes to identify the high-priority issues that need human attention.

## Benefits

- Stop manual dashboard hopping by letting your agent pull payment data using list_payments.
- Handle refund requests faster by using list_refunds and get_refund to check status instantly.
- Stay on top of chargebacks by having your agent monitor all active disputes with list_disputes.
- Get real-time visibility into your money flow with list_payouts and get_payout.
- Improve support response times by fetching customer info quickly with get_customer.
- Automate fintech audits by listing all customers and payments without manual exports.

## How It Works

The bottom line is your AI agent gets direct access to your payment data for faster operations.

1. Connect your Hyperswitch API keys to the Connector.
2. Link the Connector to your AI client via Vinkius.
3. Ask your agent to find specific payments or list all refunds.

## Frequently Asked Questions

**Can Hyperswitch MCP help with my refunds?**
Yes, it lets your agent check refund history and status instantly. You can ask it to list all refunds or get details on a specific one without opening your dashboard.

**How does Hyperswitch MCP handle payment disputes?**
It pulls the status of every dispute in your account. Your agent can identify which chargebacks need attention and provide the details for each one.

**Can I use Hyperswitch MCP to see my payouts?**
Yes, the Connector can list all payouts or show you the specific details of a single payout. It's a great way to monitor your outgoing funds in real-time.

**Is Hyperswitch MCP good for fintech support?**
It's excellent for support. Your agent can quickly pull customer profiles and payment statuses to answer user questions faster and more accurately.

**How do I connect Hyperswitch MCP to my agent?**
You can connect it easily through Vinkius. Just provide your Hyperswitch API keys, and your AI client will have the tools it needs to manage your payments.

**How do I get Hyperswitch API credentials?**
You can find your API Secret Key in the Hyperswitch dashboard under 'API Keys'.

**Does it support multiple processors?**
Hyperswitch is a payment switch that abstracts multiple processors. This Connector interacts with the Hyperswitch unified API.

**Can I process refunds with this Connector?**
This version focus on listing and retrieving refund details. Actions to trigger new refunds may be added in future updates.

**Can I process refunds with this MCP?**
This version focus on listing and retrieving refund details. Actions to trigger new refunds may be added in future updates.