Mcp Khipu

io.github.codespar由 GitHub 帳號 codespar 發布v0.2.0-alpha.3更新於 Nov 3, 2026

MCP server for Khipu — Chilean instant bank-transfer payments (complements Transbank cards)

已驗證STDIO僅桌面金融商業與電商

概覽

AI 產生的概覽

針對智利即時銀行轉帳支付服務 Khipu 的 MCP 伺服器，讓助理建立、查詢、退款與對帳付款。

可以做什麼
  • 建立、查詢、列出、確認、取消與退款 Khipu 銀行轉帳付款，包含週期性自動扣款。
  • 預測付款成功機率，並列出 Khipu 支援的智利銀行。
  • 檢視商戶收款方及其收款銀行帳戶，並在整合商帳戶下開通新的收款方。
  • 檢視結算／對帳紀錄與付款人評價。
  • 註冊、列出與刪除用於付款通知的 webhook 端點。
  • 建立並查詢線下終端（POS）銀行轉帳結帳工作階段。
適用情境
適合建置或維運支援銀行轉帳的智利結帳流程，或需要助理代為處理 Khipu 商戶帳戶的付款狀態、退款、對帳與 webhook 設定時使用。
執行需求
透過 npx 從 npm 套件 @codespar/mcp-khipu 在本機執行（需 Node.js）。需要 Khipu 商戶帳戶，並在 KHIPU_API_KEY 提供 API 金鑰；舊版 v2 驗證則改用 KHIPU_RECEIVER_ID 與 KHIPU_SECRET。KHIPU_BASE_URL 為選用，預設指向 Khipu v3 端點。需要連線至 Khipu 的網路。
安裝前請注意
涉及真實資金：工具會建立扣款、確認付款、發起全額或部分退款、刪除待處理付款、開通收款方以及註冊或刪除 webhook。KHIPU_API_KEY（以及舊版 KHIPU_SECRET）具備商戶層級權限，應避免出現在日誌與共用設定中。付款與商戶資料會傳送至 Khipu 的 API。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Khipu，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@codespar/mcp-khipu

MCP server for Khipu — Chilean instant bank-transfer PSP.

Khipu lets a payer pay from their Chilean bank account in real time: the merchant creates a payment, the payer is redirected to Khipu, logs into their bank, and the transfer lands instantly. No card, no credit limit, no interchange fees — the Chilean preferred rail for higher-ticket purchases.

Chilean agents typically bundle Khipu with @codespar/mcp-transbank: Webpay for cards, Khipu for bank transfers. Together they cover the vast majority of Chilean checkout preferences.

Tools (21)

ToolPurpose
create_paymentCreate a Khipu payment (bank-transfer charge).
get_paymentRetrieve a Khipu payment.
delete_paymentDelete (cancel) a pending Khipu payment.
confirm_paymentManually confirm a Khipu payment.
refund_paymentRefund a paid Khipu payment (full or partial).
list_paymentsList Khipu payments for the current merchant, optionally filtered by date range and status.
predict_paymentPredict whether a payment is likely to succeed for a given payer+amount+bank, and recommend the best bank/r...
get_merchantsList the merchant receiver accounts accessible with the current API key.
get_merchantFetch a single merchant by id.
list_merchant_accountsList the bank accounts registered for a merchant to collect into.
create_receiverCreate (onboard) a new receiver under an integrator account.
list_receiversList receivers onboarded under the current integrator account.
list_conciliationsList settlement / conciliation records for a date range.
list_reviewsList payer reviews / opinions left after a Khipu payment.
register_webhookRegister a webhook endpoint to receive Khipu notifications (payment.paid, payment.refunded, etc).
list_webhooksList registered webhook endpoints for the current merchant.
delete_webhookDelete (unregister) a webhook endpoint by id.
create_terminal_sessionCreate a Khipu terminal session for in-person / POS bank-transfer checkout.
get_terminal_sessionRetrieve the current status of a terminal (POS) session — whether the payer has scanned, paid, or the sessi...
get_banksList Chilean banks supported by Khipu for bank-transfer payments.
create_automatic_paymentCreate a Khipu automatic payment (recurring / subscription charge against a previously enrolled subscriptio...

Install

bash
npm install @codespar/mcp-khipu@alpha

Environment

bash
# Preferred — v3 API key authKHIPU_API_KEY="..."       # sent as x-api-key header
# Legacy — v2 HTTP Basic auth (only if no API key available)KHIPU_RECEIVER_ID="..."   # merchant receiver idKHIPU_SECRET="..."        # receiver secret
# OptionalKHIPU_BASE_URL="..."      # defaults to https://payment-api.khipu.com/v3

Authentication

Khipu v3 uses a single API key in the x-api-key header — no request signing, no HMAC. Obtain the key from the Khipu merchant panel under Developers → API keys.

If KHIPU_API_KEY is unset, the server falls back to v2 HTTP Basic with KHIPU_RECEIVER_ID:KHIPU_SECRET for merchants still on the legacy endpoints.

All request bodies are JSON (v3); the server sets Content-Type: application/json automatically.

Run

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

Why Khipu + Transbank

Chile has two dominant checkout rails:

  1. Card (Transbank Webpay) — universal, works everywhere, interchange fees apply.
  2. Bank transfer (Khipu) — no card needed, no credit limit, cheaper fees, preferred for larger purchases and B2B.

An agent that can offer both at checkout converts materially better than one that only takes cards. @codespar/mcp-transbank handles the first; this package handles the second.

Pair with

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

來源：packages/payments/khipu/README.md，提交 d0a519a

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.2.0-alpha.3最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分