mcp-ebanx

@codespar/mcp-ebanx

面向 EBANX 的 MCP 服务——为拉丁美洲提供跨境支付

快速开始

Claude Desktop

添加到 ~/.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

添加到 .cursor/mcp.json 或 .vscode/mcp.json：

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

工具（18）

工具	用途
create_payment	在 EBANX 创建付款（boleto、信用卡、PIX 等）
get_payment	通过哈希获取付款详情
list_payments	按日期范围列出付款
refund	退款（全额或部分退款）
create_payout	向银行账户创建一笔付款
exchange_rate	获取货币对的当前汇率
get_banks	列出某个国家/地区可用的银行
query_payment_by_merchant_code	通过 merchant_payment_code 获取付款详情（哈希的替代方式）
capture_payment	捕获之前授权的信用卡付款（全额或部分金额）。
cancel_payment	通过哈希取消/作废待处理的付款（例如
create_mass_payout	创建批量付款——在单个批次请求中创建多笔付款。
get_payout	通过 external_reference 或 payout id 查询付款。
simulate_payment	在沙盒中模拟付款响应，但不保存数据（适用于集成测试）。
list_payment_methods	列出某个国家/地区可用的付款方式（支持哪些 payment_type_codes）。
create_card_token	将信用卡/借记卡令牌化，以便重复使用，无需再次收集卡片数据。
delete_card_token	删除之前存储的卡片令牌。
validate_document	根据校验和/格式规则验证拉丁美洲税务文件（巴西的 CPF/CNPJ、墨西哥的 RFC、阿根廷/秘鲁的 DNI）。
verify_notification	使用集成密钥验证 EBANX webhook 通知的 HMAC 签名。

身份验证

EBANX 使用在请求正文/查询参数中传递的集成密钥。

沙盒 / 测试

EBANX 提供沙盒 sandbox.ebanx.com。设置 EBANX_SANDBOX=true 即可使用。

获取凭据

1. 前往 EBANX Dashboard
2. 创建开发者账户
3. 获取集成密钥
4. 设置 EBANX_INTEGRATION_KEY 环境变量

环境变量

变量	必需	描述
EBANX_INTEGRATION_KEY	是	从 EBANX 控制面板获取的集成密钥
EBANX_SANDBOX	否	设置为 "true" 以启用沙盒模式

路线图

v0.2（计划中）

• create_subscription — 创建定期订阅
• cancel_payment — 取消待处理的付款
• get_merchant_info — 获取商户账户信息
• create_split — 创建分账规则

v0.3（计划中）

• batch_payouts — 在单个请求中处理多笔付款
• detailed_reports — 生成详细的财务报告

想要贡献？提交 PR 或申请工具。

链接

• EBANX 网站
• EBANX API 文档
• MCP Dev LATAM
• 落地页

企业版

需要为 Agent 付款提供治理、预算限额和审计跟踪？CodeSpar Enterprise 在这些 MCP 服务的基础上增加了策略引擎、付款路由和合规模板。

许可证

MIT