feat(payments): add @codespar/mcp-getnet server

packages/payments/getnet/README.md

@@ -0,0 +1,55 @@
+# @codespar/mcp-getnet
+
+MCP server for [Getnet](https://developers.getnet.com.br) — 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
+
+| Tool | Purpose |
+|---|---|
+| `authorize_credit` | Authorize card payment (optional auto-capture) |
+| `capture_credit` | Capture previously authorized payment |
+| `cancel_credit` | Cancel authorized-but-uncaptured payment |
+| `refund_credit` | Full or partial refund |
+| `create_pix` | Create Pix charge, returns QR + copy-paste |
+| `create_boleto` | Create boleto charge |
+| `get_payment` | Retrieve any payment by id |
+| `tokenize_card` | PCI-safe card tokenization |
+| `create_seller` | Onboard a marketplace seller |
+| `get_seller` | Retrieve seller by id |
+| `list_sellers` | List marketplace sellers |
+
+## Install
+
+```bash
+npm install @codespar/mcp-getnet
+```
+
+## Environment
+
+```bash
+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
+
+```bash
+# stdio (default)
+npx @codespar/mcp-getnet
+
+# HTTP
+MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-getnet
+```
+
+## License
+
+MIT

packages/payments/getnet/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@codespar/mcp-getnet",
+  "version": "0.1.0",
+  "description": "MCP server for Getnet — Santander-owned Brazilian acquirer. Credit, debit, Pix, boleto + marketplace seller onboarding and split.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "mcp-getnet": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^5.8.0"
+  },
+  "license": "MIT",
+  "keywords": [
+    "mcp",
+    "getnet",
+    "santander",
+    "payments",
+    "pix",
+    "boleto",
+    "marketplace",
+    "brazil"
+  ],
+  "mcpName": "io.github.codespar/mcp-getnet"
+}

packages/payments/getnet/server.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.codespar/mcp-getnet",
+  "description": "MCP server for Getnet — Santander-owned Brazilian acquirer. Credit, debit, Pix, boleto + marketplace seller onboarding and split.",
+  "repository": {
+    "url": "https://github.com/codespar/mcp-dev-brasil",
+    "source": "github",
+    "subfolder": "packages/payments/getnet"
+  },
+  "version": "0.1.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@codespar/mcp-getnet",
+      "version": "0.1.0",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "name": "GETNET_CLIENT_ID",
+          "description": "Getnet OAuth client_id",
+          "isRequired": true,
+          "format": "string",
+          "isSecret": false
+        },
+        {
+          "name": "GETNET_CLIENT_SECRET",
+          "description": "Getnet OAuth client_secret",
+          "isRequired": true,
+          "format": "string",
+          "isSecret": true
+        },
+        {
+          "name": "GETNET_SELLER_ID",
+          "description": "Getnet seller_id issued with your merchant contract",
+          "isRequired": true,
+          "format": "string",
+          "isSecret": false
+        },
+        {
+          "name": "GETNET_BASE_URL",
+          "description": "Getnet API base URL. Defaults to production (https://api.getnet.com.br). Use https://api-homologacao.getnet.com.br for sandbox.",
+          "isRequired": false,
+          "format": "string",
+          "isSecret": false
+        }
+      ]
+    }
+  ]
+}