mcp-getnet

@codespar/mcp-getnet

适用于 Getnet 的 MCP 服务——归 Santander 所有的巴西银行卡收单机构。

与 Cielo、Stone 和 Efi 一起，Getnet 补齐了巴西收单机构领域「四大」中的三席。与面向单个支付服务提供商（PSP）的服务端（Zoop、Pagar.me、Asaas）不同，Getnet 是收单机构，因此，与 Santander 签有商业合同的商户可以直接集成，无需通过 PSP。

工具（20 个）

工具	用途
authorize_credit	在 Getnet 上授权信用卡付款。
capture_credit	扣款此前已授权的信用卡付款（使用了 delayed=true 时）。
cancel_credit	取消已授权但尚未扣款的信用卡付款。
refund_credit	退还已扣款的信用卡付款。
create_pix	创建 Pix 收款。
create_boleto	创建 boleto 收款。
get_payment	根据 Getnet payment_id 检索付款。
tokenize_card	对银行卡进行令牌化，以便安全地重复使用，符合 PCI 要求。
create_seller	通过 Getnet Marketplace Management 开通市场卖家。
get_seller	根据 Getnet seller_id 检索卖家。
list_sellers	列出市场卖家，并支持可选筛选条件。
cancel_debit	根据 Getnet payment_id 取消借记卡付款。
query_pix	根据 Getnet payment_id 检索 Pix 收款。
query_boleto	根据 Getnet payment_id 检索 boleto。
cancel_boleto	取消尚未支付的 boleto。
get_payment_by_order	使用商户端的 order_id 检索付款（在丢失 Getnet payment_id 时很有用）。
query_installments	查询 Getnet 针对指定金额和银行卡品牌提供的分期方案（有息／无息，最高分...
create_numtoken	创建 numtoken（Getnet 卡片文件 PAN 级令牌）。
create_split	配置市场分账规则，将部分款项转给子卖家。
get_statement	检索日期范围内某个子卖家的市场账单条目（销售额、费用、付款）。

安装

npm install @codespar/mcp-getnet

环境

GETNET_CLIENT_ID="..."       # OAuth client_id
GETNET_CLIENT_SECRET="..."   # OAuth client_secret
GETNET_SELLER_ID="..."       # seller_id from your merchant contract
GETNET_BASE_URL="..."        # Optional. Default: https://api.getnet.com.br
                             # Sandbox: https://api-homologacao.getnet.com.br

身份验证

OAuth 2.0 客户端凭据。服务端使用 Basic 身份验证调用 POST /auth/oauth/v2/token，并在内存中缓存 bearer 令牌，直至其过期前 60 秒。调用方无需处理这些细节。

运行

# stdio (default)
npx @codespar/mcp-getnet

# HTTP
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-getnet

企业版

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

许可证

MIT