mcp-getnet — Claude Code MCP server: setup
Connects an agent to Getnet for card payments, Pix, boleto, and marketplace splits. Built for workflows using the Brazilian acquirer.
claude mcp add --env GETNET_CLIENT_ID=<GETNET_CLIENT_ID> --env GETNET_CLIENT_SECRET=<GETNET_CLIENT_SECRET> --env GETNET_SELLER_ID=<GETNET_SELLER_ID> --env GETNET_BASE_URL=<GETNET_BASE_URL> --transport stdio getnet -- npx -y @codespar/mcp-getnetWhat mcp-getnet does
mcp-getnet exposes Getnet actions for credit and debit payments, Pix charges, and boleto charges. An agent can approve, capture, cancel, or refund credit payments, look up records by payment_id or merchant order_id, and request installment options. Card tokenization is available for later PCI-safe reuse.
Marketplace workflows include seller onboarding, seller lookup, seller lists, split configuration, and statement retrieval for sales, fees, and payouts. The server authenticates with OAuth 2.0 Client Credentials, calls POST /auth/oauth/v2/token, and keeps the bearer token in memory until it is close to expiry.
Set GETNET_CLIENT_ID, GETNET_CLIENT_SECRET, and GETNET_SELLER_ID before starting it; GETNET_BASE_URL can select another API endpoint. Getnet integrates directly for merchants with a Santander commercial contract, so that contract is a prerequisite for the intended setup.
What it helps with
- authorize a credit-card payment
- issue a Pix or boleto charge
- recover a payment from
order_id - onboard a marketplace seller
- route part of a payment to a subseller
Example prompts for the agent
- Authorize a card payment with
authorize_creditand report the returned payment details. - Create a Pix charge, then check its state with
query_pix. - Configure a marketplace split and retrieve the subseller entries with
get_statement.
How to install mcp-getnet
Platform CLI
claude mcp add --env GETNET_CLIENT_ID=<GETNET_CLIENT_ID> --env GETNET_CLIENT_SECRET=<GETNET_CLIENT_SECRET> --env GETNET_SELLER_ID=<GETNET_SELLER_ID> --env GETNET_BASE_URL=<GETNET_BASE_URL> --transport stdio getnet -- npx -y @codespar/mcp-getnetReplace <…> with your own values
Platform CLI
codex mcp add getnet --env GETNET_CLIENT_ID=<GETNET_CLIENT_ID> --env GETNET_CLIENT_SECRET=<GETNET_CLIENT_SECRET> --env GETNET_SELLER_ID=<GETNET_SELLER_ID> --env GETNET_BASE_URL=<GETNET_BASE_URL> -- npx -y @codespar/mcp-getnetReplace <…> with your own values
Config file
{
"mcpServers": {
"getnet": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-getnet"
],
"env": {
"GETNET_CLIENT_ID": "<GETNET_CLIENT_ID>",
"GETNET_CLIENT_SECRET": "<GETNET_CLIENT_SECRET>",
"GETNET_SELLER_ID": "<GETNET_SELLER_ID>",
"GETNET_BASE_URL": "<GETNET_BASE_URL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"getnet": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-getnet"
],
"env": {
"GETNET_CLIENT_ID": "<GETNET_CLIENT_ID>",
"GETNET_CLIENT_SECRET": "<GETNET_CLIENT_SECRET>",
"GETNET_SELLER_ID": "<GETNET_SELLER_ID>",
"GETNET_BASE_URL": "<GETNET_BASE_URL>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e GETNET_CLIENT_ID=<GETNET_CLIENT_ID> -e GETNET_CLIENT_SECRET=<GETNET_CLIENT_SECRET> -e GETNET_SELLER_ID=<GETNET_SELLER_ID> -e GETNET_BASE_URL=<GETNET_BASE_URL> getnet npx -y @codespar/mcp-getnetReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-getnet
How do I install mcp-getnet in Claude Code?
Run `claude mcp add mcp-getnet -e GETNET_CLIENT_ID=<GETNET_CLIENT_ID> -e GETNET_CLIENT_SECRET=<GETNET_CLIENT_SECRET> -e GETNET_SELLER_ID=<GETNET_SELLER_ID> -- npx -y @codespar/mcp-getnet`.
What does mcp-getnet do?
It gives an agent Getnet tools for card payments, Pix, boleto, marketplace sellers, split rules, and statement records.
What credentials does mcp-getnet require?
Provide GETNET_CLIENT_ID, GETNET_CLIENT_SECRET, and GETNET_SELLER_ID. GETNET_BASE_URL lets you set the API endpoint.
