Braintree MCP. Manage the full lifecycle of payments, from charge to refund.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Braintree MCP Server. Manage global payments and customer accounts directly from any AI client. Search transactions, charge cards, void payments, and issue refunds without leaving your chat window.
Connect your Braintree gateway account to perform full payment lifecycle management using natural conversation.
What your AI agents can do
Capture transaction
Confirms and captures funds for an authorized transaction.
Charge payment method
Initiates a new charge against a customer's payment method.
Get customer
Retrieves the specific billing details for a known customer.
Search for customers by email and retrieve their full billing profile and saved payment methods.
Search for recent transactions or get the full details of a specific payment ID.
Initiate a charge against a saved payment method using the customer's account details.
Confirm and capture funds from a payment that was previously authorized but not yet settled.
Void a pending or authorized transaction, reversing the hold without processing a refund.
Issue a full or partial refund against a transaction that has already settled.
Search for groups of transactions or customers to manage them programmatically.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Braintree MCP Server: 8 Tools for Payment & Transaction Ops
Use these eight tools to execute specific actions—like charging, refunding, or searching—against your live Braintree payment gateway account.
019d7562capture transaction
Confirms and captures funds for an authorized transaction.
019d7562charge payment method
Initiates a new charge against a customer's payment method.
019d7562get customer
Retrieves the specific billing details for a known customer.
019d7562get transaction
Gets the complete details for a single, known transaction ID.
019d7562refund transaction
Sends a refund, optionally specifying a partial dollar amount, for a settled transaction.
019d7562search customers
Finds customer records within your vault by various criteria.
019d7562search transactions
Searches and lists multiple recent transactions to find what you need.
019d7562void transaction
Voids an authorized transaction, canceling the payment hold without refunding money.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Braintree, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Connect your Braintree gateway account to your AI client. You can manage global payments and customer accounts right from your chat window. You'll get full payment lifecycle management using natural conversation. You can use search_customers to find customer records by email, giving you their full billing profile and saved payment methods.
Need to check on a transaction? You can run search_transactions to list multiple recent payments or use get_transaction to grab the full details for a specific ID. To process a payment, you'll use charge_payment_method to initiate a charge against a saved method using the customer's details. If you've authorized funds but haven't captured them yet, run capture_transaction to confirm and grab the funds.
If you need to stop a payment, you can void_transaction, which cancels the payment hold without giving a refund. You can process a refund on a settled transaction using refund_transaction, specifying a partial dollar amount if you want. You can also use search_transactions and search_customers to handle groups of transactions or customers programmatically.
How Braintree MCP Works
- 1 Subscribe to the Braintree MCP Server and provide your Braintree Public Key, Private Key, and environment credentials.
- 2 Your AI client sends a request (e.g., 'Refund $50 for TX_123').
- 3 The agent executes the appropriate tool (e.g.,
refund_transaction), sending the necessary IDs and amounts to Braintree.
The bottom line is, your AI client runs the payment commands against your live Braintree account, reporting the final status back to you.
Who Is Braintree MCP For?
This is for e-commerce operations teams, finance controllers, and billing managers. If your job involves reconciling sales, handling customer disputes, or managing refunds after hours, this tool saves you from jumping between the dashboard, CSV exports, and internal ticketing system. It puts complex payment logic directly into your chat workflow.
Uses the agent to process batch refunds for canceled orders or to check the status of multiple transactions for inventory reconciliation.
Retrieves customer profiles and saved payment methods to troubleshoot billing issues or manually initiate a payment charge.
Searches transaction history (search_transactions) to audit revenue streams or to confirm the status of large, complex payouts.
What Changes When You Connect
- Handle complex reversals instantly. Instead of navigating refund portals, you can tell your agent to run
refund_transactionfor a partial or full amount, logging the status right away. - Reconcile sales history faster. Use
search_transactionsto pull lists of transactions across date ranges or amounts, giving you a quick audit trail without exporting CSVs. - Troubleshoot billing issues on the fly. You can use
get_customerto look up a customer by email and see their saved payment methods and profile details immediately. - Manage holds and charges. If a payment was authorized but failed to settle, you can run
capture_transactionto finalize the money, orvoid_transactionif it needs to be canceled. - Streamline new sales flows. When a customer is ready to buy, your agent can use
charge_payment_methodto process the payment immediately, minimizing steps for the user.
Real-World Use Cases
Customer needs to dispute a charge.
A customer emails support, saying they were overcharged. The support agent asks their agent to run search_transactions for the customer's email. The agent finds the transaction ID, then uses get_transaction to confirm the exact amount and date, finally running refund_transaction to process the partial refund.
Need to process end-of-day reconciliation.
The ops engineer needs to confirm all authorized payments were captured. They ask their agent to run search_transactions for today's date. The agent lists all transactions with 'AUTHORIZED' status, and the engineer instructs the agent to run capture_transaction on the list of IDs.
A payment failed and needs to be reversed.
The billing team detects a payment attempt that needs to be completely canceled. They ask the agent to run void_transaction using the specific transaction ID. The agent confirms the void status, preventing any accidental charges or confusion.
Onboarding a new client with saved payment details.
The sales rep uses their agent to run search_customers by the prospect's email. They retrieve the profile details and then use charge_payment_method to save and charge the card on file for the first service payment.
The Tradeoffs
Jumping between APIs for status checks
Manually checking the Braintree dashboard, then copying the ID, then going to the GraphQL playground to check the status. This is slow and error-prone.
→
Let your agent run get_transaction directly. Give it the ID, and it returns all the status metadata in one call, keeping the process in your chat window.
Assuming a void means no charge
A user tries to cancel a payment by simply requesting a 'cancellation' via a generic chat prompt. The agent needs specific tools to know the actual payment lifecycle status.
→
Always use void_transaction when canceling an authorized payment. If the payment already settled, you must use refund_transaction.
Over-relying on customer email alone
Searching for a customer using only an email address and failing because the customer's profile details are missing or outdated in the vault.
→
First, try search_customers to confirm the customer ID exists. If that fails, ensure you have the most recent customer data before attempting to run charge_payment_method.
When It Fits, When It Doesn't
Use this Braintree server if your core workflow requires guaranteed financial accuracy and auditability. You need to execute specific, stateful commands: charging, voiding, refunding, or verifying payment status.
Don't use this if you just need to read general marketing data or browse product features. If your goal is simply to list all transactions without specific filtering, search_transactions handles that. But if you need to act on those transactions (i.e., capture, void, or refund), you need the full suite of tools. This server gives you the granular control required for compliance-heavy, production-grade finance operations.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Braintree. 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.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 8 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Tracking down a payment dispute usually involves a dozen clicks.
Today, if a customer calls about a disputed charge, you're stuck. You have to look up their email in the CRM, then open the payments dashboard, search by date range, find the transaction ID, copy that ID, open the billing system, and manually confirm the status. It takes minutes, and you'll probably lose the thread by the time you're done.
With the Braintree MCP Server, your agent handles the entire sequence. You just tell it, 'Find the transaction for John Doe from last Tuesday.' The agent runs `search_transactions`, finds the ID, uses `get_transaction` to confirm the status, and reports the whole thing back to you in two steps.
Braintree MCP Server: Process payments and manage accounts
Manual payment handling means juggling void requests, partial refunds, and captures across multiple internal tools. You risk sending a void command to a settled transaction, or vice versa, which fails the whole process.
This server makes that impossible. You tell your agent the required action—for example, 'Refund $20 for TX_123'—and the agent executes the precise `refund_transaction` tool, handling all the necessary prerequisites and returning a definitive status.
Common Questions About Braintree MCP
How do I find a customer's payment details using the Braintree MCP Server? +
You use the search_customers tool. You provide the customer's email or other identifying details, and the tool returns their full billing profile and saved payment methods available for use.
What's the difference between `void_transaction` and `refund_transaction`? +
Voiding cancels a pending hold; it doesn't move money. A refund only works on money that has already settled. You must use void_transaction for pre-settlement holds, and refund_transaction for settled funds.
Can I check the status of a payment using the Braintree MCP Server? +
Yes, use the get_transaction tool. Provide the transaction ID, and the agent returns all the current metadata, including the status (e.g., AUTHORIZED, SETTLED).
What if I need to process multiple payments at once? +
Start with search_transactions. This tool lets you list multiple recent transactions, giving you a list of IDs you can then pass to capture_transaction or void_transaction.
How do I use the `charge_payment_method` tool to ensure secure payment capture? +
The charge_payment_method tool handles the initial charging process. You must provide valid Braintree credentials and the payment details to ensure the transaction is secure and properly recorded.
What data does `search_transactions` provide when I look for recent payments? +
search_transactions returns a list of recent transactions, including key metadata like transaction ID, amount, and current status (e.g., SETTLED, AUTHORIZED). This allows you to see the full payment history at a glance.
Do I need to call `get_customer` before I can use `capture_transaction`? +
No, you don't. While get_customer helps you find a profile, capture_transaction only requires the specific transaction ID that was previously authorized. It acts directly on the transaction record.
How do I handle errors or failed payments using the Braintree MCP Server? +
When a payment fails, the API returns a specific error code and message. Your AI agent processes this response, allowing you to immediately identify the failure reason and attempt a corrective action.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Adyen
Global payment processing — manage payments, refunds, and merchant accounts via AI.
Mercado Pago
Process payments, generate Pix QR codes, manage customers and refunds via Mercado Pago API.
Stripe
Manage payments, customers, subscriptions, invoices, and account balance via Stripe — all from any AI agent.
You might also like
OpenEI
US electricity rate intelligence — query utility rates by location, sector, and tariff via AI for solar and energy analysis.
Cloverly
Offset carbon emissions at the point of transaction by purchasing verified carbon credits for shipments, rides, and purchases.
Tencent TMT / 腾讯机器翻译
Tencent's professional machine translation — translate text and detect languages with high precision via AI.