mcp-braintree

@codespar/mcp-braintree

Braintree（PayPal）向けの MCP サーバーです。Braintree GraphQL API を介して、世界各地のカード決済を処理します。

対象顧客：Braintree の加盟店アカウントをすでに保有し、エージェント主導の決済、カード情報の保管、顧客管理を希望する、中南米の SaaS 企業と米国・EU の購入者です。

ツール（22）

ツール	目的
authorize_transaction	Braintree GraphQL の authorizePaymentMethod を介して取引を承認します（資金を確保し、売上確定は行いません）。
charge_transaction	Braintree GraphQL の chargePaymentMethod を介して、取引の承認と売上確定を一括で行います。
capture_transaction	captureTransaction を介して、事前に承認された取引の売上を確定します。
refund_transaction	refundTransaction を介して、決済済みの取引を返金します。
void_transaction	reverseTransaction を介して、未決済の取引を取り消します（承認を取り消します）。
vault_payment_method	vaultPaymentMethod を介して、トークン化された支払い方法を Braintree の保管庫に永続的に保存します。
delete_payment_method	deletePaymentMethodFromVault を介して、保管庫に保存された支払い方法を削除します。
create_customer	createCustomer を介して、Braintree の顧客を作成します。
update_customer	updateCustomer を介して、既存の Braintree 顧客を更新します。
get_transaction	GraphQL の search.transactions クエリを介して、ID で取引を取得します。
get_customer	GraphQL の node(id:) クエリを介して、ID で顧客を取得します。
submit_for_settlement	submitTransactionForSettlement を介して、事前に承認された取引を決済に回します。
update_payment_method	updatePaymentMethod を介して、保管庫に保存された支払い方法のメタデータを更新します。
verify_payment_method	verifyPaymentMethod を介して、トークン化された支払い方法のクレジットカード認証（ゼロオーソリまたは 1 ドルの与信）を実行します。
delete_customer	deleteCustomer を介して、Braintree の顧客を削除します。
find_customer	GraphQL の search.customers クエリを介して、顧客を検索します。
search_transactions	GraphQL の search.transactions クエリを介して、取引を検索します。
find_dispute	GraphQL の node(id:) クエリを介して、ID で異議申し立てを取得します。
accept_dispute	acceptDispute を介して、異議申し立てに対する責任を受け入れます。加盟店が譲歩し、申し立ての対象額が返金されます...
finalize_dispute	finalizeDispute を介して、異議申し立てを確定します。事前に追加された証拠をカードネットワークに送信し、審査を受けます。
find_merchant_account	GraphQL の node(id:) クエリを介して、ID で加盟店アカウントを取得します。
create_client_token	createClientToken を介して、クライアント側トークン化（Drop-in、Hosted Fields、m...）用の Braintree クライアントトークンを発行します。

インストール

npm install @codespar/mcp-braintree

環境

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

エンドポイント：

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

認証

Braintree の GraphQL エンドポイントでは、HTTP Basic 認証を使用します。PUBLIC_KEY:PRIVATE_KEY を Base64 エンコードして指定してください。すべてのリクエストで Braintree-Version: YYYY-MM-DD ヘッダーも必要です。サーバーのデフォルトは 2019-01-01 で、BRAINTREE_API_VERSION で上書きできます。

支払い方法の ID

ほとんどのミューテーションでは paymentMethodId を指定します。これらの ID はクライアント側のトークン化（Braintree Drop-in／Hosted Fields／SDK）で取得します。サーバーは PAN の生データを受け付けません。create_client_token を使用して、ブラウザーまたはモバイル SDK 用のトークンを発行してください。

実行

# stdio (default — for Claude Desktop, Cursor, etc)
npx @codespar/mcp-braintree

# HTTP (for server-to-server testing)
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-braintree

注記

• 金額は Braintree GraphQL では数値ではなく文字列です（例："10.50"）。サーバーはエージェントから渡された形式をそのまま転送するため、文字列を使用するのが安全です。
• Braintree の GraphQL スキーマは変更されることがあります。MCP の inputSchema に公開されていない入力フィールドでも、additional／ネストされたオブジェクトに渡せば転送される場合があります。

エンタープライズ

エージェントによる決済にガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、決済ルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT