Getnet

v0.2.0OAuth2

Santander-owned Brazilian acquirer — #3 BR and #1 BR ecommerce. Credit, debit, Pix, boleto + marketplace seller onboarding and split. Closes the big-four BR acquirer quadrant.

20 tools4 env vars🇧🇷 Brazilstable on npm

Install

terminal

$ npm install @codespar/mcp-getnet

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json

{
  "mcpServers": {
    "getnet": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-getnet"
      ],
      "env": {
        "GETNET_CLIENT_ID": "<your_getnet_client_id>",
        "GETNET_CLIENT_SECRET": "<your_getnet_client_secret>",
        "GETNET_SELLER_ID": "<your_getnet_seller_id>"
      }
    }
  }
}

After restart, your agent can call any of the 20 tools below — try authorize_credit first.

Environment variables · 4

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

GETNET_CLIENT_ID

required

Getnet OAuth client_id

GETNET_CLIENT_SECRET

requiredsecret

Getnet OAuth client_secret

GETNET_SELLER_ID

required

Getnet seller_id issued with your merchant contract

GETNET_BASE_URL

optional

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

Available tools · 20

Each tool is independent — your agent loads only what it needs to reduce context and response time.

WRITEauthorize_credit

Authorize a credit-card payment on Getnet. Set delayed=false to authorize+capture atomically; delayed=true to authorize only (use capture_credit later).

WRITEcapture_credit

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

DELETEcancel_credit

Cancel an authorized-but-uncaptured credit payment.

DELETErefund_credit

Refund a captured credit payment. Pass amount for a partial refund; omit for full.

WRITEcreate_pix

Create a Pix charge. Returns qr_code (image base64), qr_code_text (EMV copy-paste payload) and payment_id. Expires per Getnet defaults unless expires_in is set.

WRITEcreate_boleto

Create a boleto charge. Returns boleto PDF URL, barcode, and expiration date.

WRITEget_payment

Retrieve a payment by Getnet payment_id. Works for credit, debit, Pix, and boleto.

WRITEtokenize_card

Tokenize a card for PCI-safe reuse. Returns a number_token to pass into authorize_credit.credit.number_token.

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Claude Agent SDKAnthropic

OpenAI AgentsOpenAI

Vercel AI SDKVercel

LangChainLangChain

LlamaIndexLlamaIndex

CrewAICrewAI

MastraMastra

Any MCP clientProtocol

Frequently asked questions

All credentials are encrypted at rest in an isolated vault scoped per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets — it receives scoped, short-lived session tokens.