Mcp Dlocal

io.github.codesparPublished by GitHub account codesparv0.2.2Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Local MCP server for dLocal that lets an assistant create and manage LatAm cross-border payments, refunds and payouts across 15+ countries.

What you can do
Create, capture, cancel and look up payments, including by merchant order ID, with date, country and status filters for listing them. Issue refunds and check or list refund status. Send payouts to beneficiaries and track them by dLocal ID or external ID. List available payment methods per country, check merchant balances per currency and query FX rates. Tokenize cards and validate LatAm tax or identity documents.
When to use it
Use it when an assistant needs to operate a dLocal merchant account from a chat or agent workflow: taking local-method payments in Latin America, refunding them, sending payouts, or checking balances and exchange rates.
Requirements
Runs as a local Node.js process via npx or npm install. Requires DLOCAL_LOGIN, DLOCAL_TRANS_KEY and DLOCAL_SECRET_KEY; DLOCAL_BASE_URL is optional and defaults to the production endpoint, with a sandbox endpoint available. Network access to the dLocal API is needed.
Before you install
The server holds live payment credentials (DLOCAL_SECRET_KEY, DLOCAL_TRANS_KEY) and defaults to the production API, so real money can move. Tools create payments, refunds and payouts and can cancel or capture payments; point DLOCAL_BASE_URL at the sandbox while testing. Card tokenization and document validation handle sensitive customer data sent to dLocal.

Installation

In SourceWeft

  1. Open Mcp Dlocal in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

Source: packages/payments/dlocal/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts