Mcp Braspag

io.github.codespar由 GitHub 帳號 codespar 發布v0.2.2更新於 Oct 24, 2026

MCP server for Braspag — Cielo orchestration, token vault (Cartão Protegido), recurrence, split

已驗證STDIO僅桌面金融商業與電商

概覽

AI 產生的概覽

面向 Braspag（Cielo 集團）的本機 MCP 伺服器，讓助理建立、請款、取消與查詢付款，並管理定期扣款、卡令牌與 marketplace 分帳。

可以做什麼
  • 建立、請款與取消交易，包含 boleto、Pix、3DS 及零金額驗卡
  • 依付款 ID 或商戶訂單編號查詢交易明細
  • 在 Cartão Protegido 卡庫中將卡片令牌化、讀取與刪除
  • 建立、停用、重新啟用定期扣款，並更新金額與下次扣款日期
  • 建立分帳交易，並依子商戶金額進行分帳請款
  • 送出獨立防詐分析
適用情境
適合已開通 Braspag Pagador 的商戶與團隊，希望由助理執行收款、請款、退款、定期扣款、卡令牌、marketplace 分帳與防詐等付款作業，通常先在沙箱環境試用。
執行需求
透過 npx 從 npm 套件 @codespar/mcp-braspag 在本機執行（需 Node.js）。需要由 Cielo/Braspag 客戶團隊開通的 Braspag 商戶合約，並以環境變數設定 BRASPAG_MERCHANT_ID 與 BRASPAG_MERCHANT_KEY；BRASPAG_ENV 選擇 sandbox（預設）或 production。需能連線至 Braspag 介面。
安裝前請注意
涉及真實金流：工具會建立交易、請款、取消、變更定期扣款金額並刪除卡庫令牌，且 BRASPAG_ENV=production 會指向正式環境介面。BRASPAG_MERCHANT_KEY 是機密憑證，請勿寫入共用設定。卡號與客戶資料會傳送至 Braspag 及其防詐服務。建議先在沙箱測試。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Braspag，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@codespar/mcp-braspag

MCP server for Braspag — Cielo Group's enterprise orchestration layer: multi-acquirer routing, token vault (Cartão Protegido), recurrence, marketplace split, antifraud orchestration.

[npm] [License: MIT]

Braspag vs. Cielo (Acquirer)

CodeSpar ships two Cielo Group servers with different business contracts:

ServerProductWhat it isWho uses it
@codespar/mcp-cieloCielo AcquirerDirect card acquiring rails (credit, debit, boleto, Pix)Any merchant taking cards through Cielo
@codespar/mcp-braspag (this)Braspag / PagadorEnterprise orchestration on top of any acquirerEnterprise BR retail (Magalu-tier): multi-acquirer routing, token vault, marketplace split

Braspag orchestrates across acquirers. You keep your Cielo (or Rede, or Stone) acquiring contract and layer Braspag on top for: smart routing, failover, vaulting cards once and reusing across acquirers (Cartão Protegido), driving recurrence, and splitting marketplace capture across sub-merchants.

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json
{  "mcpServers": {    "braspag": {      "command": "npx",      "args": ["-y", "@codespar/mcp-braspag"],      "env": {        "BRASPAG_MERCHANT_ID": "your-merchant-uuid",        "BRASPAG_MERCHANT_KEY": "your-merchant-key",        "BRASPAG_ENV": "sandbox"      }    }  }}

Claude Code

bash
claude mcp add braspag -- npx @codespar/mcp-braspag

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

json
{  "servers": {    "braspag": {      "command": "npx",      "args": ["-y", "@codespar/mcp-braspag"],      "env": {        "BRASPAG_MERCHANT_ID": "your-merchant-uuid",        "BRASPAG_MERCHANT_KEY": "your-merchant-key",        "BRASPAG_ENV": "sandbox"      }    }  }}

Tools (22)

