{"_id":"@codespar/mcp-braintree","_rev":"5-88ef2519b7fd82950a6827bf07a07d5c","name":"@codespar/mcp-braintree","dist-tags":{"latest":"0.2.2"},"versions":{"0.1.0":{"name":"@codespar/mcp-braintree","version":"0.1.0","keywords":["mcp","braintree","paypal","payments","graphql","cards","vault","global","latam"],"license":"MIT","_id":"@codespar/mcp-braintree@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-braintree":"dist/index.js"},"dist":{"shasum":"157e192dcf683ed8aa67be196161da6e02a151ab","tarball":"https://registry.npmjs.org/@codespar/mcp-braintree/-/mcp-braintree-0.1.0.tgz","fileCount":6,"integrity":"sha512-J0pJ5AYdAxc0oG01W23/IOmbziovaES2tNK/w19UjxopFBlwUJ8I72oAE/JEmGfcZ42hF2MML0gzKZx1nElpZA==","signatures":[{"sig":"MEYCIQD3Z4VuazgvB5j3fkr96gH7wUx8wkcnO9dBoLKjdigTIgIhAKoBapS4Hfc3FCA1FnojXIomRuR4988tf3h/WQfqN4Xw","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":57758},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"472f257c5702fe7b9c9f5f24230875c585c1dfc6","mcpName":"io.github.codespar/mcp-braintree","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Braintree (PayPal) — global payment processor via the Braintree GraphQL API. Authorize, charge, capture, refund, void; vault payment methods; manage customers; mint client tokens.","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-braintree_0.1.0_1776994114901_0.2724788069703201","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@codespar/mcp-braintree","version":"0.2.0","keywords":["mcp","braintree","paypal","payments","graphql","cards","vault","global","latam"],"license":"MIT","_id":"@codespar/mcp-braintree@0.2.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-braintree":"dist/index.js"},"dist":{"shasum":"ecc8cd0818ecd56d6233b18a8d89e43305904452","tarball":"https://registry.npmjs.org/@codespar/mcp-braintree/-/mcp-braintree-0.2.0.tgz","fileCount":6,"integrity":"sha512-Afv9dySFKHcCsQs+V4toRqwmFZ/bR/zUB/lrvgmOW9bedOgDPZX/LAhutXyiVfegJO7fTjTclA469na55/6uLQ==","signatures":[{"sig":"MEUCIQD9vAWYra5BNCwdgJRivjHjQG78Yd9h/1B5TEA/ndvsfQIgYfF9AufbzYQz8Xq+LGK4kkQnYw4Z1k46yA8aH+CYKVM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":89524},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"475d6a412c639d70728792f31d502e9268bb06bb","mcpName":"io.github.codespar/mcp-braintree","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Braintree (PayPal) — global payment processor via the Braintree GraphQL API. Authorize, charge, capture, refund, void; vault payment methods; manage customers; mint client tokens.","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-braintree_0.2.0_1777042989271_0.71497241088079","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@codespar/mcp-braintree","version":"0.2.1","keywords":["mcp","braintree","paypal","payments","graphql","cards","vault","global","latam"],"license":"MIT","_id":"@codespar/mcp-braintree@0.2.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-braintree":"dist/index.js"},"dist":{"shasum":"d8ad334768a6ffe0718043a5ed73426dc9105e67","tarball":"https://registry.npmjs.org/@codespar/mcp-braintree/-/mcp-braintree-0.2.1.tgz","fileCount":6,"integrity":"sha512-I8PJMumK9eNRITG0tthzuou8qFrywO9akk1f/F2Gzqw21JSWdzwS4qmz3cdcIqptx4hXb89Je4g+mYpzC9tylQ==","signatures":[{"sig":"MEUCIQDfBn8X4OpsG5MpeWCETw+wCTyz9YvfBNY90OPP74z9mAIgHrKMPWBTKviy95h4yNX1zVT7ADvVdRCguS7ktU99xrA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":90889},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-braintree","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Braintree (PayPal) — global payment processor via the Braintree GraphQL API. Authorize, charge, capture, refund, void; vault payment methods; manage customers; mint client tokens.","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-braintree_0.2.1_1777123166749_0.33394783210086043","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@codespar/mcp-braintree","version":"0.2.2","description":"MCP server for Braintree (PayPal) — global payment processor via the Braintree GraphQL API. Authorize, charge, capture, refund, void; vault payment methods; manage customers; mint client tokens.","type":"module","main":"./dist/index.js","bin":{"mcp-braintree":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","braintree","paypal","payments","graphql","cards","vault","global","latam"],"mcpName":"io.github.codespar/mcp-braintree","_id":"@codespar/mcp-braintree@0.2.2","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-Cui7EngNvMHG5vgTLM9hLUnVI3zt1Eaj3LSQIMviAU9kg2DsvvN/rIz+ZwWSvZB0XJDNTxYP07Asa9CqsRbIsg==","shasum":"e37e50e194c4040266140ffdef1033ce0c04f280","tarball":"https://registry.npmjs.org/@codespar/mcp-braintree/-/mcp-braintree-0.2.2.tgz","fileCount":6,"unpackedSize":92380,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICtRJRpEhMgxKD2jrropa7zpwOStOV3+jYHhFHsRmGKxAiAbPGO6UiA/8TRdB5nrJzCCjW8gOaHXj36ke1RN3OD/lQ=="}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-braintree_0.2.2_1782153783950_0.6359424508560192"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-24T01:28:34.785Z","modified":"2026-06-22T18:43:04.235Z","0.1.0":"2026-04-24T01:28:35.033Z","0.2.0":"2026-04-24T15:03:09.414Z","0.2.1":"2026-04-25T13:19:26.876Z","0.2.2":"2026-06-22T18:43:04.082Z"},"license":"MIT","keywords":["mcp","braintree","paypal","payments","graphql","cards","vault","global","latam"],"description":"MCP server for Braintree (PayPal) — global payment processor via the Braintree GraphQL API. Authorize, charge, capture, refund, void; vault payment methods; manage customers; mint client tokens.","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-braintree\n\nMCP server for [Braintree](https://www.braintreepayments.com) (PayPal) — global card processing via the Braintree **GraphQL** API.\n\nTarget customer: LatAm SaaS selling to US/EU buyers who already hold a Braintree merchant account and want agent-driven payments, vaulting, and customer management.\n\n## Tools (22)\n\n| Tool | Purpose |\n|---|---|\n| `authorize_transaction` | Authorize a transaction (reserve funds without capturing) via Braintree GraphQL authorizePaymentMethod. |\n| `charge_transaction` | Authorize and capture a transaction atomically via Braintree GraphQL chargePaymentMethod. |\n| `capture_transaction` | Capture a previously authorized transaction via captureTransaction. |\n| `refund_transaction` | Refund a settled transaction via refundTransaction. |\n| `void_transaction` | Void an unsettled transaction (reverse the authorization) via reverseTransaction. |\n| `vault_payment_method` | Permanently store a tokenized payment method in the Braintree vault via vaultPaymentMethod. |\n| `delete_payment_method` | Delete a vaulted payment method via deletePaymentMethodFromVault. |\n| `create_customer` | Create a Braintree customer via createCustomer. |\n| `update_customer` | Update an existing Braintree customer via updateCustomer. |\n| `get_transaction` | Fetch a transaction by id via the GraphQL search.transactions query. |\n| `get_customer` | Fetch a customer by id via the GraphQL node(id:) query. |\n| `submit_for_settlement` | Submit a previously authorized transaction for settlement via submitTransactionForSettlement. |\n| `update_payment_method` | Update metadata on a vaulted payment method via updatePaymentMethod. |\n| `verify_payment_method` | Run a credit-card verification (zero-auth or $1 auth) on a tokenized payment method via verifyPaymentMethod. |\n| `delete_customer` | Delete a Braintree customer via deleteCustomer. |\n| `find_customer` | Search for customers via the GraphQL search.customers query. |\n| `search_transactions` | Search transactions via the GraphQL search.transactions query. |\n| `find_dispute` | Fetch a dispute by id via the GraphQL node(id:) query. |\n| `accept_dispute` | Accept liability for a dispute via acceptDispute — the merchant concedes and the disputed amount is refunde... |\n| `finalize_dispute` | Finalize a dispute via finalizeDispute — submits previously added evidence to the card network for review. |\n| `find_merchant_account` | Fetch a merchant account by id via the GraphQL node(id:) query. |\n| `create_client_token` | Mint a Braintree client token via createClientToken for client-side tokenization (Drop-in, Hosted Fields, m... |\n\n## Install\n\n```bash\nnpm install @codespar/mcp-braintree\n```\n\n## Environment\n\n```bash\nBRAINTREE_MERCHANT_ID=\"...\"   # merchant id\nBRAINTREE_PUBLIC_KEY=\"...\"    # public API key (Basic auth user)\nBRAINTREE_PRIVATE_KEY=\"...\"   # private API key (Basic auth password, secret)\nBRAINTREE_ENV=\"sandbox\"       # 'sandbox' (default) or 'production'\nBRAINTREE_API_VERSION=\"2019-01-01\"  # optional, Braintree-Version header\n```\n\nEndpoints:\n- `sandbox` → `https://payments.sandbox.braintree-api.com/graphql`\n- `production` → `https://payments.braintree-api.com/graphql`\n\n## Authentication\n\nBraintree's GraphQL endpoint accepts HTTP Basic auth with `PUBLIC_KEY:PRIVATE_KEY` base64-encoded. Every request also requires a `Braintree-Version: YYYY-MM-DD` header — the server defaults to `2019-01-01` and can be overridden with `BRAINTREE_API_VERSION`.\n\n## Payment method ids\n\nMost mutations take a **paymentMethodId**. These come from client-side tokenization (Braintree Drop-in / Hosted Fields / SDKs) — the server does not accept raw PANs. Use `create_client_token` to mint a token for the browser or mobile SDK.\n\n## Run\n\n```bash\n# stdio (default — for Claude Desktop, Cursor, etc)\nnpx @codespar/mcp-braintree\n\n# HTTP (for server-to-server testing)\nMCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-braintree\n```\n\n## Notes\n\n- **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.\n- 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.\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}