io.github.codespar/mcp-dlocal
io.github.codespar/mcp-dlocal · 273 stars · TypeScript · MIT
MCP server MCP server for dLocal — LatAm cross-border payments, payouts, refunds across 15+ countries
Install
The repo has no one-line install. Follow its README.
Published as
- npm
@codespar/mcp-dlocalstdio
From the server's entry in the official MCP Registry.
Configuration
| Name | Set as | What it is |
|---|---|---|
DLOCAL_LOGINRequired | Env var | dLocal API Login (X-Login header) |
DLOCAL_TRANS_KEYRequired · Secret | Env var | dLocal API Trans-Key (X-Trans-Key header) |
DLOCAL_SECRET_KEYRequired · Secret | Env var | dLocal API Secret Key used to sign V2 HMAC-SHA256 requests |
DLOCAL_BASE_URLOptional | Env var | dLocal API base URL. Defaults to https://api.dlocal.com (prod). Use https://sandbox.dlocal.com for sandbox. |
Files
@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)
| 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... |
Install
npm install @codespar/mcp-dlocal
Environment
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.
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
# 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
Facts
- Kind
- MCP server
- Group
- Uncategorized
- Stars
- 273
- License
- MIT
- Language
- TypeScript
- Last push
- 2026-09-27
- Forks
- 50
- MCP Registry
- io.github.codespar/mcp-dlocal
- Homepage
- codespar.dev/servers
- Topics
- agentic-commerce, ai-agents, brazil, claude, fintech, latin-america, llm-tools, mcp, model-context-protocol, nfe, open-finance, payments, pix
- 1REAio.github.morluto/reaReverse engineer anything from your terminal or agent with one CLI and MCP server.125.3k
- 2com.browser-use/browser-usecom.browser-use/browser-useControl a real Chrome browser to complete any task: fill forms, extract data, book flights.117.7k
- 3World Monitorapp.worldmonitor/mcpLive markets, conflicts, country risk, chokepoints, energy, and China decision signals. 93 tools.88.3k
- 4Scrapling MCP Serverd4vinci/scrapling🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scraplingdev86.9k
- 5Everythingmodelcontextprotocol/serversThis MCP server attempts to exercise all the features of the MCP protocol. It is not intended to be a useful server, but rather a test server for builders of MCP clients. It implements prompts, tools, resources, sampling, and more to showcase MCP capabilities.85.8k
- 6Fetchmodelcontextprotocol/serversA Model Context Protocol server that provides web content fetching capabilities. This server enables LLMs to retrieve and process content from web pages, converting HTML to markdown for easier consumption.85.8k
