Mcp Transbank

io.github.codesparPublished by GitHub account codesparv0.2.0-alpha.3Updated Oct 24, 2026

MCP server for Transbank — Chile dominant card acquirer (Webpay Plus / Mall / OneClick)

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Local MCP server that lets an assistant create, commit, capture, refund and look up Transbank Webpay Plus, Mall and OneClick card payments in Chile.

What you can do
  • Create, commit, check status, capture or increase and refund Webpay Plus one-shot redirect payments
  • Create, commit, check status, capture and refund Webpay Mall transactions split across several seller commerce codes
  • Start, finish and delete OneClick Mall card enrollments, then authorize, capture, refund and look up stored-card charges
  • Switch between Transbank integration and production environments via configuration
When to use it
Use it when you are building or operating Chilean e-commerce payments on Transbank and want an assistant to drive Webpay Plus, Webpay Mall or OneClick Mall flows, including refunds and deferred captures, from a local MCP client.
Requirements
Runs locally over stdio via the npm package (npx or npm install), so Node.js is needed. Requires a Transbank merchant commerce code in TRANSBANK_COMMERCE_CODE and an API secret key in TRANSBANK_API_KEY_SECRET; TRANSBANK_ENV selects integration (default) or production. Outbound network access to Transbank endpoints is required.
Before you install
The API secret key is a live payment credential; keep it out of logs and shared configs. Tools move real money: commit, capture, increase, authorize and refund act on actual transactions, and production mode charges real cards. Refunds and captures are irreversible, and deleting a OneClick inscription revokes a stored card. Transaction data is sent to Transbank.

Installation

In SourceWeft

  1. Open Mcp Transbank in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@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)

ToolPurpose
webpay_create_transactionCreate a Webpay Plus transaction.
webpay_commit_transactionCommit a Webpay Plus transaction after the user has returned from the Webpay flow.
webpay_get_transaction_statusGet the current status of a Webpay Plus transaction by token.
webpay_refund_transactionRefund a committed Webpay Plus transaction.
webpay_increase_amountCapture a previously authorized Webpay Plus transaction (partial-capture / deferred-capture flow).
webpay_capture_transactionDeferred-capture for a previously authorized Webpay Plus transaction.
webpay_mall_create_transactionCreate a Webpay Mall transaction — one parent buy_order split across several seller commerce codes.
webpay_mall_commit_transactionCommit a Webpay Mall transaction after the user has returned.
webpay_mall_get_transaction_statusGet the status of a Webpay Mall transaction by token (includes per-child details).
webpay_mall_refund_transactionRefund one child seller of a Webpay Mall transaction.
webpay_mall_capture_transactionDeferred-capture for one child seller inside a Webpay Mall transaction.
oneclick_create_inscriptionStart a OneClick Mall card-enrollment flow.
oneclick_finish_inscriptionFinalize a OneClick Mall enrollment after the user has returned.
oneclick_delete_inscriptionDelete (revoke) a stored OneClick Mall card for a user.
oneclick_authorizeCharge a stored OneClick Mall card across one or more mall merchant codes.
oneclick_captureCapture a previously authorized OneClick Mall charge (deferred-capture flow).
oneclick_refundRefund a OneClick Mall charge.
oneclick_statusGet the status of a OneClick Mall transaction by parent buy_order.
oneclick_get_transaction_by_buy_orderLook up a OneClick Mall transaction by parent buy_order.

Install

bash
npm install @codespar/mcp-transbank@alpha

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

Authentication

Every request sends two headers:

Tbk-Api-Key-Id: <commerce_code>Tbk-Api-Key-Secret: <api_key_secret>Content-Type: application/json

The server handles headers automatically — you only configure the env vars.

Run

bash
# stdio (default — for Claude Desktop, Cursor, etc)npx @codespar/mcp-transbank
# HTTP (for server-to-server testing)MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-transbank

Webpay Plus flow

  1. Call webpay_create_transaction with buy_order, session_id, amount, return_url.
  2. Redirect user to url?token_ws=<token>.
  3. User pays at Webpay, is redirected back to return_url.
  4. Call webpay_commit_transaction with the returned token to actually charge.

OneClick Mall flow

  1. Call oneclick_create_inscription with username, email, response_url. Redirect user to url_webpay.
  2. After user returns, call oneclick_finish_inscription. Store the returned tbk_user against your user.
  3. To charge later, call oneclick_authorize with username, tbk_user, a parent mall buy_order, and a details array (one entry per child merchant).

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

Source: packages/payments/transbank/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.0-alpha.3LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts