Skip to main content
G

Getnet

@codespar/mcp-getnet · v0.2.2

🇧🇷 BrazilPaymentsAuth · OAuth2beta20 tools4 env vars

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.

Get started · freeView docs

MIT · runs locally with your own credentials

Limitations

  • Hosted calls with a test key are not available: the runtime has not recorded this provider's test behaviour (test venue unclassified).
Package
@codespar/mcp-getnet
Version
0.2.2
npm dist-tag
latest
Category
Payments
Auth
OAuth2
Country
🇧🇷 Brazil
License
MIT
Transport
stdio · streamable-http

Quickstart

Install, set the credentials, make the first call.

Pick your client. The server runs locally over stdio, with your own credentials.

Add the server to your clientOne config entry. No build step, no SDK required.
Set the environment variables4 variables read by this server's code, listed below.
Restart and make the first callThe agent can call any of the 20 tools. Try authorize_credit first.
terminal
# Claude Code claude mcp add getnet -e GETNET_BASE_URL=… -e GETNET_CLIENT_ID=… -e GETNET_CLIENT_SECRET=… -e GETNET_SELLER_ID=… -- npx -y @codespar/mcp-getnet@0.2.2 # then: /mcp to confirm the server is connected
Environment variables4 variables
GETNET_BASE_URLGetnet API base URL. Defaults to production (https://api.getnet.com.br). Use https://api-homologacao.getnet.com.br for sandbox.optional
GETNET_CLIENT_IDGetnet OAuth client_idrequired
GETNET_CLIENT_SECRETGetnet OAuth client_secretrequiredsecret
GETNET_SELLER_IDGetnet seller_id issued with your merchant contractrequired

Names read from the package code (@codespar/mcp-getnet@0.2.2). Descriptions and flags come from its manifest. Self-hosted, you hold the credentials.

First call demoauthorize_credit

"Authorize a credit-card payment on Getnet. Set delayed=false to authorize+capture atomically; delayed=true to authorize only"

tools/callauthorize_creditresult returned

Tools

What your agent can call.

20 tools, as the package's tools/list returns them.

authorize_credit

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

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. Pass amount for a partial refund; omit for full.

create_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.

create_boleto

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

get_payment

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

tokenize_card

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

create_seller

Onboard a marketplace seller via Getnet Marketplace Management. Required before routing split payments to a seller.

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.

Names and descriptions come from the package's tools/list (@codespar/mcp-getnet@0.2.2). A kind (read, write, delete) is shown only when the package annotates its tools or each tool was verified one by one; neither exists for this server yet.

Compatibility

MCP is a protocol. Any client that speaks it can mount this server.

codespar_discover lists this server's tools, but a project with a test key cannot call them yet: the runtime has not recorded what this provider does in test mode, and refuses rather than guess.

Protocol

Any MCP client

stdio · streamable-http

Questions

Before you install.

How do I install the Getnet MCP server?

Run npx -y @codespar/mcp-getnet@0.2.2 and add the config block above to your MCP client: Claude Code, Cursor, Claude Desktop, VS Code, or any MCP-compatible client. No build step, no SDK required.

What can my agent do with Getnet?

Getnet exposes 20 tools for payments. Your agent calls them directly; the full list is above.

How does Getnet authenticate, and how are credentials stored?

Getnet uses OAuth2. Self-hosted, you hold the credentials: the server reads them from its environment variables.

How does Getnet handle upstream API changes?

Every server is versioned independently on npm. The command on this page pins 0.2.2, the version whose tools are listed here; your agent keeps running it until you change the version.

Is Getnet open source? How do I report a bug?

Yes. Getnet is MIT-licensed and published on npm as @codespar/mcp-getnet, source on GitHub (link in the Details panel). Report issues on the package repository; security issues go to security@codespar.dev, and we respond within 24 hours.

Start in seconds.

Add the config above, set the variables, and your agent calls the tools.

Start in seconds demo
Add the server to your client with the config above.
Set the environment variables listed above.
Ask your agent for the first call.
Getnet — MCP server · 20 tools | CodeSpar