# Braintree MCP for AI Agents AI Agent Connect

> Braintree MCP lets your AI agent handle payments directly. Search transactions, manage customer profiles, and issue refunds without leaving your chat. It connects your Braintree gateway to your favorite AI client so you can handle high-volume payment tasks through plain English commands.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_OrZt8at3Cszx0AC8W3EGzjx9G5lNeLsiQeo0EYE6/ai-agent-connect
- **Tags:** global-payments, transaction-management, checkout-experience, refund-processing, payment-gateway, financial-api

## Description

Imagine you're dealing with a mess of customer refund requests or trying to track down a specific transaction from three months ago. Usually, this means jumping into a complex dashboard, filtering through hundreds of rows, and cross-referencing IDs. With this Braintree MCP, you just tell your AI agent what you need. You can ask it to find a customer by their email or pull up the details of a specific payment. It handles the heavy lifting of querying the Braintree GraphQL API for you. If a customer wants a refund, you just tell the agent to do it, and it handles the logic of checking the status and processing the amount. It's about moving from manual data entry to just giving directions. Because Vinkius hosts this Connector, you can plug it into your existing workflow and start managing your payment lifecycle through a simple conversation. It turns your payment gateway into a searchable, actionable database for your agent.

## Tools

### capture_transaction
Captures an authorized transaction to move funds. Use this when you need to finalize a payment that's currently pending.

### search_customers
Searches your customer vault by email or other criteria. Use this to find a user's account when they don't have their ID handy.

### search_transactions
Lists recent transactions from your gateway. This helps you spot trends or find recent errors quickly.

### void_transaction
Voids an authorized transaction so it doesn't go through. Use this to cancel a payment before the funds are actually captured.

### get_transaction
Pulls up every detail for a single transaction. It's the fastest way to see metadata for a specific payment ID.

### refund_transaction
Issues a full or partial refund for a settled payment. This tool handles the logic of sending money back to the customer.

### charge_payment_method
Charges a specific payment method directly. This is the go-to for initiating new charges against saved customer data.

### get_customer
Retrieves a specific customer's profile. Use this to see a customer's full billing history and active status.

## Prompt Examples

**Prompt:** 
```
Find the customer who paid from john@example.com and tell me if they have a saved card.
```

**Response:** 
```
I've located the customer profile for **john@example.com**.

*   **Name:** John Doe
*   **Status:** Active
*   **Vault Status:** Saved payment methods found.

They have one active card on file ending in **4432**.
```

**Prompt:** 
```
List all transactions from the last 24 hours that are still authorized but not captured.
```

**Response:** 
```
I found **2** pending authorizations from the last 24 hours:

| Transaction ID | Amount | Status |
| :--- | :--- | :--- |
| TX_8821 | $45.00 | AUTHORIZED |
| TX_8845 | $120.00 | AUTHORIZED |

Would you like me to capture either of these?
```

**Prompt:** 
```
I need to refund $50.00 for transaction TX_998877. Is it settled?
```

**Response:** 
```
I've checked transaction **TX_998877**. 

*   **Status:** SETTLED
*   **Amount:** $100.00

Since it's settled, I can proceed with the partial refund of **$50.00**. Should I go ahead?
```

## Capabilities

### Find transaction details
Pull up every detail for a specific payment to check its status or metadata.

### Process customer refunds
Issue full or partial refunds for settled transactions using natural language.

### Charge saved payment methods
Initiate new charges against your customer vault without manual entry.

### Search for customer profiles
Locate billing profiles and saved payment methods by searching your vault.

### Void authorized payments
Cancel authorized transactions before the funds are actually captured.

### Capture pending funds
Finalize authorized transactions to move money from pending to settled.

### List recent payments
Get a quick overview of your most recent gateway activity.

## Use Cases

### Refund Spike
A customer service rep needs to process 50 refunds in an hour. They ask the agent to refund specific transaction IDs one by one.

### Missing Payment
An angry customer claims they were charged. The manager asks the agent to find the transaction using the customer's email and check the status.

### Failed Authorization
A developer sees a pending payment and asks the agent to use capture_transaction to finalize the sale.

### Customer Audit
An accountant needs to see the billing profile for a specific user. They ask the agent to pull the data from the vault.

## Benefits

- Stop manual data entry by using search_customers to find billing profiles instantly instead of digging through a dashboard.
- Handle high-volume refund requests faster by telling your agent to use refund_transaction for specific IDs.
- Verify payment statuses in seconds by pulling metadata with get_transaction directly into your chat.
- Reduce errors in payment processing by using void_transaction to cancel authorized payments before they settle.
- Speed up checkout workflows by letting your agent use charge_payment_method against your customer vault.

## How It Works

The bottom line is you get a way to manage your Braintree payments using only natural language.

1. Subscribe to this Connector through the Vinkius catalog.
2. Enter your Braintree Public Key, Private Key, and choose your environment.
3. Start asking your AI client to search, charge, or refund payments.

## Frequently Asked Questions

**Can I use the Braintree MCP to process refunds for my customers?**
Yes, you can use the Connector to issue full or partial refunds for settled transactions directly through your AI agent.

**Does the Braintree MCP work with my production account?**
Yes, you can connect both your sandbox and production environments by providing the correct keys in your setup.

**Can my AI agent find customer profiles using only an email address?**
Yes, you can search your customer vault by email to retrieve billing profiles and saved payment methods.

**How does the Braintree MCP handle authorized payments that haven't been captured?**
You can use it to either capture the funds to finalize the sale or void the transaction if you need to cancel it.

**Can I see the full details of a specific payment using the Braintree MCP?**
Yes, you can pull up the complete metadata and status for any specific transaction ID using your agent.

**Is the Braintree MCP suitable for high-volume payment operations?**
It's designed for that. It lets you manage many transactions and customer lookups through natural language instead of manual dashboard clicks.

**Can I process a refund for a transaction using the agent?**
Yes! Use the `refund_transaction` tool with the Transaction Node ID. You can also specify a partial amount if you don't want to refund the full charge.

**How do I capture a previously authorized transaction?**
Simply ask the agent to `capture_transaction` and provide the Transaction Node ID. The funds will be captured and the status updated in your Braintree account.

**Does the integration allow searching for a customer by email?**
Yes. Use the `search_customers` tool and provide the exact email address. The agent will execute a GraphQL query to find the matching customer profile.