Mcp Dlocal

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

MCP server for dLocal — LatAm cross-border payments, payouts, refunds across 15+ countries

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

概覽

AI 產生的概覽

面向 dLocal 的本機 MCP 伺服器，讓助理在 15 個以上國家建立與管理拉美跨境付款、退款與撥款。

可以做什麼
建立、請款、取消與查詢付款，可依商戶訂單編號查詢，並支援依日期、國家與狀態篩選列出付款。發起退款並查詢或列出退款狀態。向收款人發起撥款，並依 dLocal 編號或外部編號追蹤。依國家列出可用付款方式，查詢各幣別商戶餘額與匯率。將卡片權杖化，並驗證拉美稅籍或身分證件。
適用情境
當助理需要在聊天或代理流程中操作 dLocal 商戶帳戶時使用：在拉美收取本地方式付款、退款、發起撥款，或查詢餘額與匯率。
執行需求
透過 npx 或 npm install 以本機 Node.js 程序執行。需要 DLOCAL_LOGIN、DLOCAL_TRANS_KEY 與 DLOCAL_SECRET_KEY；DLOCAL_BASE_URL 為選用，預設指向正式環境端點，另有沙箱端點可用。需要能連線至 dLocal API 的網路。
安裝前請注意
此伺服器持有真實付款憑證（DLOCAL_SECRET_KEY、DLOCAL_TRANS_KEY），且預設連線正式 API，可能造成真實資金流動。工具會建立付款、退款與撥款，並可取消或請款；測試時應將 DLOCAL_BASE_URL 指向沙箱。卡片權杖化與證件驗證會處理敏感客戶資料並傳送給 dLocal。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

@codespar/mcp-dlocal

MCP server for dLocal — LatAm cross-border payments.

One API, 15+ LatAm countries, local payment methods (Pix, OXXO, PSE, SPEI, Boleto, cards). The abstraction that per-country PSP servers cannot provide on their own.

Tools (18)

ToolPurpose
create_paymentCreate a payment (pay-in) in a LatAm country using a local payment method.
get_paymentGet payment status and full detail by dLocal payment id.
get_payment_by_order_idGet a payment by the merchant-side order_id supplied at creation time.
list_paymentsList payments with optional date / country / status filters.
capture_paymentCapture an AUTHORIZED card payment.
cancel_paymentCancel an authorized-but-not-captured payment, or void a PENDING payment.
create_refundRefund a captured payment.
get_refundGet refund status by refund id.
list_refundsList refunds, optionally scoped to a payment_id.
create_payoutSend money out to a beneficiary in a LatAm country.
get_payoutGet payout status by dLocal payout id.
get_payout_by_external_idGet a payout by the merchant external_id / order_id supplied at creation time.
list_payoutsList payouts with optional date / country / status filters.
list_payment_methodsList all payment methods available for a given country.
get_balanceGet the merchant's current available balance per currency.
get_exchange_rateQuery the dLocal FX rate for a destination country/currency pair.
create_card_tokenTokenize a card for use in DIRECT-flow create_payment.
validate_documentValidate a LatAm tax/identity document (CPF or CNPJ in BR, CUIT/CUIL/DNI in AR, RUT in CL/UY, RFC/CURP in M...

Install

bash
npm install @codespar/mcp-dlocal

Environment

bash
DLOCAL_LOGIN="..."        # X-Login header valueDLOCAL_TRANS_KEY="..."    # X-Trans-Key header valueDLOCAL_SECRET_KEY="..."   # HMAC secret used to sign V2 requestsDLOCAL_BASE_URL="..."     # Optional. Defaults to https://api.dlocal.com. Use https://sandbox.dlocal.com for sandbox.

Authentication

Every request signs with V2 HMAC-SHA256:

X-Date: <ISO-8601 UTC>X-Login: <login>X-Trans-Key: <trans_key>Authorization: V2-HMAC-SHA256, Signature: <hex(hmac_sha256(login + x_date + body, secret_key))>

The server handles signing automatically — you only configure the three env vars.

Run

bash
# stdio (default — for Claude Desktop, Cursor, etc)npx @codespar/mcp-dlocal
# HTTP (for server-to-server testing)MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-dlocal

Countries covered

Argentina, Bolivia, Brazil, Chile, Colombia, Costa Rica, Ecuador, Guatemala, Mexico, Peru, Uruguay, and more. Use list_payment_methods to enumerate available methods per country at runtime rather than hard-coding.

Enterprise

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

License

MIT

來源：packages/payments/dlocal/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 分