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 分