Mcp Getnet

io.github.codesparPublished by GitHub account codesparv0.2.2Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Local MCP server for the Getnet Brazilian acquirer, letting an assistant authorize, capture, refund and query card, Pix and boleto payments and manage sellers.

What you can do
Authorize, capture, cancel and refund credit-card payments, and cancel debit payments by payment ID, plus tokenize cards and create numtokens for card-on-file reuse. Create and query Pix and boleto charges, cancel unpaid boletos, and look up payments by Getnet payment ID or merchant order ID. Query installment plans for an amount and card brand. Onboard, retrieve and list marketplace sellers, configure split rules that route part of a payment to a subseller, and pull marketplace statement entries for a date range.
When to use it
Useful when a merchant with a Santander/Getnet commercial contract wants an assistant to handle payment operations directly through the acquirer rather than a PSP, including Pix, boleto, card flows and marketplace seller splits and statements.
Requirements
Runs locally as an npm package over stdio (Node.js required). Needs Getnet OAuth credentials in GETNET_CLIENT_ID and GETNET_CLIENT_SECRET, plus GETNET_SELLER_ID from the merchant contract. GETNET_BASE_URL is optional and defaults to production; a sandbox URL is available. Network access to the Getnet API is required.
Before you install
This server moves real money: authorizing, capturing, refunding and cancelling payments and creating Pix or boleto charges are live financial actions. It requires the OAuth secret GETNET_CLIENT_SECRET and merchant identifiers, so keep them out of logs and shared configs. Point GETNET_BASE_URL at the sandbox while testing. Card tokenization and numtoken creation handle card data, so review PCI obligations before use.

Installation

In SourceWeft

  1. Open Mcp Getnet in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

Source: packages/payments/getnet/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts