Braintree MCP Server

1# Braintree MCP Server
2 
3An unofficial Model Context Protocol (MCP) server for interacting with PayPal Braintree payment processing services.
4 
5## License and Citation
6 
7This project is available under the MIT License with an Academic Citation Requirement. This means you can freely use, modify, and distribute the code, but any academic or scientific publication that uses this software must provide appropriate attribution.
8 
9### For academic/research use:
10If you use this software in a research project that leads to a publication, presentation, or report, you **must** cite this work according to the format provided in [CITATION.md](CITATION.md).
11 
12### For commercial/non-academic use:
13Commercial and non-academic use follows the standard MIT License terms without the citation requirement.
14 
15By using this software, you agree to these terms. See [LICENSE.md](LICENSE.md) for the complete license text.
16 
17## Server Versions
18 
19There are two versions of the Braintree MCP server available:
20 
21### 1. STDIO Transport Server (`braintree_server.py`)
22 
23- Uses standard input/output (STDIO) for communication
24- Designed for integrations with Claude Desktop and other MCP clients that support STDIO
25- Each client session spawns a new server process
26- The server terminates when the client disconnects
27 
28**Usage with Claude Desktop:**
291. Configure `claude_desktop_config.json` to point to this server
302. Open Claude Desktop and select the Braintree tool
31 
32### 2. SSE Transport Server (`braintree_sse_server.py`)
33 
34- Uses Server-Sent Events (SSE) for communication
35- Designed as a standalone web server that can handle multiple client connections
36- Server runs persistently until manually stopped
37- Binds to `127.0.0.1:8001` by default (configurable)
38 
39**Manual Usage:**
40```bash
41python braintree_sse_server.py
42```
43 
44**Connecting to the SSE server:**
45Use an MCP client that supports SSE transport and connect to `http://127.0.0.1:8001/sse`
46 
47## Overview
48 
49This server implements the Model Context Protocol (MCP) specification to provide AI assistant models with direct, structured access to Braintree's payment processing capabilities via GraphQL API. It enables AI systems to perform payment operations like fetching transactions, creating payments, and managing customer data through MCP tools.
50 
51## Installation
52 
531. Clone this repository
54```bash
55git clone https://github.com/yourusername/braintree-mcp-server.git
56cd braintree-mcp-server
57```
58 
592. Set up a Python 3.13+ environment
60```bash
61# If using pyenv
62pyenv install 3.13.0
63pyenv local 3.13.0
64 
65# Or using another method to ensure Python 3.13+
66```
67 
683. Install dependencies
69```bash
70pip install -e .
71```
72 
73## Configuration
74 
75Create a `.env` file in the project root with your Braintree credentials:
76 
77```
78BRAINTREE_MERCHANT_ID=your_merchant_id
79BRAINTREE_PUBLIC_KEY=your_public_key
80BRAINTREE_PRIVATE_KEY=your_private_key
81BRAINTREE_ENVIRONMENT=sandbox  # or production
82```
83 
84You can obtain these credentials from your Braintree Control Panel.
85 
86## Usage
87 
88### Running the server
89 
90#### Default STDIO Transport
91```bash
92python braintree_server.py
93```
94 
95The server runs using stdio transport by default, which is suitable for integration with AI assistant systems that support MCP.
96 
97#### Server-Sent Events (SSE) Transport
98```bash
99python braintree_sse_server.py
100```
101 
102The SSE server provides a web-based transport layer that allows multiple persistent client connections. This is useful for standalone deployments where multiple clients need to access the Braintree functionality.
103 
104Default configuration:
105- Host: 127.0.0.1 (localhost)
106- Port: 8001
107- Environment: Defined in your .env file
108 
109See `requirements.txt` for the required dependencies.
110 
111### Available MCP Tools
112 
113#### braintree_ping
114 
115Simple connectivity test to check if your Braintree credentials are working.
116 
117```python
118response = await braintree_ping()
119# Returns "pong" if successful
120```
121 
122#### braintree_execute_graphql
123 
124Execute arbitrary GraphQL queries against the Braintree API.
125 
126```python
127query = """
128query GetTransactionDetails($id: ID!) {
129  node(id: $id) {
130    ... on Transaction {
131      id
132      status
133      amount {
134        value
135        currencyCode
136      }
137      createdAt
138    }
139  }
140}
141"""
142 
143variables = {"id": "transaction_id_here"}
144 
145response = await braintree_execute_graphql(query, variables)
146# Returns JSON response from Braintree
147```
148 
149## Common GraphQL Operations
150 
151### Fetch Customer
152 
153```graphql
154query GetCustomer($id: ID!) {
155  node(id: $id) {
156    ... on Customer {
157      id
158      firstName
159      lastName
160      email
161      paymentMethods {
162        edges {
163          node {
164            id
165            details {
166              ... on CreditCardDetails {
167                last4
168                expirationMonth
169                expirationYear
170                cardType
171              }
172            }
173          }
174        }
175      }
176    }
177  }
178}
179```
180 
181### Create Transaction
182 
183```graphql
184mutation CreateTransaction($input: ChargePaymentMethodInput!) {
185  chargePaymentMethod(input: $input) {
186    transaction {
187      id
188      status
189      amount {
190        value
191        currencyCode
192      }
193    }
194  }
195}
196```
197 
198With variables:
199```json
200{
201  "input": {
202    "paymentMethodId": "payment_method_id_here",
203    "transaction": {
204      "amount": "10.00",
205      "orderId": "order123",
206      "options": {
207        "submitForSettlement": true
208      }
209    }
210  }
211}
212```
213 
214## Troubleshooting
215 
216- Ensure your Braintree credentials are correct in the `.env` file
217- Verify your network connection can reach Braintree's API endpoints
218- Check for any rate limiting or permission issues with your Braintree account