Dlocal MCP Server

by codespario.github.codespar/mcp-dlocalv0.2.2

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

272Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active12d ago

Install Dlocal MCP server

claude mcp add dlocal -e DLOCAL_LOGIN='<dlocal-login>' -e DLOCAL_TRANS_KEY='<dlocal-trans-key>' -e DLOCAL_SECRET_KEY='<dlocal-secret-key>' -- npx -y @codespar/mcp-dlocal

{
  "mcpServers": {
    "dlocal": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-dlocal"
      ],
      "env": {
        "DLOCAL_LOGIN": "<dlocal-login>",
        "DLOCAL_TRANS_KEY": "<dlocal-trans-key>",
        "DLOCAL_SECRET_KEY": "<dlocal-secret-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "dlocal": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-dlocal"
      ],
      "env": {
        "DLOCAL_LOGIN": "<dlocal-login>",
        "DLOCAL_TRANS_KEY": "<dlocal-trans-key>",
        "DLOCAL_SECRET_KEY": "<dlocal-secret-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "dlocal": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-dlocal"
      ],
      "env": {
        "DLOCAL_LOGIN": "<dlocal-login>",
        "DLOCAL_TRANS_KEY": "<dlocal-trans-key>",
        "DLOCAL_SECRET_KEY": "<dlocal-secret-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "dlocal": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-dlocal"
      ],
      "env": {
        "DLOCAL_LOGIN": "<dlocal-login>",
        "DLOCAL_TRANS_KEY": "<dlocal-trans-key>",
        "DLOCAL_SECRET_KEY": "<dlocal-secret-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
DLOCAL_LOGIN	yes	—	dLocal API Login (X-Login header)
DLOCAL_TRANS_KEY	yes	yes	dLocal API Trans-Key (X-Trans-Key header)
DLOCAL_SECRET_KEY	yes	yes	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.

Freshness

Active — last maintenance signal 12d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-27 · 12d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-06-22 · 4mo ago · official registry · v0.2.2

FAQ

›How do I install the Dlocal MCP server in Claude Code?

Run: claude mcp add dlocal -e DLOCAL_LOGIN='<dlocal-login>' -e DLOCAL_TRANS_KEY='<dlocal-trans-key>' -e DLOCAL_SECRET_KEY='<dlocal-secret-key>' -- npx -y @codespar/mcp-dlocal. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Dlocal require an API key?

Yes. It expects DLOCAL_LOGIN, DLOCAL_TRANS_KEY, DLOCAL_SECRET_KEY, of which 2 are secrets.

›Can I use Dlocal as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Dlocal in the official MCP registry?

Yes, as io.github.codespar/mcp-dlocal.