io.github.codespar/mcp-braintree — Model Context Protocol (MCP) Server

MCP server for Braintree (PayPal) that provides global card processing through the Braintree GraphQL API. It is intended for agent-driven payments, including charge and refund flows, plus vaulting and customer management. Tool coverage includes transaction authorization and atomic charge operations via GraphQL.

🛠️ Key Features

Braintree GraphQL API integration
Global card processing capabilities
Transaction authorization without capture (“authorize”)
Atomic authorization + capture (“charge”)
Vaulting and customer management (as stated in description)
Supports multiple tools (22)

🚀 Use Cases

LatAm SaaS selling to US/EU buyers
Payments where users already have a Braintree merchant account
Agent-driven payment operations: charge, refund, vault, customer management

⚡ Developer Benefits

Exposes Braintree payment actions as MCP tools
Uses GraphQL operations for authorizing transactions
Provides an explicit “authorizePaymentMethod” path for authorization

⚠️ Limitations

Described tools/actions are focused on GraphQL-based card processing; broader payment methods are not detailed in the provided excerpt.

Tools (22)

Tool

Purpose

authorize_transaction

Authorize a transaction (reserve funds without capturing) via Braintree GraphQL authorizePaymentMethod.

charge_transaction

Authorize and capture a transaction atomically via Braintree GraphQL chargePaymentMethod.

capture_transaction

Capture a previously authorized transaction via captureTransaction.

refund_transaction

Refund a settled transaction via refundTransaction.

void_transaction

Void an unsettled transaction (reverse the authorization) via reverseTransaction.

vault_payment_method

Permanently store a tokenized payment method in the Braintree vault via vaultPaymentMethod.

delete_payment_method

Delete a vaulted payment method via deletePaymentMethodFromVault.

create_customer

Create a Braintree customer via createCustomer.

update_customer

Update an existing Braintree customer via updateCustomer.

get_transaction

Fetch a transaction by id via the GraphQL search.transactions query.

get_customer

Fetch a customer by id via the GraphQL node(id:) query.

submit_for_settlement

Submit a previously authorized transaction for settlement via submitTransactionForSettlement.

update_payment_method

Update metadata on a vaulted payment method via updatePaymentMethod.

verify_payment_method

Run a credit-card verification (zero-auth or $1 auth) on a tokenized payment method via verifyPaymentMethod.

delete_customer

Delete a Braintree customer via deleteCustomer.

find_customer

Search for customers via the GraphQL search.customers query.

search_transactions

Search transactions via the GraphQL search.transactions query.

find_dispute

Fetch a dispute by id via the GraphQL node(id:) query.

accept_dispute

Accept liability for a dispute via acceptDispute — the merchant concedes and the disputed amount is refunde...

finalize_dispute

Finalize a dispute via finalizeDispute — submits previously added evidence to the card network for review.

find_merchant_account

Fetch a merchant account by id via the GraphQL node(id:) query.

create_client_token

Mint a Braintree client token via createClientToken for client-side tokenization (Drop-in, Hosted Fields, m...

Environment

bash

BRAINTREE_MERCHANT_ID="..."   # merchant id
BRAINTREE_PUBLIC_KEY="..."    # public API key (Basic auth user)
BRAINTREE_PRIVATE_KEY="..."   # private API key (Basic auth password, secret)
BRAINTREE_ENV="sandbox"       # 'sandbox' (default) or 'production'
BRAINTREE_API_VERSION="2019-01-01"  # optional, Braintree-Version header

Endpoints:

sandbox → https://payments.sandbox.braintree-api.com/graphql

production → https://payments.braintree-api.com/graphql

Notes

Amount is a string in Braintree GraphQL (e.g. "10.50"), not a number. The server forwards whatever shape the agent passes; strings are the safe default.

Braintree's GraphQL schema evolves; some input fields not exposed in the MCP inputSchema can still be passed in additional / nested objects and will be forwarded.

Install

Configuration

Environment variables

BRAINTREE_MERCHANT_IDrequired

Braintree merchant id (from the Control Panel > API).

BRAINTREE_PUBLIC_KEYrequired

Braintree public API key — Basic auth username.

BRAINTREE_PRIVATE_KEYrequiredsecret

Braintree private API key — Basic auth password (secret).

BRAINTREE_ENV

Braintree environment. 'sandbox' (default, https://payments.sandbox.braintree-api.com/graphql) or 'production' (https://payments.braintree-api.com/graphql).

BRAINTREE_API_VERSION

Braintree-Version header value (YYYY-MM-DD). Defaults to 2019-01-01.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-braintree": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-braintree@0.2.2"
      ],
      "env": {
        "BRAINTREE_MERCHANT_ID": "<YOUR_BRAINTREE_MERCHANT_ID>",
        "BRAINTREE_PUBLIC_KEY": "<YOUR_BRAINTREE_PUBLIC_KEY>",
        "BRAINTREE_PRIVATE_KEY": "<YOUR_BRAINTREE_PRIVATE_KEY>",
        "BRAINTREE_ENV": "<YOUR_BRAINTREE_ENV>",
        "BRAINTREE_API_VERSION": "<YOUR_BRAINTREE_API_VERSION>"
      }
    }
  }
}

io.github.codespar/mcp-braintree