@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