Mcp Ebanx

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

MCP server for EBANX — cross-border payments, payouts, exchange rates

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Local MCP server for EBANX cross-border payments in Latin America, letting an assistant create, query, capture, cancel and refund payments and payouts.

What you can do
Create, capture, cancel and refund payments, and look up payments by hash or merchant code, or list them by date range, plus simulate payments in sandbox and list payment methods by country. Create single or mass payouts to bank accounts and query payouts by reference or id. Look up exchange rates for currency pairs and list available banks for a country. Tokenize or delete stored card tokens. Validate LATAM tax documents such as CPF, CNPJ, RFC and DNI, and verify webhook notification signatures.
When to use it
Useful when an assistant needs to work with EBANX payment operations for Latin American commerce: creating or inspecting payments, issuing refunds or payouts, checking exchange rates and banks, or testing integrations in the EBANX sandbox.
Requirements
Runs locally via npx from the npm package @codespar/mcp-ebanx, so Node.js is needed. Requires an EBANX integration key in the EBANX_INTEGRATION_KEY environment variable, obtained from an EBANX developer account. Optionally set EBANX_SANDBOX to true to use the sandbox. Network access to EBANX is required.
Before you install
The integration key is a payment credential; keep it out of shared configs and logs. Tools can move real money: create_payment, create_payout, create_mass_payout, capture_payment and refund perform financial operations, and cancel_payment and delete_card_token change or remove data. Test in sandbox first. Card tokenization handles sensitive card data, and payment and payout details are sent to EBANX.

Installation

In SourceWeft

  1. Open Mcp Ebanx 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-ebanx

MCP server for EBANX — cross-border payments for Latin America

[npm] [License: MIT]

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json
{  "mcpServers": {    "ebanx": {      "command": "npx",      "args": ["-y", "@codespar/mcp-ebanx"],      "env": {        "EBANX_INTEGRATION_KEY": "your-key",        "EBANX_SANDBOX": "true"      }    }  }}

Claude Code

bash
claude mcp add ebanx -- npx @codespar/mcp-ebanx

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

json
{  "servers": {    "ebanx": {      "command": "npx",      "args": ["-y", "@codespar/mcp-ebanx"],      "env": {        "EBANX_INTEGRATION_KEY": "your-key",        "EBANX_SANDBOX": "true"      }    }  }}

Tools (18)

ToolPurpose
create_paymentCreate a payment in EBANX (boleto, credit card, PIX, etc.)
get_paymentGet payment details by hash
list_paymentsList payments by date range
refundRefund a payment (full or partial)
create_payoutCreate a payout to a bank account
exchange_rateGet current exchange rate for a currency pair
get_banksList available banks for a country
query_payment_by_merchant_codeGet payment details by merchant_payment_code (alternative to hash)
capture_paymentCapture a previously authorized credit card payment (full or partial).
cancel_paymentCancel/void a pending payment by hash (e.g.
create_mass_payoutCreate a mass payout — multiple payouts in a single batch request.
get_payoutQuery a payout by external_reference or payout id.
simulate_paymentSimulate the response of a payment in sandbox without persisting it (useful for integration testing).
list_payment_methodsList available payment methods for a country (which payment_type_codes are supported).
create_card_tokenTokenize a credit/debit card for reuse without re-collecting card data.
delete_card_tokenDelete a previously stored card token.
validate_documentValidate a LATAM tax document (CPF/CNPJ for BR, RFC for MX, DNI for AR/PE) using checksum/format rules.
verify_notificationVerify an EBANX webhook notification HMAC signature against the integration key.

Authentication

EBANX uses an integration key passed in the request body/query parameters.

Sandbox / Testing

EBANX provides a sandbox at sandbox.ebanx.com. Set EBANX_SANDBOX=true to use it.

Get your credentials

  1. Go to EBANX Dashboard
  2. Create a developer account
  3. Get your integration key
  4. Set the EBANX_INTEGRATION_KEY environment variable

Environment Variables

VariableRequiredDescription
EBANX_INTEGRATION_KEYYesIntegration key from EBANX dashboard
EBANX_SANDBOXNoSet to "true" for sandbox mode

Roadmap

v0.2 (planned)

  • create_subscription — Create a recurring subscription
  • cancel_payment — Cancel a pending payment
  • get_merchant_info — Get merchant account information
  • create_split — Create split payment rules

v0.3 (planned)

  • batch_payouts — Process multiple payouts in a single request
  • detailed_reports — Generate detailed financial reports

Want to contribute? Open a PR or request a tool.

Links

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/ebanx/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