Braintree MCP server

Connect Braintree to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Braintree MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the create subscription tool in Braintree
  • Use the find subscription tool in Braintree
  • Use the delete payment method tool in Braintree
  • Use the find dispute tool in Braintree
  • Use the refund transaction tool in Braintree
  • Use the void transaction tool in Braintree

Supported Tools

create_subscription

Create Subscription

Creates a new recurring billing subscription in Braintree. Requires a plan ID (configured in the Control Panel) and a payment method token.

find_subscription

Find Subscription

Retrieves details of a Braintree subscription by its ID, including status, billing info, and payment method.

delete_payment_method

Delete Payment Method

Removes a payment method from the Braintree vault. This is irreversible and will fail if the payment method has active subscriptions.

find_dispute

Find Dispute

Retrieves details of a specific Braintree dispute by its ID, including status, reason, amount, and deadline information.

refund_transaction

Refund Transaction

Refunds or reverses a Braintree transaction. For settled transactions, issues a refund (full or partial). For unsettled transactions, can void/reverse the transaction instead. Use "refund" for settled transactions and "reverse" to automatically void or refund based on status.

void_transaction

Void Transaction

Voids a Braintree transaction that has not yet settled. Once a transaction is voided, the authorization hold on the customer's payment method is released. Only transactions with status "authorized", "submitted_for_settlement", or "settlement_pending" can be voided.

settle_transaction

Submit for Settlement

Submits an authorized Braintree transaction for settlement, optionally adjusting the amount. This captures the funds from a previously authorized transaction. Supports both full and partial settlement.

find_payment_method

Find Payment Method

Retrieves details of a vaulted payment method by its token from the Braintree vault.

find_customer

Find Customer

Retrieves a Braintree customer by ID, including their stored payment methods and associated information.

search_transactions

Search Transactions

Searches for transactions in Braintree using various filter criteria. Returns a paginated list of matching transactions. Supports filtering by status, amount range, date range, customer, and payment method type.

cancel_subscription

Cancel Subscription

Cancels a Braintree subscription. The subscription will stop recurring billing immediately. This action is irreversible.

create_transaction

Create Transaction

Creates a payment transaction in Braintree. Supports both sale (immediate capture) and authorization-only flows. Use this to charge a payment method or authorize an amount for later capture. Requires a payment method ID (from the Braintree vault or a single-use nonce) and an amount.

find_transaction

Find Transaction

Retrieves details of a specific Braintree transaction by its ID. Returns full transaction information including status, amount, payment method, customer, and settlement details.

create_customer

Create Customer

Creates a new customer record in the Braintree vault. Customers can store multiple payment methods and have associated transactions.

finalize_dispute

Finalize Dispute

Finalizes a Braintree dispute submission, sending all added evidence to the payment processor. After finalization, no more evidence can be added.

vault_payment_method

Vault Payment Method

Stores a payment method in the Braintree vault for future use. Takes a single-use payment method ID (nonce) and converts it to a reusable vaulted payment method. By default, credit cards are verified before vaulting.

add_dispute_evidence

Add Dispute Evidence

Adds text evidence to a Braintree dispute for contestation. Use this to provide supporting information when fighting a chargeback.

update_customer

Update Customer

Updates an existing Braintree customer's information. Only the provided fields will be updated; other fields remain unchanged.

accept_dispute

Accept Dispute

Accepts a Braintree dispute, acknowledging the chargeback. Only disputes with status "open" can be accepted. This action is irreversible.

update_subscription

Update Subscription

Updates an existing Braintree subscription. Can change payment method, price, billing cycles, and other settings.

settlement_report

Settlement Batch Summary

Generates a settlement batch summary report for a given date. Returns aggregated totals for transactions settled on the specified date, optionally grouped by a custom field.

delete_customer

Delete Customer

Deletes a Braintree customer and all their associated payment methods. All recurring billing subscriptions will be canceled. This action is irreversible.

search_disputes

Search Disputes

Searches Braintree disputes by ID, status, type, reason, transaction, customer, or deadline dates. Use this to discover open disputes before adding evidence, accepting, or finalizing.

search_subscriptions

Search Subscriptions

Searches Braintree recurring billing subscriptions by ID, plan, status, merchant account, transaction, trial state, and billing dates. Use this before finding, updating, retrying, or canceling subscriptions.

search_customers

