Mcp Khipu

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

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

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

MCP server for Khipu, Chile's instant bank-transfer payment provider, letting an assistant create, track, refund and reconcile payments.

What you can do
  • Create, retrieve, list, confirm, cancel and refund Khipu bank-transfer payments, including recurring automatic payments.
  • Predict payment success and list supported Chilean banks.
  • Inspect merchant receivers and their collection bank accounts, and onboard new receivers under an integrator account.
  • Review settlement/conciliation records and payer reviews.
  • Register, list and delete webhook endpoints for payment notifications.
  • Create and check in-person terminal (POS) sessions for bank-transfer checkout.
When to use it
Useful when building or operating a Chilean checkout that accepts bank transfers, or when an assistant should handle payment status, refunds, reconciliation and webhook setup for a Khipu merchant account.
Requirements
Runs locally via npx from the npm package @codespar/mcp-khipu (Node.js). Needs a Khipu merchant account and an API key in KHIPU_API_KEY; legacy v2 auth instead uses KHIPU_RECEIVER_ID and KHIPU_SECRET. KHIPU_BASE_URL is optional and defaults to the Khipu v3 endpoint. Network access to Khipu is required.
Before you install
Handles real money: tools create charges, confirm payments, issue full or partial refunds, delete pending payments, onboard receivers and register or remove webhooks. The API key in KHIPU_API_KEY (and the legacy KHIPU_SECRET) grants merchant-level access and should be kept out of logs and shared configs. Payment and merchant data is sent to Khipu's API.

Installation

In SourceWeft

  1. Open Mcp Khipu 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-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

Source: packages/payments/khipu/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