mcpField
M
mcp-zoop

mcp-zoop

本地服务
github.com/codespar金融数据2754 周前更新
代码仓库

关于 mcp-zoop

mcp-zoop 是 Zoop 市场支付平台的 MCP 服务，可让 MCP 客户端处理交易、分账规则、卖家、买家、转账和订阅等操作。适合需要在市场场景中进行支付分账的开发者。

主要功能

  1. 01创建 Pix、boleto 及信用卡交易
  2. 02按分账规则在卖家之间分配付款
  3. 03管理卖家、买家及银行账户
  4. 04查询余额、应收款项和转账记录
  5. 05处理退款、争议及定期订阅

适用场景

  1. 01在市场平台中为多个卖家分配交易款项
  2. 02通过 AI 助手查询交易与转账状态
  3. 03管理定期订阅及处理争议记录

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "codespar-mcp-zoop": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-zoop"
      ],
      "env": {
        "ZOOP_API_KEY": "<ZOOP_API_KEY>"
      }
    }
  }
}
启动命令npx -y @codespar/mcp-zoop
需要配置的环境变量
ZOOP_API_KEY密钥API key for zoop

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@codespar/mcp-zoop0.1.4

工具

28

收录的工具列表 · 更新于 2 周前

参数类型必填说明
tokenstring否银行卡令牌（用于信用卡/借记卡）
amountnumber是以分为单位的金额（BRL）
currencystring否货币代码（BRL）
customerstring否买家 ID
descriptionstring否交易描述
on_behalf_ofstring是接收付款的卖家 ID
payment_typeenum是付款类型credit | debit | boleto | pix
payment_methodobject否付款方式详情（适用于 boleto/pix）
payment_method.expiration_datestring否到期日期（YYYY-MM-DD）
payment_method.body_instructionsstring否关于 boleto 正文的说明
installment_planobject否分期配置
installment_plan.modeenum否分期模式interest_free | with_interest
installment_plan.number_installmentsnumber否分期期数

详细介绍

@codespar/mcp-zoop

面向 Zoop 的 MCP 服务——支持拆分规则的市场平台支付

npm License: MIT

快速开始

Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "zoop": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-zoop"],
      "env": {
        "ZOOP_API_KEY": "your-key",
        "ZOOP_MARKETPLACE_ID": "your-marketplace-id"
      }
    }
  }
}
Claude Code
claude mcp add zoop -- npx @codespar/mcp-zoop
Cursor / VS Code

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

{
  "servers": {
    "zoop": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-zoop"],
      "env": {
        "ZOOP_API_KEY": "your-key",
        "ZOOP_MARKETPLACE_ID": "your-marketplace-id"
      }
    }
  }
}

工具（28 个）

工具用途
create_transaction在 Zoop 中创建交易（Pix、boleto 或信用卡）
get_transaction根据 ID 获取交易详情
list_transactions列出交易，可选择筛选条件
create_split_rule创建拆分规则，在卖家之间分配付款
create_seller在市场平台中创建卖家（个人或企业）
get_seller根据 ID 获取卖家详情
list_sellers列出市场平台中的卖家
create_buyer在市场平台中创建买家
get_balance获取卖家或市场平台的余额
create_transfer向卖家的银行账户创建转账
refund_transaction退款（全额或部分退款）
get_receivables获取交易的应收款项
create_token_card对信用卡进行令牌化，以便安全支付
create_bank_account为卖家创建银行账户令牌
get_seller_balance获取指定卖家的详细余额
update_seller更新卖家信息
list_transfers按筛选条件列出市场平台转账
get_transfer根据 ID 获取转账详情
create_subscription创建定期订阅
list_receivables列出市场平台的所有应收款项
create_pix_payment创建 PIX 付款交易
get_pix_payment获取 PIX 付款详情，包括二维码和可复制粘贴的付款内容
cancel_subscription取消定期订阅
list_subscriptions列出市场平台中的订阅
list_disputes列出市场平台中的争议／拒付
get_marketplace获取市场平台信息和设置
get_dispute根据 ID 获取争议详情
get_subscription根据 ID 获取订阅详情

身份验证

Zoop 使用 HTTP Basic 身份验证，将 API 密钥作为用户名，密码留空。

沙盒／测试

Zoop 提供可通过控制面板访问的沙盒环境。

获取凭据
  1. 前往 Zoop 文档
  2. 创建开发者账户
  3. 从控制面板获取 API 密钥和市场平台 ID
  4. 设置环境变量

环境变量

变量必需说明
ZOOP_API_KEY是Zoop 控制面板中的 API 密钥
ZOOP_MARKETPLACE_ID是市场平台 ID

路线图

v0.2（计划中）
  • get_dispute — 根据 ID 获取争议详情
  • respond_dispute — 提交证据以回应争议
  • list_plans — 列出所有订阅计划
  • update_subscription — 更新订阅详情
  • cancel_subscription — 取消有效订阅
v0.3（计划中）
  • batch_transfers — 在单个请求中处理多笔转账
  • detailed_reports — 生成详细财务报告
  • webhook_management — 注册、列出和删除 Webhook

想要贡献？提交 PR 或请求添加工具。

链接

企业版

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

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。