Mcp Getnet

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

MCP server for Getnet — Santander-owned BR acquirer: credit, debit, Pix, boleto, marketplace split

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

概览

AI 生成的概览

面向巴西收单机构 Getnet 的本地 MCP 服务器，让助手授权、捕获、退款和查询信用卡、Pix 与 boleto 支付，并管理商户。

可以做什么
授权、捕获、取消和退款信用卡支付，按支付 ID 取消借记卡支付，并对卡片进行令牌化或创建 numtoken 以便重复使用。创建和查询 Pix 与 boleto 收款，取消未支付的 boleto，并按 Getnet 支付 ID 或商户订单 ID 查询支付。按金额和卡品牌查询分期方案。入驻、查询和列出市场商户，配置将部分款项分给子商户的分账规则，并按日期范围获取市场对账单条目。
适用场景
适合与 Santander/Getnet 签有商业合同的商户，希望助手直接通过收单机构而非 PSP 处理支付操作，包括 Pix、boleto、卡支付流程以及市场商户分账与对账。
运行要求
以 npm 包形式在本地通过 stdio 运行，需要 Node.js。需要 Getnet OAuth 凭据 GETNET_CLIENT_ID 和 GETNET_CLIENT_SECRET，以及商户合同中的 GETNET_SELLER_ID。GETNET_BASE_URL 可选，默认生产环境，也可使用沙箱地址。需要访问 Getnet API 的网络连接。
安装前请注意
该服务器涉及真实资金：授权、捕获、退款、取消支付以及创建 Pix 或 boleto 收款都是实际金融操作。它需要 OAuth 密钥 GETNET_CLIENT_SECRET 和商户标识，请避免写入日志或共享配置。测试时应将 GETNET_BASE_URL 指向沙箱。卡片令牌化和 numtoken 创建会处理卡数据，使用前请确认 PCI 合规义务。

安装

在 SourceWeft 中

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

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

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@codespar/mcp-getnet

MCP server for Getnet — Santander-owned Brazilian card acquirer.

Together with Cielo, Stone, and Efi, Getnet closes three of the "big four" BR acquirer quadrant. Distinct from per-PSP servers (Zoop, Pagar.me, Asaas): Getnet is an acquirer, so merchants with a Santander commercial contract integrate directly instead of going through a PSP.

Tools (20)

ToolPurpose
authorize_creditAuthorize a credit-card payment on Getnet.
capture_creditCapture a previously authorized credit payment (when delayed=true was used).
cancel_creditCancel an authorized-but-uncaptured credit payment.
refund_creditRefund a captured credit payment.
create_pixCreate a Pix charge.
create_boletoCreate a boleto charge.
get_paymentRetrieve a payment by Getnet payment_id.
tokenize_cardTokenize a card for PCI-safe reuse.
create_sellerOnboard a marketplace seller via Getnet Marketplace Management.
get_sellerRetrieve a seller by Getnet seller_id.
list_sellersList marketplace sellers with optional filters.
cancel_debitCancel a debit-card payment by Getnet payment_id.
query_pixRetrieve a Pix charge by Getnet payment_id.
query_boletoRetrieve a boleto by Getnet payment_id.
cancel_boletoCancel a boleto that has not yet been paid.
get_payment_by_orderRetrieve a payment using the merchant-side order_id (handy when you've lost the Getnet payment_id).
query_installmentsQuery the installment plans Getnet offers for a given amount + card brand (with/without interest, max insta...
create_numtokenCreate a numtoken (Getnet card-on-file PAN-level token).
create_splitConfigure a marketplace split rule that routes part of a payment to a subseller.
get_statementRetrieve marketplace statement entries (sales, fees, payouts) for a subseller in a date range.

Install

bash
npm install @codespar/mcp-getnet

Environment

bash
GETNET_CLIENT_ID="..."       # OAuth client_idGETNET_CLIENT_SECRET="..."   # OAuth client_secretGETNET_SELLER_ID="..."       # seller_id from your merchant contractGETNET_BASE_URL="..."        # Optional. Default: https://api.getnet.com.br                             # Sandbox: https://api-homologacao.getnet.com.br

Authentication

OAuth 2.0 Client Credentials. The server calls POST /auth/oauth/v2/token with Basic auth and caches the bearer token in memory until 60s before expiry. Transparent to callers.

Run

bash
# stdio (default)npx @codespar/mcp-getnet
# HTTPMCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-getnet

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/getnet/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 分