io.github.codespar/mcp-rede MCP Server

This Model Context Protocol (MCP) server provides payment and transaction tools for Rede, an Itaú-owned Brazilian card acquirer. It supports flows for authorizing, capturing, and canceling credit card transactions, and is described with “zero-auth” capabilities and card token handling. Rede is positioned as a “big four” BR acquirer alongside Cielo, Stone, and Getnet.

🛠️ Key Features

MCP server for Rede (Itaú-owned Brazilian acquirer)
Credit card transaction authorization
Capture of previously authorized transactions
Cancel authorized-but-uncaptured transactions
Card tokens and “zero-auth” mentioned in the description

🚀 Use Cases

Direct merchant integration via eRede for Itaú commercial contract holders
Authorize and then capture card payments using Rede workflows
Cancel pending/uncaptured authorization transactions

⚡ Developer Benefits

Standardized MCP tooling for Rede payments
Clear transaction lifecycle separation (authorize, capture, cancel)
Repo-structured tool catalog (“Tools (22)” referenced)

⚠️ Limitations

Source excerpt only lists three transaction tools explicitly; full tool set details are not provided.

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

Configuration

Environment variables

REDE_PVrequired

Rede merchant filiação (PV) — numeric merchant identifier issued with your commercial contract.

REDE_TOKENrequiredsecret

Rede API security token paired with PV. Used in HTTP Basic auth as the password.

REDE_ENV

Environment selector: 'sandbox' (default) or 'production'.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-rede": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-rede@0.2.0-alpha.3"
      ],
      "env": {
        "REDE_PV": "<YOUR_REDE_PV>",
        "REDE_TOKEN": "<YOUR_REDE_TOKEN>",
        "REDE_ENV": "<YOUR_REDE_ENV>"
      }
    }
  }
}

io.github.codespar/mcp-rede