Braintree MCP server
MCP server for Braintree (PayPal) — global card processing via GraphQL: charge, refund, vault
271 stars29 downloads/wk
Reviews
Write oneNobody has reviewed Braintree yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Braintree tools (22, 10 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
accept_disputeAccept liability for a dispute via acceptDispute — the merchant concedes and the disputed amount is refunded to the buyer. Terminal action, cannot be undone.
authorize_transactionAuthorize a transaction (reserve funds without capturing) via Braintree GraphQL authorizePaymentMethod. Pass a paymentMethodId obtained from client-side tokenization (Drop-in / Hosted Fields / SDK nonce). Capture later with capture_transaction.
capture_transactionCapture a previously authorized transaction via captureTransaction. Amount defaults to full authorized amount when omitted (partial captures allowed up to the authorized total).
charge_transactionwrite actionAuthorize and capture a transaction atomically via Braintree GraphQL chargePaymentMethod. Use for one-step sales. For auth-now-capture-later split, use authorize_transaction + capture_transaction.
create_client_tokenwrite actionMint a Braintree client token via createClientToken for client-side tokenization (Drop-in, Hosted Fields, mobile SDKs). Pass a customerId to scope the token to a customer for vault-aware flows.
create_customerwrite actionCreate a Braintree customer via createCustomer. Customers group multiple vaulted payment methods and transactions under one identity.
delete_customerwrite actionDelete a Braintree customer via deleteCustomer. Irreversible — also deletes any payment methods vaulted against the customer.
delete_payment_methodwrite actionDelete a vaulted payment method via deletePaymentMethodFromVault. Irreversible — the token cannot be used for future charges after deletion.
finalize_disputeFinalize a dispute via finalizeDispute — submits previously added evidence to the card network for review. After finalization, no further evidence can be added.
find_customerSearch for customers via the GraphQL search.customers query. Pass one of email / firstName / lastName / company to filter; returns matching customer nodes. Leave all blank to list the first page of customers.
find_disputeFetch a dispute by id via the GraphQL node(id:) query. Returns id, status, reason, amountDisputed, receivedDate, replyByDate.
find_merchant_accountFetch a merchant account by id via the GraphQL node(id:) query. Returns id, status, currencyCode, and default flag — useful for multi-currency / multi-entity merchants.
get_customerFetch a customer by id via the GraphQL node(id:) query. Returns customer scalars (id, firstName, lastName, email, company, phone).
get_transactionFetch a transaction by id via the GraphQL search.transactions query. Returns id, status, amount, orderId, createdAt, and the associated payment method.
refund_transactionwrite actionRefund a settled transaction via refundTransaction. Amount defaults to the full settled amount when omitted. For partial refunds, pass a smaller amount.
search_transactionsSearch transactions via the GraphQL search.transactions query. Filter by status / customerId / orderId / createdAt range. Returns a page of transaction nodes with id, status, amount, orderId, createdAt.
submit_for_settlementwrite actionSubmit a previously authorized transaction for settlement via submitTransactionForSettlement. Unlike capture_transaction (captureTransaction), this marks the transaction for the next settlement batch and supports optional order id / descriptor overrides.
update_customerwrite actionUpdate an existing Braintree customer via updateCustomer. Only fields present in the request are updated.
update_payment_methodwrite actionUpdate metadata on a vaulted payment method via updatePaymentMethod. Use to change billing address, cardholder name, expiration, or set-as-default flag without re-tokenizing.
vault_payment_methodPermanently store a tokenized payment method in the Braintree vault via vaultPaymentMethod. The input paymentMethodId must be a single-use nonce; the mutation returns a permanent vaulted payment method id that can be reused for future charges.
verify_payment_methodwrite actionRun a credit-card verification (zero-auth or $1 auth) on a tokenized payment method via verifyPaymentMethod. Returns a CreditCardVerification with status and processor response. Useful before vaulting or charging.
void_transactionVoid an unsettled transaction (reverse the authorization) via reverseTransaction. Use when funds are authorized but not yet captured — for captured/settled transactions use refund_transaction instead.
Public scan report
scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it
- Code scan5 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 29 days ago15/15
- Maintainer identityregistry namespace matches repository owner7/10
How Braintree compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 82/100
- higher than 63% of 48,255 servers
- Tools
- 22
- the typical server has 7
- Tools that change things
- 45%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 271
- more than 95% of 28,688 servers
- Downloads a week
- 29
- more than 16% of 12,191 servers with a package
What its tools let an agent do: 12 read · 2 create · 6 change · 2 delete
Install Braintree in Claude Code, Cursor or VS Code
Runs npx -y @codespar/mcp-braintree on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add mcp-braintree -- npx -y @codespar/mcp-braintree
What the publisher says
From the Braintree repository's README, as published. We do not edit it. Read it on GitHub
MCP Dev LATAM 🌎 Every commerce API your AI agent needs to run a business in Latin America. Brazil 🇧🇷 · Mexico 🇲🇽 · Argentina 🇦🇷 · Colombia 🇨🇴 · Chile 🇨🇱 · Peru 🇵🇪 · plus 4 agentic payment protocols. MCP servers for LATAM commerce · live in the official MCP Registry · MIT License Machine-readable catalog: codespar.dev/api/servers Catalog · Quick Start · Agentic Protocols · All Servers · Contribute
The Problem
AI agents can write code, analyze data, and chat. But they can't operate a business — collect payments, issue invoices, ship products, or notify customers. Especially not in Latin America, where every service has its own API, auth pattern, and quirks (mTLS for BACEN Pix v2, JWT-RSA for STP-SPEI, AFIP web services, contract-gated developer portals, and on).
Meanwhile, four agentic payment protocols are shipping in parallel — checkout protocols (Stripe ACP, Google UCP), authorization layers (AP2), and micropayment rails (x402) — and none of them compose cleanly with each other or with the regional rails businesses actually run on.
MCP Dev LATAM bridges both gaps. Traditional LATAM services + the new agentic payment protocols, all accessible through a single MCP interface.
The Solution
Each MCP server in this repo wraps a real provider — payments, fiscal, logistics, messaging, banking, ERP, identity, fraud, crypto, and the agentic protocols — so your agent can operate a complete business workflow.
🛒 Customer places order
→ 💳 Agent charges via Pix (Asaas / Mercado Pago / Zoop)
→ 📄 Agent issues NFe (Nuvem Fiscal / Focus NFe / NFe.io)
→ 📦 Agent generates shipping label (Melhor Envio / Skydropx)
→ 📱 Agent sends tracking via WhatsApp (Z-API / WhatsApp Cloud)
→ 📊 Agent records in ERP (Omie / Bling / Tiny)
→ 🏦 Agent reconciles balance (Stark Bank / Itaú / BTG)Six systems. Zero human intervention. One agent.
Agentic Payment Protocols
Four servers for the emerging agentic payment stack:
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Braintree: common questions
- Is Braintree MCP server safe?
- Mostly: it is graded B (82/100). Read the Braintree safety report
- How do I install Braintree?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Braintree need an API key?
- Yes. The registry entry asks for
BRAINTREE_PRIVATE_KEY. - Is Braintree maintained?
- The last commit was 67 days ago (2026-08-29). The latest release is v0.2.2.
- How does Braintree compare with other MCP servers?
- safety score 82/100 (higher than 63% of 48,255 servers); tools 22 (the typical server has 7); tools that change things 45% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.