Mcp Ebanx

io.github.codespar由 GitHub 账号 codespar 发布v0.2.2更新于 Oct 24, 2026

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

已验证STDIO仅桌面金融商业与电商

概览

AI 生成的概览

面向拉美 EBANX 跨境支付的本地 MCP 服务器，让助手创建、查询、捕获、取消和退款支付与打款。

可以做什么
创建、捕获、取消和退款支付，按哈希或商户代码查询支付，或按日期范围列出支付，并可在沙箱中模拟支付、按国家列出支付方式。创建单笔或批量打款到银行账户，并按参考号或 ID 查询打款。查询货币对的汇率，并列出某国家可用的银行。对银行卡进行令牌化或删除已存储的卡令牌。校验 CPF、CNPJ、RFC、DNI 等拉美税号，并验证 webhook 通知签名。
适用场景
适合助手需要处理拉美电商的 EBANX 支付业务时使用：创建或查看支付、发起退款或打款、查询汇率和银行，或在 EBANX 沙箱中测试集成。
运行要求
通过 npx 从 npm 包 @codespar/mcp-ebanx 在本地运行，需要 Node.js。需要在 EBANX_INTEGRATION_KEY 环境变量中提供 EBANX 集成密钥，可从 EBANX 开发者账户获取。可选将 EBANX_SANDBOX 设为 true 以使用沙箱。需要访问 EBANX 的网络连接。
安装前请注意
集成密钥属于支付凭证，应避免写入共享配置或日志。工具可操作真实资金：create_payment、create_payout、create_mass_payout、capture_payment 和 refund 会执行金融操作，cancel_payment 和 delete_card_token 会更改或删除数据。建议先在沙箱测试。卡令牌化涉及敏感卡片数据，支付与打款信息会发送给 EBANX。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mcp Ebanx，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

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

来源：packages/payments/ebanx/README.md，提交 d0a519a

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.2.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分