io.github.codespar/mcp-getnet
io.github.codespar/mcp-getnet · 273 stars · TypeScript · MIT
MCP server MCP server for Getnet — Santander-owned BR acquirer: credit, debit, Pix, boleto, marketplace split
Install
The repo has no one-line install. Follow its README.
Published as
- npm
@codespar/mcp-getnetstdio
From the server's entry in the official MCP Registry.
Configuration
| Name | Set as | What it is |
|---|---|---|
GETNET_CLIENT_IDRequired | Env var | Getnet OAuth client_id |
GETNET_CLIENT_SECRETRequired · Secret | Env var | Getnet OAuth client_secret |
GETNET_SELLER_IDRequired | Env var | Getnet seller_id issued with your merchant contract |
GETNET_BASE_URLOptional | Env var | Getnet API base URL. Defaults to production (https://api.getnet.com.br). Use https://api-homologacao.getnet.com.br for sandbox. |
Files
@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
Facts
- Kind
- MCP server
- Group
- Uncategorized
- Stars
- 273
- License
- MIT
- Language
- TypeScript
- Last push
- 2026-09-27
- Forks
- 50
- MCP Registry
- io.github.codespar/mcp-getnet
- Homepage
- codespar.dev/servers
- Topics
- agentic-commerce, ai-agents, brazil, claude, fintech, latin-america, llm-tools, mcp, model-context-protocol, nfe, open-finance, payments, pix
- 1REAio.github.morluto/reaReverse engineer anything from your terminal or agent with one CLI and MCP server.125.3k
- 2com.browser-use/browser-usecom.browser-use/browser-useControl a real Chrome browser to complete any task: fill forms, extract data, book flights.117.7k
- 3World Monitorapp.worldmonitor/mcpLive markets, conflicts, country risk, chokepoints, energy, and China decision signals. 93 tools.88.3k
- 4Scrapling MCP Serverd4vinci/scrapling🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scraplingdev86.9k
- 5Everythingmodelcontextprotocol/serversThis MCP server attempts to exercise all the features of the MCP protocol. It is not intended to be a useful server, but rather a test server for builders of MCP clients. It implements prompts, tools, resources, sampling, and more to showcase MCP capabilities.85.8k
- 6Fetchmodelcontextprotocol/serversA Model Context Protocol server that provides web content fetching capabilities. This server enables LLMs to retrieve and process content from web pages, converting HTML to markdown for easier consumption.85.8k