Search Customers

Searches Braintree customers by ID, email, name, company, phone, or created date. Use this before finding, updating, or deleting a customer when only partial customer details are known.

create_client_token

Create Client Token

Generates a Braintree client token for initializing client-side Braintree SDKs. Use this when an app needs to tokenize payment methods before vaulting or charging them server-side.

Connect Braintree to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Braintree in Metorial. In your Metorial portal, enable the Braintree MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Braintree tools.

Run Braintree through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Braintree and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Braintree tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Braintree

Mailchimp

Manage email marketing audiences, campaigns, and automations. Create, send, schedule, and track email campaigns with detailed reporting on opens, clicks, and bounces. Add, update, and organize audience contacts with tags, segments, and interest groups. Set up and manage automation workflows triggered by subscriber activity or events. Connect e-commerce stores to manage customers, products, orders, and carts. Create and manage reusable email templates and landing pages. Upload and organize files for use in campaigns. Send transactional emails via the Mandrill API. Post custom events to trigger targeted automations. Configure webhooks to track subscribe, unsubscribe, profile updates, and email delivery events.

Zoho

Manage Zoho CRM, Bigin, Books, Inventory, Invoice, Desk, Mail, People, and Projects from one connection. Discover organizations and accounts, manage records and financial documents, work with support tickets and email, and organize employee and project data.

Quickbooks

Manage business finances and accounting in QuickBooks Online. Create, send, and track invoices. Manage bills and accounts payable, record bill payments. Create and update customer and vendor records with contact details and hierarchies. Record payments against invoices and credit memos. Create estimates, sales receipts, and journal entries. Track expenses and categorize against the chart of accounts. Manage items, products, services, and inventory levels. Query entities using SQL-like syntax and sync incremental changes via Change Data Capture. Generate financial reports including profit and loss, balance sheet, and cash flow. Process credit card and bank account (ACH) payments via the Payments API. Manage the chart of accounts for tracking income, expenses, assets, and liabilities.

Square

Process payments, manage orders, and handle invoices for online, in-app, and in-person commerce. Create and manage customer profiles, catalog items, inventory counts, and locations. Issue refunds, manage disputes, and track payouts. Create bookings and appointments, manage team members and timecards, handle gift cards and loyalty programs, and manage subscriptions. Save cards on file, generate checkout links, connect and control Square Terminal devices, and manage vendor/supplier information. Extend Square objects with custom attributes. Receive webhook notifications for payments, orders, customers, inventory, invoices, bookings, disputes, team changes, and more.

Freeagent

Manage FreeAgent contacts, invoices, estimates, supplier bills, expenses, projects, tasks, and timeslips. Browse bank accounts and transactions, identify the connected user, download invoice PDFs, and retrieve financial reports.

Gumroad

Manage digital and physical product sales on Gumroad. View and update product metadata, create and manage variant categories and options, and configure discount offer codes. Retrieve and filter sales data by date range for reporting. Manage subscribers and subscription lifecycles for recurring products. Refund sales, revoke or restore buyer access, and track payouts. Verify, enable, disable, and decrement license keys for purchase validation. Draft, schedule, and send audience emails to customers and followers. Read product reviews and access authenticated user profile information.

Technical notes for Braintree

Process payments and manage transactions across credit/debit cards, PayPal, Venmo, Apple Pay, Google Pay, and ACH Direct Debit. Create, void, refund, and search transactions. Store customer payment methods securely in the Vault for repeat billing. Manage recurring subscriptions with add-ons and discounts. Handle disputes by adding evidence, accepting, or finalizing. Create and manage customers, addresses, and sub-merchant accounts. Run credit card verifications, generate settlement batch summaries, and forward payment data to third parties. Receive webhook notifications for subscription lifecycle changes, transaction settlements, disbursements, dispute updates, account updater card refreshes, and fraud protection alerts.

Frequently asked questions

Common questions about connecting Braintree to AI agents with Metorial.

  1. How many tools does the Braintree MCP server have?
    The Braintree MCP server exposes 26 tools, including Create Subscription, Find Subscription, Delete Payment Method. Each one is governed and traced through Metorial.
  2. Braintree exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Braintree MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Braintree and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Braintree MCP server yourself or use the hosted gateway.

Connect Braintree to production AI agents

See how Metorial gives your team governed access to Braintree, with tracing and security controls built in.