mcp-pagar-me

@codespar/mcp-pagar-me

Pagar.me 的 MCP 服务——Stone 生态系统支付，支持订单、扣款和分账

快速开始

Claude Desktop

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

{
  "mcpServers": {
    "pagar-me": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-pagar-me"],
      "env": {
        "PAGARME_API_KEY": "sk_your-key"
      }
    }
  }
}

Claude Code

claude mcp add pagar-me -- npx @codespar/mcp-pagar-me

Cursor / VS Code

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

{
  "servers": {
    "pagar-me": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-pagar-me"],
      "env": {
        "PAGARME_API_KEY": "sk_your-key"
      }
    }
  }
}

工具（22）

工具	用途
create_order	在 Pagar.me 创建包含商品和付款的订单
get_order	根据 ID 获取订单详情
list_orders	列出订单，可选筛选条件
create_charge	创建扣款（Pix、boleto 或信用卡）
get_charge	根据 ID 获取扣款详情
create_recipient	创建分账收款方
get_balance	获取当前账户余额
create_transfer	向收款方转账
refund	退款（全额或部分退款）
list_recipients	列出收款方，可选筛选条件
create_anticipation	为收款方申请应收款提前结算（antecipação）
get_anticipation	根据 ID 获取提前结算详情
get_anticipation_limits	获取收款方可用的提前结算额度
create_plan	创建订阅计划
update_plan	更新现有订阅计划
create_subscription	为客户创建周期性订阅
cancel_subscription	取消周期性订阅
create_card_token	将信用卡令牌化（符合 PCI 安全要求）。
create_withdrawal	创建提现（saque），将收款方余额转入其登记的银行账户
register_webhook	注册 Webhook 端点以接收事件通知
capture_charge	捕获预授权扣款（先授权后捕获流程）。
partial_refund	退还部分扣款金额（明确进行部分退款；

身份验证

Pagar.me 使用 Basic Auth，用户名为密钥（sk_xxx），密码为空。

沙盒 / 测试

Pagar.me 可通过控制面板启用测试模式。使用测试模式 API 密钥可避免产生真实扣款。

获取凭据

1. 前往 Pagar.me 控制面板
2. 创建账户
3. 获取密钥（测试模式使用 sk_test_xxx）
4. 设置 PAGARME_API_KEY 环境变量

环境变量

变量	必填	说明
PAGARME_API_KEY	是	Pagar.me 控制面板中的密钥（sk_xxx）
PAGARME_PUBLIC_KEY	否	仅供 create_card_token 使用的公钥（pk_xxx）

路线图

v0.3（计划中）

• list_charges — 列出扣款并应用筛选条件
• list_subscriptions — 列出订阅
• list_plans — 列出计划
• batch_charges — 在单个请求中创建多笔扣款
• list_webhooks / delete_webhook — 完整的 Webhook 管理

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

链接

• Pagar.me 网站
• Pagar.me API 文档
• MCP Dev LATAM
• 落地页

企业版

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

许可证

MIT