mcpField
M
mcp-pagseguro

mcp-pagseguro

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

关于 mcp-pagseguro

mcp-pagseguro 是面向 PagSeguro/PagBank 支付平台的 MCP 服务，提供订单、收费、Pix、boleto 和信用卡支付等 24 个工具。适合需要在巴西支付场景中由 AI 助手或 Agent 调用支付接口的开发者。

主要功能

  1. 01提供 24 个支付相关工具
  2. 02覆盖订单、收费、Pix 与 boleto
  3. 03支持退款、部分退款与争议查询
  4. 04支持订阅、分账与 Webhook 管理
  5. 05支持 sandbox 沙箱测试环境

适用场景

  1. 01通过 Agent 创建 Pix 或 boleto 订单
  2. 02查询订单与收费状态并处理退款
  3. 03在沙箱中测试支付流程

MCP 相关

该项目是 MCP 服务，向 MCP 客户端暴露 PagSeguro 的支付接口作为工具。

配置

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

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

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

安装包
npm@codespar/mcp-pagseguro0.2.2

工具

24

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

参数类型必填说明
itemsarray是订单商品
chargesarray否付款费用（Pix、boleto 或银行卡）
customerobject是客户数据
customer.namestring是客户名称
customer.emailstring是邮箱地址
customer.tax_idstring是CPF 或 CNPJ（仅数字）
reference_idstring否你的唯一参考 ID

详细介绍

@codespar/mcp-pagseguro

PagSeguro/PagBank 的 MCP 服务 — 订单、扣款、Pix、boleto 和信用卡支付

npm License: MIT

快速开始

Claude Desktop

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

{
  "mcpServers": {
    "pagseguro": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-pagseguro"],
      "env": {
        "PAGSEGURO_TOKEN": "your-token",
        "PAGSEGURO_SANDBOX": "true"
      }
    }
  }
}
Claude Code
claude mcp add pagseguro -- npx @codespar/mcp-pagseguro
Cursor / VS Code

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

{
  "servers": {
    "pagseguro": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-pagseguro"],
      "env": {
        "PAGSEGURO_TOKEN": "your-token",
        "PAGSEGURO_SANDBOX": "true"
      }
    }
  }
}

工具（24 个）

工具用途
create_order在 PagSeguro 创建订单（Pix、boleto 或信用卡）
get_order按 ID 获取订单详情
list_orders列出订单，可选使用筛选条件
create_charge创建独立扣款
refund退还扣款（全额或部分）
get_pix_qrcode获取订单扣款的 Pix 二维码数据和图像
create_customer在 PagSeguro 创建客户
get_balance获取账户余额
create_subscription在 PagSeguro 创建定期订阅方案
list_subscriptions列出订阅，可选使用筛选条件
get_notifications按通知代码获取付款通知详情
create_split为市场交易创建分账配置
get_dispute按 ID 获取争议/拒付详情
pay_order支付现有订单（为处于 CREATED 状态的订单添加扣款/付款）
get_charge按 ID 获取扣款详情
list_charges列出扣款，可选使用筛选条件
capture_charge扣取一笔已预授权的信用卡扣款
cancel_charge取消尚未结算的扣款
create_boleto创建 boleto 扣款
get_boleto按 ID 获取 boleto 扣款详情
get_public_keys获取用于加密卡数据的 PagSeguro 公钥（类型：card）
create_payout向银行账户或 Pix 密钥创建一笔付款/转账
create_webhook注册应用的 webhook URL，以接收事件通知
list_webhooks列出已注册的应用 webhook

身份验证

PagSeguro 使用 Bearer 令牌进行身份验证。请从 PagBank 开发者门户生成令牌。

沙盒 / 测试

PagSeguro 提供沙盒 sandbox.api.pagseguro.com。设置 PAGSEGURO_SANDBOX=true 即可使用。

获取凭据
  1. 前往 PagBank 开发者门户
  2. 创建开发者账户
  3. 生成 API 令牌
  4. 设置 PAGSEGURO_TOKEN 环境变量

环境变量

变量必填描述
PAGSEGURO_TOKEN是来自 PagBank 的 Bearer 令牌
PAGSEGURO_SANDBOX否设置为 "true" 以启用沙盒模式

路线图

v0.2（计划中）
  • create_subscription — 创建定期订阅
  • list_subscriptions — 列出所有订阅，可使用筛选条件
  • get_notifications — 获取付款通知/webhook
  • create_split — 在收款方之间创建分账付款
  • get_dispute — 获取争议/拒付详情
v0.3（计划中）
  • create_plan — 创建订阅方案
  • get_installments — 获取付款的分期选项
  • batch_refunds — 在单个请求中处理多笔退款

想要参与贡献？提交 PR 或申请添加工具。

链接

企业版

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

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

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

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