@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:

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

Claude Code

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

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.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

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

| 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.

Links

• EBANX Website
• EBANX API Documentation
• MCP Dev Brasil
• Landing Page

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