io.github.codespar/mcp-ebanx — MCP server for EBANX

This MCP server provides integration capabilities for EBANX, focused on cross-border payments in Latin America, including payouts and exchange rates. It is distributed as the @codespar/mcp-ebanx package and is intended for use with Model Context Protocol (MCP) clients.

🛠️ Key Features

EBANX support for cross-border payments
Payouts and exchange rates
MIT-licensed npm package: @codespar/mcp-ebanx

🚀 Use Cases

Building agentic-commerce workflows that need payments data
Enabling AI agents to work with fintech services in Brazil and Latin America
Integrating open-finance or payments systems via MCP

⚡ Developer Benefits

MCP-compatible tooling (topics include mcp and model-context-protocol)
CLI install/run via npx -y @codespar/mcp-ebanx
Configuration via environment variables (e.g., EBANX_INTEGRATION_KEY, EBANX_SANDBOX)

⚠️ Limitations

Requires EBANX integration credentials (EBANX_INTEGRATION_KEY) to operate
Sandbox behavior depends on EBANX_SANDBOX configuration

@codespar/mcp-ebanx

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

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)

Tool	Purpose
`create_payment`	Create a payment in EBANX (boleto, credit card, PIX, etc.)
`get_payment`	Get payment details by hash
`list_payments`	List payments by date range
`refund`	Refund a payment (full or partial)
`create_payout`	Create a payout to a bank account
`exchange_rate`	Get current exchange rate for a currency pair
`get_banks`	List available banks for a country
`query_payment_by_merchant_code`	Get payment details by merchant_payment_code (alternative to hash)
`capture_payment`	Capture a previously authorized credit card payment (full or partial).
`cancel_payment`	Cancel/void a pending payment by hash (e.g.
`create_mass_payout`	Create a mass payout — multiple payouts in a single batch request.
`get_payout`	Query a payout by external_reference or payout id.
`simulate_payment`	Simulate the response of a payment in sandbox without persisting it (useful for integration testing).
`list_payment_methods`	List available payment methods for a country (which payment_type_codes are supported).
`create_card_token`	Tokenize a credit/debit card for reuse without re-collecting card data.
`delete_card_token`	Delete a previously stored card token.
`validate_document`	Validate a LATAM tax document (CPF/CNPJ for BR, RFC for MX, DNI for AR/PE) using checksum/format rules.
`verify_notification`	Verify 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

Go to EBANX Dashboard
Create a developer account
Get your integration key
Set the EBANX_INTEGRATION_KEY environment variable

Environment Variables

Variable	Required	Description
`EBANX_INTEGRATION_KEY`	Yes	Integration key from EBANX dashboard
`EBANX_SANDBOX`	No	Set 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.

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

io.github.codespar/mcp-ebanx