# Braintree MCP by usefulapi

> Braintree MCP by usefulapi is a freemium MCP server for finance and payments. Hosted MCP server to search Braintree payments and issue refunds from AI clients. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web
- **Website:** https://usefulapi.io/braintree/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/braintree
- **MCP Registry name:** io.usefulapi/braintree
- **Categories:** finance and payments
- **Listing updated:** 2026-11-18

## About

The README describes a hosted endpoint that lets Claude, ChatGPT, Cursor or another MCP client query a Braintree merchant account. Nothing needs to be installed locally; you sign in through an OAuth login page and enter your Braintree environment, merchant ID and API keys.

The server exposes 11 tools. Five are read-only: finding a transaction, searching transactions by created-at range, status or customer, looking up a customer, and listing a customer's vaulted cards and PayPal accounts. Two tools can change data, refunding a settled transaction or voiding one that has not settled yet, and the rest manage usage and subscriptions for the server itself.

The page states that Braintree's GraphQL API does not expose native subscription objects, so recurring charges are traced through a customer's transaction history rather than subscription records. The product is independent and not affiliated with Braintree.

It suits merchants and finance staff who want to ask plain-language questions about failed or pending payments, or who need to issue refunds with a confirmation step in the client.

## Features

- **Transaction search:** Filters transactions by created-at date range, status or customer and returns amount, status and date.
- **Customer lookup:** Opens a customer record to read its name, company and creation date.
- **Saved payment methods:** Lists the cards and PayPal accounts vaulted for a given customer.
- **Refunds and voids:** Refunds settled transactions in full or part, or voids unsettled ones, both as write tools.
- **OAuth sign-in:** Connects with a login page instead of an API key placed in client config.
- **Usage metering:** Reports calls used against the monthly plan limit through a usage status tool.

## Good for

- Find failed payments from the past week and total them
- Check which payments are still waiting to settle
- Review a customer's saved cards before a support request
- Trace a customer's repeated charges by reading their transaction history
- Issue a partial refund after confirming the transaction in the client

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http braintree https://braintree.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://braintree.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "braintree": {
      "url": "https://braintree.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "braintree": {
      "type": "http",
      "url": "https://braintree.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "braintree": {
      "serverUrl": "https://braintree.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "braintree": {
      "type": "http",
      "url": "https://braintree.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `braintree_find_transaction`: Fetch one transaction by its GraphQL global ID (the opaque `id` returned by braintree_search_transactions, NOT the short legacy id). Uses the GraphQL `node` query. Returns amount, status, timestamps, order id, and the linked customer.
- `braintree_search_transactions`: Search transactions by created-at date range, status, and/or customer. Builds a TransactionSearchInput (operators: status `in`, createdAt `greaterThanOrEqualTo`/`lessThanOrEqualTo`, customer.id `is`). Returns a page of transaction nodes (id, legacyId, amount, status, createdAt). GraphQL `search { transactions }`.
- `braintree_find_customer`: Fetch one customer by GraphQL global Customer ID via the `node` query. Returns id, legacyId, name, company, and created-at. To also enumerate stored cards/PayPal accounts use braintree_customer_payment_methods.
- `braintree_customer_payment_methods`: List the vaulted payment methods (credit cards, PayPal accounts, etc.) for one customer, by GraphQL global Customer ID. Returns each method's id, legacyId, usage, created-at, and detail type. GraphQL `node { ... on Customer { paymentMethods } }`.
- `braintree_list_subscriptions`: List a customer's recurring / subscription payment activity. IMPORTANT: Braintree's GraphQL API does NOT expose native Subscription objects (recurring-billing management is still legacy-API only — see braintree/graphql-api issue #1). This tool therefore returns the customer's transactions (the observable evidence of subscription charges) via a TransactionSearchInput scoped to the customer; inspect
- `braintree_refund_transaction`: DESTRUCTIVE. Refund a SETTLED (or settling) transaction, returning money to the customer. Use the GraphQL global transaction ID. Omit `amount` for a full refund, or pass a decimal string for a partial refund. GraphQL mutation `refundTransaction`. For transactions not yet settled, use braintree_void_transaction instead.
- `braintree_void_transaction`: DESTRUCTIVE. Void (cancel) a transaction that has NOT yet settled — e.g. an authorization or one submitted-for-settlement. Use the GraphQL global transaction ID. GraphQL mutation `voidTransaction`. For already-settled transactions use braintree_refund_transaction instead.

## FAQ

### Is this an official Braintree product?

No. usefulapi is an independent service and is not affiliated with or endorsed by Braintree.

### Can the AI change my Braintree data?

Yes, through two write tools, refund and void. The page says most MCP clients ask for approval before a tool call runs.

### What does it cost?

The Free plan includes 50 tool calls per month. Pro is $9 per month or $90 per year with 10,000 calls, and Pro+ is $39 per month or $390 per year with 100,000 calls.

### What do I need to connect?

The login page asks for your Braintree Environment, Merchant ID, Public key and Private key.

### Is Braintree MCP by usefulapi free?

Braintree MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Braintree MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http braintree https://braintree.usefulapi.io/mcp

### What are the best alternatives to Braintree MCP by usefulapi?

The closest alternatives to Braintree MCP by usefulapi are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 13 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/braintree-mcp-by-usefulapi
