Skip to main content
T

Transbank

@codespar/mcp-transbank · v0.2.0-alpha.3

🇨🇱 ChilePaymentsAuth · API Keybeta19 tools3 env varsprerelease

Chile's dominant card acquirer — state-origin roots, effectively default for Chilean commerce. Webpay Plus (single payments) + Webpay OneClick Mall (stored-card recurring). Prerequisite for any LatAm-coverage claim that includes Chile.

Get started · freeView docs

MIT · runs locally with your own credentials

Limitations

  • v0.2.0-alpha.3 is a prerelease, with 19 tools, and the command on this page installs it. The latest stable release is 0.1.0, with 12 tools.
  • Hosted calls with a test key are not available: connecting this provider needs credentials it issues to an operator.
Package
@codespar/mcp-transbank
Version
0.2.0-alpha.3 · prerelease
npm dist-tag
latest
Category
Payments
Auth
API Key
Country
🇨🇱 Chile
License
MIT
Transport
stdio · streamable-http

Quickstart

Install, set the credentials, make the first call.

Pick your client. The server runs locally over stdio, with your own credentials.

Add the server to your clientOne config entry. No build step, no SDK required.
Set the environment variables3 variables read by this server's code, listed below.
Restart and make the first callThe agent can call any of the 19 tools. Try webpay_create_transaction first.
terminal
# Claude Code claude mcp add transbank -e TRANSBANK_API_KEY_SECRET=… -e TRANSBANK_COMMERCE_CODE=… -e TRANSBANK_ENV=… -- npx -y @codespar/mcp-transbank@0.2.0-alpha.3 # then: /mcp to confirm the server is connected
Environment variables3 variables
TRANSBANK_API_KEY_SECRETTransbank API secret key (sent as Tbk-Api-Key-Secret header)requiredsecret
TRANSBANK_COMMERCE_CODETransbank merchant commerce code (sent as Tbk-Api-Key-Id header)required
TRANSBANK_ENVEnvironment: 'integration' (default, https://webpay3gint.transbank.cl) or 'production' (https://webpay3g.transbank.cl)optional

Names read from the package code (@codespar/mcp-transbank@0.2.0-alpha.3). Descriptions and flags come from its manifest. Self-hosted, you hold the credentials.

First call demowebpay_create_transaction

"Create a Webpay Plus transaction. Returns { token, url } — redirect the user to url?token_ws=<token> to complete payment. After the user returns to return_url, call webpay_commit_transaction"

tools/callwebpay_create_transactionresult returned

Tools

What your agent can call.

19 tools, as the package's tools/list returns them.

webpay_create_transaction

Create a Webpay Plus transaction. Returns { token, url } — redirect the user to url?token_ws=<token> to complete payment. After the user returns to return_url, call webpay_commit_transaction.

webpay_commit_transaction

Commit a Webpay Plus transaction after the user has returned from the Webpay flow. Must be called to actually charge the card.

webpay_get_transaction_status

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

webpay_refund_transaction

Refund a committed Webpay Plus transaction. Full refund if amount equals original; partial otherwise.

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. Uses the official PUT /capture endpoint — prefer this over webpay_increase_amount for standard deferred-capture flows.

webpay_mall_create_transaction

Create a Webpay Mall transaction — one parent buy_order split across several seller commerce codes. Returns { token, url } exactly like Webpay Plus. Each details entry is a child charge with its own commerce_code, buy_order, and amount.

webpay_mall_commit_transaction

Commit a Webpay Mall transaction after the user has returned. Charges all child commerce codes at once.

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. Must specify which child (commerce_code + buy_order) to refund.

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. Returns { token, url_webpay } — redirect the user to complete enrollment. After return to response_url, call oneclick_finish_inscription.

Names and descriptions come from the package's tools/list (@codespar/mcp-transbank@0.2.0-alpha.3). A kind (read, write, delete) is shown only when the package annotates its tools or each tool was verified one by one; neither exists for this server yet.

Compatibility

MCP is a protocol. Any client that speaks it can mount this server.

codespar_discover lists this server's tools, but connecting it needs credentials the provider issues to an operator (a certificate, signed keys or paired headers), which a test key cannot produce.

Protocol

Any MCP client

stdio · streamable-http

Questions

Before you install.

How do I install the Transbank MCP server?

Run npx -y @codespar/mcp-transbank@0.2.0-alpha.3 and add the config block above to your MCP client: Claude Code, Cursor, Claude Desktop, VS Code, or any MCP-compatible client. No build step, no SDK required.

What can my agent do with Transbank?

Transbank exposes 19 tools for payments. Your agent calls them directly; the full list is above.

How does Transbank authenticate, and how are credentials stored?

Transbank uses API Key. Self-hosted, you hold the credentials: the server reads them from its environment variables.

How does Transbank handle upstream API changes?

Every server is versioned independently on npm. The command on this page pins 0.2.0-alpha.3, the version whose tools are listed here; your agent keeps running it until you change the version.

Is Transbank open source? How do I report a bug?

Yes. Transbank is MIT-licensed and published on npm as @codespar/mcp-transbank, source on GitHub (link in the Details panel). Report issues on the package repository; security issues go to security@codespar.dev, and we respond within 24 hours.

Start in seconds.

Add the config above, set the variables, and your agent calls the tools.

Start in seconds demo
Add the server to your client with the config above.
Set the environment variables listed above.
Ask your agent for the first call.
Transbank — MCP server · 19 tools | CodeSpar