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 分