ToolPurpose
create_saleCreate a sale on the Braspag Transaction API (POST /sales).
capture_saleCapture a pre-authorized sale (PUT /sales/{paymentId}/capture).
void_saleVoid / cancel a sale (PUT /sales/{paymentId}/void).
create_recurrentCreate a recurrent payment schedule (POST /recurrentPayments).
disable_recurrentDeactivate a recurrent payment (PUT /recurrentPayments/{recurrentPaymentId}/Deactivate).
update_recurrent_amountUpdate the charged amount on a recurrent payment (PUT /recurrentPayments/{recurrentPaymentId}/Amount).
get_saleGet sale detail by PaymentId (GET /sales/{paymentId} — Query API).
get_sale_by_order_idLook up sale(s) by MerchantOrderId (GET /sales?merchantOrderId=X — Query API).
get_recurrentGet a recurrent payment's configuration and history (GET /recurrentPayments/{recurrentPaymentId} — Query API).
tokenize_cardTokenize a card into the Braspag vault / Cartão Protegido (POST /card).
get_card_tokenRetrieve the stored card data associated with a Cartão Protegido token (GET /card/{token}).
create_split_saleCreate a sale with marketplace split rules (POST /sales with Payment.SplitPayments).
create_sale_3dsCreate a 3DS-authenticated credit sale (POST /sales).
create_zero_authZero-dollar authorization / card validation (POST /zeroauth).
create_boleto_saleConvenience wrapper to create a Boleto sale (POST /sales with Payment.Type=Boleto).
create_pix_saleConvenience wrapper to create a Pix sale (POST /sales with Payment.Type=Pix).
reactivate_recurrentReactivate a previously deactivated recurrent payment (PUT /recurrentPayments/{recurrentPaymentId}/Reactiva...
update_recurrent_next_paymentUpdate the NextPaymentDate on a recurrent payment (PUT /recurrentPayments/{recurrentPaymentId}/NextPaymentD...
update_recurrent_paymentUpdate the Payment (CreditCard + Customer) on a recurrent schedule (PUT /recurrentPayments/{recurrentPaymen...
create_antifraud_analysisSubmit a standalone Antifraud analysis (POST /fraudanalysis) through Braspag's antifraud orchestration (Cyb...
delete_card_tokenDelete a Cartão Protegido vault token (DELETE /card/{token}).
create_split_captureCapture a previously authorized split sale with overridden per-sub-merchant amounts (PUT /sales/{paymentId}...

Authentication

Braspag uses MerchantId (UUID) and MerchantKey (secret) headers on both the Transaction API and the Query API.

Environments

EnvTransaction APIQuery API
sandbox (default)https://apisandbox.braspag.com.br/v2https://apiquerysandbox.braspag.com.br/v2
productionhttps://api.braspag.com.br/v2https://apiquery.braspag.com.br/v2

Set via BRASPAG_ENV=production to switch.

Get your credentials

  1. Reach out to your Cielo / Braspag account team to enable Braspag Pagador on your merchant contract.
  2. Receive your MerchantId (UUID) and MerchantKey.
  3. Set the environment variables below.

Environment Variables

VariableRequiredDescription
BRASPAG_MERCHANT_IDYesMerchant UUID
BRASPAG_MERCHANT_KEYYesMerchant secret key
BRASPAG_ENVNosandbox (default) or production

Roadmap

v0.2 (planned)

  • create_sale_with_card_token — convenience wrapper that uses a Cartão Protegido token
  • delete_card_token — revoke a vault token
  • get_sale_antifraud — Query API antifraud detail
  • update_recurrent_payment — update non-amount fields on a recurrent
  • create_zero_auth — zero-dollar auth for card validation

v0.3 (planned)

  • Marketplace: sub-merchant onboarding endpoints
  • Bank slip (boleto) registered-only helpers
  • Webhook verification helper

Want to contribute? Open a PR or request a tool.

Links

Enterprise

Need governance, budget limits, and audit trails for agent-driven payments on Braspag? CodeSpar Enterprise adds a policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

來源：packages/payments/braspag/README.md，提交 d0a519a

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.2.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分