# Braintree MCP for AI Agents MCP

> Braintree connects your Braintree payment gateway account to any AI client. You can search recent transactions and retrieve detailed metadata for specific payments. Use this MCP to charge new methods, capture authorized funds, void pending charges, or issue full/partial refunds directly from conversation.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Tags:** global-payments, transaction-management, checkout-experience, refund-processing, payment-gateway, financial-api

## Description

Manage your global checkout flows without ever logging into a dashboard. This connection lets your agent talk to Braintree, giving you control over every stage of the payment lifecycle using natural language. You can search for customer profiles by email and get their billing details instantly. Need to fix an error? Your agent handles it: find transactions, void pending authorizations, or issue a refund—all in one conversation.

When multiple systems are involved, you don't have to juggle them. Vinkius hosts this Braintree MCP alongside thousands of others, so your AI client has everything it needs for comprehensive financial operations. It’s about getting the payment details and customer data flowing directly into your workflow when you need it most.

## Tools

### capture_transaction
Finalizes an authorized payment by capturing the funds from the customer's method.

### charge_payment_method
Charges a specific payment card or method for immediate use.

### get_customer
Fetches detailed information about an existing customer, including their saved billing details.

### get_transaction
Retrieves all metadata and status details for a single, specific transaction.

### refund_transaction
Sends money back to the customer for any previously settled charge, optionally specifying how much to refund.

### search_customers
Finds multiple customers within your vault using general search criteria like name or email.

### search_transactions
Searches through a range of recent payments to locate specific activity by date or amount.

### void_transaction
Cancels an authorized transaction that hasn't settled yet, releasing the hold on funds.

## Prompt Examples

**Prompt:** 
```
I need to process a refund of $15 from transaction ID T9083B.
```

**Response:** 
```
**Refund Confirmation**

The refund for transaction `T9083B` has been successfully initiated.

*   **Amount:** $15.00
*   **Status:** SUBMITTED_FOR_SETTLEMENT
*   **Reference ID:** REF-7742A
*   **Expected Settlement:** 2-3 business days.

Please note: This refund will reflect on the customer's statement within standard banking timeframes.
```

**Prompt:** 
```
Show me all transactions over $50 from last week.
```

**Response:** 
```
**Recent High-Value Transactions**

| Date | Transaction ID | Amount | Status |
| :--- | :--- | :--- | :--- |
| 2024-06-10 | TX_A3B9 | $58.99 | SETTLED |
| 2024-06-11 | TX_C1D2 | $120.00 | AUTHORIZED |

*Action needed:* The transaction on 6/11 is currently authorized; do you want me to capture those funds now?
```

**Prompt:** 
```
What's the billing profile for jane@corp.com?
```

**Response:** 
```
**Customer Profile Found**

*   **Name:** Jane Smith
*   **Vault ID:** 554321
*   **Status:** Active
*   **Last Payment Method:** Visa ending in 4321 (Valid until 10/26)

The profile is active and ready for new charges.
```

## Capabilities

### Search and List Transactions
Retrieves a list of recent payments or fetches detailed records for any specific transaction ID.

### Look Up Customer Profiles
Searches your customer vault by email address to retrieve saved billing information and payment methods.

### Initiate Charges
Charges a specified payment method, handling everything from initial authorization to final capture of funds.

### Refund Payments
Processes refunds for settled transactions, allowing you to specify whether the refund should be partial or full.

### Void Transactions
Cancels pending authorizations before they settle, returning funds back to your available balance.

## Use Cases

### A customer claims they were double-charged for a subscription renewal.
The agent searches transactions by date and finds two charges. Using `get_transaction` on the duplicate ID, the agent then immediately uses `refund_transaction` to issue the refund, confirming the action in minutes.

### Your team needs to process a large batch of refunds after a system outage.
Instead of manually logging into the payment portal for dozens of IDs, the agent uses `search_transactions` to build a list and then executes multiple `refund_transaction` calls, providing an audit log instantly.

### A new client signs up but needs us to charge them immediately.
The agent first runs `search_customers` by the provided email. It retrieves the profile and then uses `charge_payment_method` to process the initial payment, validating their details upfront.

### A sale was authorized but canceled before fulfillment.
The agent locates the specific transaction via `get_transaction`. Knowing it's pending, it uses `void_transaction` to release the hold on funds, ensuring the customer isn't charged later.

## Benefits

- Stop jumping between dashboards. You can find transaction details or void pending payments instantly, all through a single chat conversation.
- Handle complex refunds with precision. The ability to issue partial refunds for specific transactions means you never over-refund money again.
- Keep customer data fresh and secure. Use the MCP's search functions to pull billing profiles by email without needing access credentials.
- Control the full payment lifecycle: from charging a new method to capturing funds, your agent manages it all in sequence.
- Audit quickly. If you need to verify if a specific transaction happened last week, use the search tools instead of manually filtering reports.

## How It Works

The bottom line is that it turns complex financial API calls into simple conversation prompts for your agent.

1. Subscribe to this MCP and provide your Braintree credentials (Public Key, Private Key, and Environment).
2. Your agent receives the necessary connection details and can now communicate directly with the payment gateway.
3. You simply tell your AI client what you need—for example, 'Find John Doe's profile and charge $50 to his card.'—and the MCP handles the rest.

## Frequently Asked Questions

**How does the Braintree MCP help me with recurring payments?**
It helps by allowing you to retrieve stored customer billing profiles using their email. This means your agent can initiate a charge for renewals without needing new card details every month.

**Can I use Braintree MCP to check if an authorization went through?**
Yes, the MCP lets you fetch detailed transaction metadata. You'll see the current status (e.g., AUTHORIZED or SETTLED) and know exactly what action is needed next.

**Does Braintree MCP handle refunds for failed payments?**
This MCP handles refunds for *settled* payments, meaning those funds already left the customer. If a payment fails entirely, you'll need to address the root cause on your end.

**How do I start using Braintree MCP with my existing tools?**
You connect by subscribing to the MCP and providing your three core credentials (Public Key, Private Key, and Environment). Once connected through Vinkius, your agent can access all payment functions.