About mcp-rede
mcp-rede is an MCP server for Rede, a Brazilian card acquirer owned by Itaú. It covers credit and debit authorization, capture and refunds, plus zero-auth, card tokens, recurrences and 3DS. It is intended for merchants with an Itaú contract who integrate directly with eRede.
Key features
- 01Credit and debit authorization, capture, void and refund
- 02Zero-auth card validation
- 03Card tokenization and token metadata lookup
- 04Recurrence (subscription) management
- 053DS authentication flow
- 06Boleto issuance, lookup and cancellation
Use cases
- 01Creating and managing recurring charges for subscriptions
- 02Validating a customer card before authorization
- 03Submitting authorizations after a successful 3DS check
MCP support
The server exposes 22 tools to MCP clients for Rede transactions, tokens, recurrences, 3DS and boleto operations.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @codespar/mcp-redeREDE_PVRede merchant filiação (PV) — numeric merchant identifier issued with your commercial contract.REDE_TOKENSecretRede API security token paired with PV. Used in HTTP Basic auth as the password.REDE_ENVEnvironment selector: 'sandbox' (default) or 'production'.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
22Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| urls | array | No | Optional callback/notification URL objects ({ url, kind }) |
| amount | number | Yes | Amount in cents |
| capture | boolean | Yes | true = authorize + capture; false = authorize only |
| reference | string | Yes | Merchant-side order reference (unique per merchant) |
| cardNumber | string | No | PAN; never log this value. Prefer storageCard (token) instead. |
| storageCard | string | No | Token from tokenize_card (alternative to cardNumber) |
| installments | number | Yes | Number of installments (1 for à vista) |
| securityCode | string | No | CVV |
| subscription | boolean | No | Flag as a recurring charge (MIT) |
| cardHolderName | string | No | Name on card |
| expirationYear | number | No | Expiration year (4 digits) |
| softDescriptor | string | No | Statement descriptor shown on the cardholder bill |
| expirationMonth | number | No | Expiration month (1-12) |
Details
From the project README@codespar/mcp-rede
MCP server for Rede — Itaú-owned Brazilian card acquirer.
Rede closes the "big four" BR acquirer quadrant alongside Cielo, Stone, and Getnet. Merchants with an Itaú commercial contract integrate directly via eRede instead of going through a PSP.
Tools (22)
| Tool | Purpose |
|---|---|
authorize_transaction | Authorize a credit card transaction on Rede. |
capture_transaction | Capture a previously authorized transaction (when capture=false was used). |
cancel_transaction | Cancel an authorized-but-uncaptured transaction (void). |
refund_transaction | Refund a captured transaction. |
get_transaction | Retrieve a transaction by Rede tid OR by merchant reference. |
zero_auth | Validate a card without charging (zero-auth / account verification). |
tokenize_card | Tokenize a card for PCI-safe reuse. |
delete_token | Delete a previously created card token. |
create_recurrence | Create a native Rede recurrence (subscription). |
get_recurrence | Retrieve a recurrence by Rede recurrence id. |
disable_recurrence | Disable (cancel) an active recurrence. |
authorize_debit | Authorize a debit card transaction on Rede. |
list_transactions | List transactions in a date range. |
get_token | Retrieve metadata for a previously stored card token (brand, last 4, expiration). |
update_recurrence | Update an existing recurrence — change amount, card (storageCard), end date, or pause/resume. |
get_recurrence_transactions | List transactions generated by a recurrence (one row per billing cycle executed). |
authenticate_3ds | Initiate a 3DS (EMV 3-D Secure) authentication for a card charge. |
get_3ds_status | Check the current status of a 3DS authentication by its reference id. |
authorize_with_3ds | Authorize a transaction after a successful 3DS authentication, attaching the 3DS reference for liability sh... |
create_boleto | Issue a boleto registrado via Rede. |
get_boleto | Retrieve a boleto by Rede boleto id or by merchant reference. |
cancel_boleto | Cancel an unpaid boleto. |
Install
npm install @codespar/mcp-rede@alpha
Environment
REDE_PV="..." # Merchant filiação (PV)
REDE_TOKEN="..." # Security token (paired with PV)
REDE_ENV="sandbox" # Optional. 'sandbox' (default) or 'production'
Authentication
HTTP Basic auth with base64(PV:TOKEN). The server builds the Authorization header on every request — transparent to callers.
Base URLs
- Production:
https://api.userede.com.br/erede/v1 - Sandbox:
https://sandbox-erede.useredecloud.com.br/v1
Run
# stdio (default)
npx @codespar/mcp-rede
# HTTP
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-rede
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.