io.github.codespar/mcp-transbank (MCP Server)

This MCP server integrates Transbank payment products for use with Model Context Protocol (MCP). It targets Chile’s card acquiring setup and supports Webpay Plus and Webpay OneClick Mall. The server description emphasizes coverage for Chile within CodeSpar LatAm-related claims.

🛠️ Key Features

MCP server for Transbank: Webpay Plus and Webpay OneClick Mall
Webpay Plus: one-shot redirect payments using buy_order and amount
Webpay OneClick Mall: tokenized recurring / card-on-file payments, including splitting across multiple merchant codes

🚀 Use Cases

Enabling Chilean card payment flows in LLM-connected applications via MCP
Supporting both redirect-based checkout (Webpay Plus) and stored-card tokenized flows (Webpay OneClick Mall)

⚡ Developer Benefits

Clear mapping of Transbank offerings: Webpay Plus and OneClick Mall
Reusable payment integration endpoints aligned with MCP tooling expectations

⚠️ Limitations

Scope is limited to the two documented Transbank products (Webpay Plus, Webpay OneClick Mall)

@codespar/mcp-transbank

MCP server for Transbank — Chile's dominant card acquirer.

Transbank is effectively default for Chilean commerce (state-origin roots, owned by a consortium of Chilean banks). Shipping this server is a prerequisite for any "CodeSpar covers LatAm" claim that includes Chile.

Two products are covered:

Webpay Plus — one-shot redirect payments (buy_order + amount, user is redirected to Webpay to pay).

Webpay OneClick Mall — tokenized recurring / card-on-file payments that can split across multiple merchant codes (the "mall" model).

Tools (19)

Tool

Purpose

webpay_create_transaction

Create a Webpay Plus transaction.

webpay_commit_transaction

Commit a Webpay Plus transaction after the user has returned from the Webpay flow.

webpay_get_transaction_status

Get the current status of a Webpay Plus transaction by token.

webpay_refund_transaction

Refund a committed Webpay Plus transaction.

webpay_increase_amount

Capture a previously authorized Webpay Plus transaction (partial-capture / deferred-capture flow).

webpay_capture_transaction

Deferred-capture for a previously authorized Webpay Plus transaction.

webpay_mall_create_transaction

Create a Webpay Mall transaction — one parent buy_order split across several seller commerce codes.

webpay_mall_commit_transaction

Commit a Webpay Mall transaction after the user has returned.

webpay_mall_get_transaction_status

Get the status of a Webpay Mall transaction by token (includes per-child details).

webpay_mall_refund_transaction

Refund one child seller of a Webpay Mall transaction.

webpay_mall_capture_transaction

Deferred-capture for one child seller inside a Webpay Mall transaction.

oneclick_create_inscription

Start a OneClick Mall card-enrollment flow.

oneclick_finish_inscription

Finalize a OneClick Mall enrollment after the user has returned.

oneclick_delete_inscription

Delete (revoke) a stored OneClick Mall card for a user.

oneclick_authorize

Charge a stored OneClick Mall card across one or more mall merchant codes.

oneclick_capture

Capture a previously authorized OneClick Mall charge (deferred-capture flow).

oneclick_refund

Refund a OneClick Mall charge.

oneclick_status

Get the status of a OneClick Mall transaction by parent buy_order.

oneclick_get_transaction_by_buy_order

Look up a OneClick Mall transaction by parent buy_order.

Environment

bash

TRANSBANK_COMMERCE_CODE="..."   # merchant commerce code (Tbk-Api-Key-Id)
TRANSBANK_API_KEY_SECRET="..."  # secret key (Tbk-Api-Key-Secret)
TRANSBANK_ENV="integration"     # 'integration' (default) or 'production'

Integration base URL: https://webpay3gint.transbank.cl Production base URL: https://webpay3g.transbank.cl

OneClick Mall flow

Call oneclick_create_inscription with username, email, response_url. Redirect user to url_webpay.

After user returns, call oneclick_finish_inscription. Store the returned tbk_user against your user.

To charge later, call oneclick_authorize with username, tbk_user, a parent mall buy_order, and a details array (one entry per child merchant).

Install

Configuration

Environment variables

TRANSBANK_COMMERCE_CODErequired

Transbank merchant commerce code (sent as Tbk-Api-Key-Id header)

TRANSBANK_API_KEY_SECRETrequiredsecret

Transbank API secret key (sent as Tbk-Api-Key-Secret header)

TRANSBANK_ENV

Environment: 'integration' (default, https://webpay3gint.transbank.cl) or 'production' (https://webpay3g.transbank.cl)

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-transbank": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-transbank@0.2.0-alpha.3"
      ],
      "env": {
        "TRANSBANK_COMMERCE_CODE": "<YOUR_TRANSBANK_COMMERCE_CODE>",
        "TRANSBANK_API_KEY_SECRET": "<YOUR_TRANSBANK_API_KEY_SECRET>",
        "TRANSBANK_ENV": "<YOUR_TRANSBANK_ENV>"
      }
    }
  }
}

io.github.codespar/mcp-transbank