Dlocal MCP Server

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. Its 18 documented tools cover payment, payout, refund.

People connecting finance tools to Claude, Cursor, VS Code, or another MCP client. The project is written in JavaScript.

One of 127 MCP servers published from codespar/mcp-dev-latam. Stars and repository activity are shared across all of them. See all 127 →

VERIFIED ACTIVE

LAST COMMIT 2026-08-12 · VERIFIED 2026-08-25

MIT · JavaScript servers · how we verify → /methodology

01 · Install Dlocal

before you install - you'll need

Set DLOCAL_LOGIN, DLOCAL_TRANS_KEY, DLOCAL_SECRET_KEY, MCP_HTTP before connecting. DLOCAL_BASE_URL is optional or environment-specific per the README.

Claude Code

claude mcp add codespar-mcp-dev-latam-packages-payments -- npx -y @codespar/mcp-dlocal

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "codespar-mcp-dev-latam-packages-payments": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-dlocal"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @codespar/mcp-dlocal - published under the repo owner's npm scope (@codespar)

registry namespace io.github.codespar is GitHub-verified and matches the repo owner

03 · What Dlocal can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can create a payment (pay-in) in a LatAm country using a local payment method, get payment status and full detail by dLocal payment id, get a payment by the merchant-side order_id supplied at creation time, and list payments with optional date / country / status filters.

Capability map

Tools grouped from the project's README - what Dlocal lets an agent do.

Payment

6 tools - e.g. Create a payment (pay-in) in a LatAm country using a local payment method.; Get payment status and full detail by dLocal payment id.; Get a payment by the merchant-side order_id supplied at creation time.

create_payment · get_payment · get_payment_by_order_id · capture_payment · cancel_payment · list_payment_methods

read & search

5 tools - e.g. List payments with optional date / country / status filters.; List refunds, optionally scoped to a payment_id.; List payouts with optional date / country / status filters.

list_payments · list_refunds · list_payouts · get_balance · get_exchange_rate

Payout

3 tools - e.g. Send money out to a beneficiary in a LatAm country.; Get payout status by dLocal payout id.; Get a payout by the merchant external_id / order_id supplied at creation time.

create_payout · get_payout · get_payout_by_external_id

Refund

2 tools - e.g. Refund a captured payment.; Get refund status by refund id.

create_refund · get_refund

create & write

1 tool - e.g. Tokenize a card for use in DIRECT-flow create_payment.

create_card_token

Validate

1 tool - e.g. Validate a LatAm tax/identity document (CPF or CNPJ in BR, CUIT/CUIL/DNI in AR, RUT in CL/UY, RFC/CURP in M...

validate_document

04 · Who maintains Dlocal

mcp-dlocal is maintained by codespar. We track 127 MCP servers from codespar - 127 actively maintained, 269 combined GitHub stars, oldest repo from Mar 2026. Full record: all servers from codespar.

05 · Facts

repository: github.com/codespar/mcp-dev-latam
category: finance - actively maintained as of 2026-08-25.
registry: io.github.codespar/mcp-dlocal (active, first published 2026-06-20 · 2 versions)
packages: npm:@codespar/mcp-dlocal

06 · Dlocal FAQ

Is Dlocal still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-12. We re-verify nightly.

What can Dlocal do?

How do I install Dlocal?

Run `npx -y @codespar/mcp-dlocal`. The README documents 5 environment variables (DLOCAL_LOGIN, DLOCAL_TRANS_KEY, DLOCAL_SECRET_KEY…) to set first. Set DLOCAL_LOGIN, DLOCAL_TRANS_KEY, DLOCAL_SECRET_KEY, MCP_HTTP before connecting. DLOCAL_BASE_URL is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Dlocal run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Dlocal

Alternatives to Dlocal

Maintained finance servers if Dlocal isn't the fit.

Pairs well with

Servers that cover what Dlocal doesn't - only shown when the pairing reason fits the companion.

More finance MCP servers · Ebanx · Flow Cl · Iugu · Khipu · Mercado Pago

More JavaScript MCP servers · Efi · Getnet · Inter Bank · see all