Skip to main content
GE

Getnet

v0.2.1OAuth2

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

What your agent can do

Getnet gives your agent 20 tools it calls directly — pick the ones it needs, in Claude, Cursor, or any MCP client.

  • authorize_creditAuthorize a credit-card payment on Getnet. Set delayed=false to authorize+capture atomically; delayed=true to authorize only (use capture_credit later).
  • capture_creditCapture a previously authorized credit payment (when delayed=true was used).
  • cancel_creditCancel an authorized-but-uncaptured credit payment.
Example call
// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("authorize_credit", { /* ... */ });

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

Run `npx -y @codespar/mcp-getnet` and add the config block above to your MCP client — Claude, Cursor, VS Code, or any MCP-compatible client. No build step, no SDK required. Prefer hosted? CodeSpar's managed tier runs it for you with auth handled.
Getnet — MCP server · 20 tools | CodeSpar