io.github.codespar/mcp-dlocal MCP Server

This Model Context Protocol (MCP) server provides tools for dLocal to perform LatAm cross-border payments. It targets 15+ countries using local payment methods and abstracts country-specific PSP differences not available from per-country servers alone.

🛠️ Key Features

dLocal payments across 15+ LatAm countries
Supports local payment methods: Pix, OXXO, PSE, SPEI, Boleto, cards
Includes 18 tools (toolCount) for creating and retrieving payments

🚀 Use Cases

Create pay-ins in a specific LatAm country with a local payment method
Check payment status and details by dLocal payment id
Look up payment details using a merchant-side order_id from creation

⚡ Developer Benefits

Standardizes payments operations via MCP tools instead of handling per-country PSP behavior
Retrieves payment information using either dLocal payment id or order_id

⚠️ Limitations

Coverage described here is limited to LatAm cross-border payments and the listed local payment methods

Tools (18)

Tool

Purpose

create_payment

Create a payment (pay-in) in a LatAm country using a local payment method.

get_payment

Get payment status and full detail by dLocal payment id.

get_payment_by_order_id

Get a payment by the merchant-side order_id supplied at creation time.

list_payments

List payments with optional date / country / status filters.

capture_payment

Capture an AUTHORIZED card payment.

cancel_payment

Cancel an authorized-but-not-captured payment, or void a PENDING payment.

create_refund

Refund a captured payment.

get_refund

Get refund status by refund id.

list_refunds

List refunds, optionally scoped to a payment_id.

create_payout

Send money out to a beneficiary in a LatAm country.

get_payout

Get payout status by dLocal payout id.

get_payout_by_external_id

Get a payout by the merchant external_id / order_id supplied at creation time.

list_payouts

List payouts with optional date / country / status filters.

list_payment_methods

List all payment methods available for a given country.

get_balance

Get the merchant's current available balance per currency.

get_exchange_rate

Query the dLocal FX rate for a destination country/currency pair.

create_card_token

Tokenize a card for use in DIRECT-flow create_payment.

validate_document

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

DLOCAL_LOGIN="..." # X-Login header value DLOCAL_TRANS_KEY="..." # X-Trans-Key header value DLOCAL_SECRET_KEY="..." # HMAC secret used to sign V2 requests DLOCAL_BASE_URL="..." # Optional. Defaults to https://api.dlocal.com. Use https://sandbox.dlocal.com for sandbox.

Install

Configuration

Environment variables

DLOCAL_LOGINrequired

dLocal API Login (X-Login header)

DLOCAL_TRANS_KEYrequiredsecret

dLocal API Trans-Key (X-Trans-Key header)

DLOCAL_SECRET_KEYrequiredsecret

dLocal API Secret Key used to sign V2 HMAC-SHA256 requests

DLOCAL_BASE_URL

dLocal API base URL. Defaults to https://api.dlocal.com (prod). Use https://sandbox.dlocal.com for sandbox.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-dlocal": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-dlocal@0.2.2"
      ],
      "env": {
        "DLOCAL_LOGIN": "<YOUR_DLOCAL_LOGIN>",
        "DLOCAL_TRANS_KEY": "<YOUR_DLOCAL_TRANS_KEY>",
        "DLOCAL_SECRET_KEY": "<YOUR_DLOCAL_SECRET_KEY>",
        "DLOCAL_BASE_URL": "<YOUR_DLOCAL_BASE_URL>"
      }
    }
  }
}

io.github.codespar/mcp-dlocal