About mcp-getnet
@codespar/mcp-getnet is an MCP server for Getnet, a Brazilian card acquirer owned by Santander. It targets merchants with a Santander commercial contract who integrate directly with the acquirer rather than through a PSP. It covers credit, debit, Pix, boleto and marketplace split flows.
Key features
- 01Credit authorization, capture, cancel and refund
- 02Pix and boleto charge creation and queries
- 03Card tokenization and numtoken creation
- 04Marketplace seller onboarding and split rules
- 05Statement retrieval by order ID or payment ID
Use cases
- 01Accepting credit card and Pix payments through Getnet
- 02Onboarding sellers and configuring splits on a marketplace
- 03Reviewing a subseller's sales, fees and payouts over a date range
MCP support
The project runs as an MCP server that exposes 20 payment tools to MCP clients, over stdio or HTTP transport.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @codespar/mcp-getnetGETNET_CLIENT_IDGetnet OAuth client_idGETNET_CLIENT_SECRETSecretGetnet OAuth client_secretGETNET_SELLER_IDGetnet seller_id issued with your merchant contractGETNET_BASE_URLGetnet API base URL. Defaults to production (https://api.getnet.com.br). Use https://api-homologacao.getnet.com.br for sandbox.Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
20Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| amount | number | Yes | Amount in cents |
| credit | object | Yes | Card data (pre-tokenized preferred via number_token) |
| credit.brand | string | Yes | Visa, Mastercard, Elo, Amex, Hipercard |
| credit.number_token | string | Yes | Token from tokenize_card |
| credit.security_code | string | Yes | |
| credit.save_card_data | boolean | No | |
| credit.cardholder_name | string | Yes | |
| credit.expiration_year | string | Yes | |
| credit.soft_descriptor | string | No | |
| credit.expiration_month | string | Yes | |
| credit.transaction_type | enum | No | FULL | INSTALL_NO_INTEREST | INSTALL_WITH_INTEREST |
| credit.number_installments | number | No | |
| delayed | boolean | Yes | true = authorize only; false = authorize + capture |
| currency | string | No | ISO-4217 currency code (default BRL) |
| customer | object | Yes | Customer identity |
| customer.name | string | No | |
| customer.email | string | Yes | |
| customer.last_name | string | Yes | |
| customer.first_name | string | Yes | |
| customer.customer_id | string | Yes | Merchant-side customer id |
| customer.phone_number | string | No | |
| customer.document_type | enum | Yes | CPF | CNPJ |
| customer.document_number | string | Yes | CPF or CNPJ digits only |
| order_id | string | Yes | Merchant-side order identifier |
Details
From the project 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)
| 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. |
Install
npm install @codespar/mcp-getnet
Environment
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
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
# stdio (default)
npx @codespar/mcp-getnet
# HTTP
MCP_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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.