Braintree MCP Server

🚀 Braintree MCP Server

An unofficial Model Context Protocol (MCP) server for interacting with the PayPal Braintree payment processing service via a GraphQL API.

🚀 Quick Start

This server implements the Model Context Protocol (MCP) specification, enabling AI assistant models to directly access Braintree's payment processing capabilities. It allows AI systems to perform operations such as retrieving transactions, creating payments, and managing customer data.

✨ Features

• Enables AI models to interact with Braintree payment processing services.
• Supports a variety of MCP tools for different operations.
• Allows for custom GraphQL queries to the Braintree API.

📦 Installation

Prerequisites

• Python 3.13+
• Braintree merchant account credentials

Steps

1. Clone this repository:

git clone https://github.com/yourusername/braintree-mcp-server.git
cd braintree-mcp-server

2. Set up a Python 3.13+ environment:

# If using pyenv
pyenv install 3.13.0
pyenv local 3.13.0

# Or use other methods to ensure Python 3.13+ is used

3. Install dependencies:

pip install -e .

📚 Documentation

Configuration

Create a .env file in the project root directory with your Braintree credentials:

BRAINTREE_MERCHANT_ID=your_merchant_id
BRAINTREE_PUBLIC_KEY=your_public_key
BRAINTREE_PRIVATE_KEY=your_private_key
BRAINTREE_ENVIRONMENT=sandbox  # or production

You can obtain these credentials from the Braintree control panel.

Usage

Run the server

python braintree_server.py

The server runs with stdio transport by default, suitable for integration with MCP-compatible AI assistant systems.

Available MCP Tools

braintree_pong

A simple connectivity test to check if the Braintree credentials are working.

response = await braintree_pong()
# Returns "pong" on success

braintree_execute_graphql

Execute an arbitrary GraphQL query against the Braintree API.

query = """
query GetTransactionDetails($id: ID!) {
  node(id: $id) {
    ... on Transaction {
      id
      status
      amount {
        value
        currencyCode
      }
      createdAt
    }
  }
}
"""

variables = {"id": "transaction_id_here"}

response = await braintree_execute_graphql(query, variables)
# Returns Braintree's JSON response

Common GraphQL Operations

Get Customer Information

query GetCustomer($id: ID!) {
  node(id: $id) {
    ... on Customer {
      id
      firstName
      lastName
      email
      paymentMethods {
        edges {
          node {
            id
            details {
              ... on CreditCardDetails {
                last4
                expirationMonth
                expirationYear
                cardType
              }
            }
          }
        }
      }
    }
  }
}

Create a Transaction

mutation CreateTransaction($input: ChargePaymentMethodInput!) {
  chargePaymentMethod(input: $input) {
    transaction {
      id
      status
      amount {
        value
        currencyCode
      }
    }
  }
}

With variables:

{
  "input": {
    "paymentMethodId": "payment_method_id_here",
    "transaction": {
      "amount": "10.00",
      "orderId": "order123",
      "options": {
        "submitForSettlement": true
      }
    }
  }
}

🔧 Troubleshooting

• Ensure that the Braintree credentials in the .env file are correct.
• Verify that the network connection can access the Braintree API endpoints.
• Check for any rate limits or permission issues related to your Braintree account.

📄 License

⚠️ Important Note

This is an unofficial integration and does not have authorization to use PayPal or Braintree's services.