io.github.codespar/mcp-getnet (MCP Server for Getnet)

MCP server for Getnet, a Santander-owned Brazilian card acquirer. It supports payments covering credit and debit cards, Pix, boleto, and marketplace split use cases, based on the server’s description. The server is listed with MCP tool availability, including credit authorization and capture.

🛠️ Key Features

MCP server for Getnet
Santander-owned Brazilian acquirer
Payments include credit, debit, Pix, boleto, and marketplace split

🚀 Use Cases

Merchant integration with Getnet via Santander commercial contract
Credit-card workflows: authorize and later capture payments
Marketplace split scenarios

⚡ Developer Benefits

Provides dedicated MCP tools for payment actions
Includes tool list (20 tools referenced), such as authorize_credit and capture_credit

⚠️ Limitations

The excerpt only clearly describes credit authorization/capture and does not enumerate all other tools in detail

Topics

agentic-commerce, ai-agents, brazil, claude, fintech, latin-america, llm-tools, mcp, model-context-protocol, nfe, open-finance, payments, pix

@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)

Tool

Purpose

authorize_credit

Authorize a credit-card payment on Getnet.

capture_credit

Capture a previously authorized credit payment (when delayed=true was used).

cancel_credit

Cancel an authorized-but-uncaptured credit payment.

refund_credit

Refund a captured credit payment.

create_pix

Create a Pix charge.

create_boleto

Create a boleto charge.

get_payment

Retrieve a payment by Getnet payment_id.

tokenize_card

Tokenize a card for PCI-safe reuse.

create_seller

Onboard a marketplace seller via Getnet Marketplace Management.

get_seller

Retrieve a seller by Getnet seller_id.

list_sellers

List marketplace sellers with optional filters.

cancel_debit

Cancel a debit-card payment by Getnet payment_id.

query_pix

Retrieve a Pix charge by Getnet payment_id.

query_boleto

Retrieve a boleto by Getnet payment_id.

cancel_boleto

Cancel a boleto that has not yet been paid.

get_payment_by_order

Retrieve a payment using the merchant-side order_id (handy when you've lost the Getnet payment_id).

query_installments

Query the installment plans Getnet offers for a given amount + card brand (with/without interest, max insta...

create_numtoken

Create a numtoken (Getnet card-on-file PAN-level token).

create_split

Configure a marketplace split rule that routes part of a payment to a subseller.

get_statement

Retrieve marketplace statement entries (sales, fees, payouts) for a subseller in a date range.

Environment

bash

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

Install

Configuration

Environment variables

GETNET_CLIENT_IDrequired

Getnet OAuth client_id

GETNET_CLIENT_SECRETrequiredsecret

Getnet OAuth client_secret

GETNET_SELLER_IDrequired

Getnet seller_id issued with your merchant contract

GETNET_BASE_URL

Getnet API base URL. Defaults to production (https://api.getnet.com.br). Use https://api-homologacao.getnet.com.br for sandbox.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-getnet": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-getnet@0.2.2"
      ],
      "env": {
        "GETNET_CLIENT_ID": "<YOUR_GETNET_CLIENT_ID>",
        "GETNET_CLIENT_SECRET": "<YOUR_GETNET_CLIENT_SECRET>",
        "GETNET_SELLER_ID": "<YOUR_GETNET_SELLER_ID>",
        "GETNET_BASE_URL": "<YOUR_GETNET_BASE_URL>"
      }
    }
  }
}

io.github.codespar/mcp-getnet