io.github.codespar/mcp-transbank

NPM · @CODESPAR/MCP-TRANSBANK · SCANNED AUG 4

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

Available components

+23 this week 69 69 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security83

No malware found by supply-chain analysis.Pass
CVE check failed: a known medium-severity CVE affects hono 4.12.33, reached via @modelcontextprotocol/sdk > hono. A fixed version is available. View diagnostics → Fail
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency45

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 42 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability77

AI-judged instruction clarity (excellent).Pass
Tool/resource definitions use about 1521 tokens (~80/item across 19 items; 19 tools + 0 resources), lean.Pass
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management30

Stability observed for 9 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @codespar/mcp-transbank

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add codespar-mcp-transbank -- npx -y @codespar/mcp-transbank

# add to Codex CLI

codex mcp add codespar-mcp-transbank -- npx -y @codespar/mcp-transbank

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "codespar-mcp-transbank": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@codespar/mcp-transbank"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add codespar-mcp-transbank --command npx --arg -y --arg @codespar/mcp-transbank

# ~/.hermes/config.yaml

mcp_servers:
  codespar-mcp-transbank:
    command: "npx"
    args: ["-y", "@codespar/mcp-transbank"]

// mcp.json

{
  "mcpServers": {
    "codespar-mcp-transbank": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-transbank"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

4 Aug 26 0
- CVE-2026-69207 affects this package: medium ▼ security
- Known CVEs: partial → fail ▼ security
3 Aug 26 +4
- Stability: unverified → 0.27 ▲ functional
2 Aug 26 +44
- Provenance: unverified → fail ▼ security
- Known CVEs: unverified → partial ▲ security
- Install scripts: unverified → pass ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- Schema quality: unverified → excellent ▲ functional
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Licence: MIT functional
1 Aug 26 +16
- Tool coverage: unverified → 100 ▲ functional
31 Jul 26 −23
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 −18
- Malware scan: pass → unverified ▼ security
27 Jul 26 46

First indexed and scored.

Show 4 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 4 Aug 2026 · Analysed npm/@codespar/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Vulnerabilities 1 finding

ID	CVE	Severity	Vector	Fix available
GHSA-8j4g-w8fx-2239	CVE-2026-69207	medium	CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:L	yes

Dependencies 94 packages

94 packages in the resolved dependency tree · 94 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 19 exposed · ~1,454 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

oneclick_authorize ~109

Charge a stored OneClick Mall card across one or more mall merchant codes. Each details entry is a separate child charge with its own commerce_code, buy_order, amount, and installments_number.

Input Output Examples

Name	Type	Req	Description
buy_order	string	yes	Parent (mall) buy_order (max 26 chars)
details	array	yes	Child charges, one per mall seller
tbk_user	string	yes	Stored-card token
username	string	yes	Merchant-side username associated with the tbk_user

No output schema declared.

No examples provided.

oneclick_capture ~90

Capture a previously authorized OneClick Mall charge (deferred-capture flow). One capture per child detail.

Input Output Examples

Name	Type	Req	Description
authorization_code	string	yes	Authorization code returned from oneclick_authorize
buy_order	string	yes	Child buy_order used at authorize
capture_amount	number	yes	Amount to capture in CLP (integer)
commerce_code	string	yes	Child commerce_code used at authorize

No output schema declared.

No examples provided.

oneclick_create_inscription ~94

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.

Input Output Examples

Name	Type	Req	Description
email	string	yes	User email
response_url	string	yes	URL Transbank redirects the user back to after enrollment
username	string	yes	Merchant-side stable user identifier (max 40 chars)

No output schema declared.

No examples provided.

oneclick_delete_inscription ~58

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

Input Output Examples

Name	Type	Req	Description
tbk_user	string	yes	Stored-card token from oneclick_finish_inscription
username	string	yes	Same merchant-side username used at enrollment

No output schema declared.

No examples provided.

oneclick_finish_inscription ~58

Finalize a OneClick Mall enrollment after the user has returned. Returns the tbk_user token to store and reuse in oneclick_authorize.

Input Output Examples

Name	Type	Req	Description
token	string	yes	Inscription token (TBK_TOKEN query param on return)

No output schema declared.

No examples provided.

oneclick_get_transaction_by_buy_order ~65

Look up a OneClick Mall transaction by parent buy_order. Functionally identical to oneclick_status — provided as an explicit name for agents that follow the 'get by identifier' naming convention.

Input Output Examples

Name	Type	Req	Description
buy_order	string	yes	Parent (mall) buy_order

No output schema declared.

No examples provided.

oneclick_refund ~90

Refund a OneClick Mall charge. Parent buy_order identifies the mall transaction; detail_buy_order + commerce_code pinpoint the child to refund.

Input Output Examples

Name	Type	Req	Description
amount	number	yes	Refund amount in CLP (integer)
buy_order	string	yes	Parent (mall) buy_order
commerce_code	string	yes	Child commerce_code
detail_buy_order	string	yes	Child buy_order to refund

No output schema declared.

No examples provided.

oneclick_status ~37

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

Input Output Examples

Name	Type	Req	Description
buy_order	string	yes	Parent (mall) buy_order

No output schema declared.

No examples provided.

webpay_capture_transaction ~100

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.

Input Output Examples

Name	Type	Req	Description
authorization_code	string	yes	Authorization code returned at authorization time
buy_order	string	yes	Original buy_order
capture_amount	number	yes	Amount to capture in CLP (integer)
token	string	yes	Webpay token of the authorized transaction

No output schema declared.

No examples provided.

webpay_commit_transaction ~53

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

Input Output Examples

Name	Type	Req	Description
token	string	yes	Webpay token (token_ws query param on return)

No output schema declared.

No examples provided.

webpay_create_transaction ~121

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.

Input Output Examples

Name	Type	Req	Description
amount	number	yes	Amount in CLP (integer, no decimals)
buy_order	string	yes	Merchant-side order id (max 26 chars)
return_url	string	yes	URL Transbank redirects the user back to after payment
session_id	string	yes	Merchant-side session id (max 61 chars)

No output schema declared.

No examples provided.

webpay_get_transaction_status ~34

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

Input Output Examples

Name	Type	Req	Description
token	string	yes	Webpay token

No output schema declared.

No examples provided.

webpay_increase_amount ~84

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

Input Output Examples

Name	Type	Req	Description
authorization_code	string	yes	Authorization code returned at authorization time
buy_order	string	yes	Original buy_order
capture_amount	number	yes	Amount to capture in CLP (integer)
token	string	yes	Webpay token of the authorized transaction

No output schema declared.

No examples provided.

webpay_mall_capture_transaction ~95

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

Input Output Examples

Name	Type	Req	Description
authorization_code	string	yes	Authorization code returned at authorization time
buy_order	string	yes	Child buy_order
capture_amount	number	yes	Amount to capture in CLP (integer)
commerce_code	string	yes	Child commerce_code to capture
token	string	yes	Webpay token of the authorized mall transaction

No output schema declared.

No examples provided.

webpay_mall_commit_transaction ~49

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

Input Output Examples

Name	Type	Req	Description
token	string	yes	Webpay token (token_ws query param on return)

No output schema declared.

No examples provided.

webpay_mall_create_transaction ~129

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.

Input Output Examples

Name	Type	Req	Description
buy_order	string	yes	Parent (mall) buy_order (max 26 chars)
details	array	yes	Child charges, one per mall seller
return_url	string	yes	URL Transbank redirects the user back to after payment
session_id	string	yes	Merchant-side session id (max 61 chars)

No output schema declared.

No examples provided.

webpay_mall_get_transaction_status ~40

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

Input Output Examples

Name	Type	Req	Description
token	string	yes	Webpay token

No output schema declared.

No examples provided.

webpay_mall_refund_transaction ~91

Refund one child seller of a Webpay Mall transaction. Must specify which child (commerce_code + buy_order) to refund.

Input Output Examples

Name	Type	Req	Description
amount	number	yes	Refund amount in CLP (integer)
buy_order	string	yes	Child buy_order to refund
commerce_code	string	yes	Child commerce_code
token	string	yes	Webpay token of the original mall transaction

No output schema declared.

No examples provided.

webpay_refund_transaction ~57

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

Input Output Examples

Name	Type	Req	Description
amount	number	yes	Refund amount in CLP (integer)
token	string	yes	Webpay token of the original transaction

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 4 Aug