Khipu

Chilean instant bank-transfer PSP. Complements Transbank for merchants who want bank-transfer payments alongside cards — Chilean consumers often prefer bank transfers for larger transactions (no credit limit, no card fees).

MIT · runs locally or through the CodeSpar runtime

Quickstart

Install, set the credentials, make the first call.

Pick your client. The server runs locally over stdio, or through the hosted runtime.

Tools

What your agent can call.

Create a Khipu payment (bank-transfer charge). Returns a payment_id and URLs the payer visits to authorize the transfer from their Chilean bank account. Use simplified_transfer_url for in-app redirects and transfer_url for desktop bank-login flows.

Retrieve a Khipu payment. Pass either payment_id (lookup by id) or notification_token (lookup from a webhook — preferred, since webhooks only contain the token).

Delete (cancel) a pending Khipu payment. Only works while the payment has not been paid by the payer.

Manually confirm a Khipu payment. Use when the merchant has opted into manual confirmation and the backend has validated the underlying transfer.

Refund a paid Khipu payment (full or partial). Refunds are only possible for merchants collecting into a Khipu account and before settlement of the corresponding funds (until 01:00 am the next business day).

List Khipu payments for the current merchant, optionally filtered by date range and status. Useful for reconciliation jobs and agent-driven reporting.

Predict whether a payment is likely to succeed for a given payer+amount+bank, and recommend the best bank/rail. Call before create_payment to improve conversion for large or edge-case transfers.

List the merchant receiver accounts accessible with the current API key. Useful to confirm auth + discover receiver_id values.

Fetch a single merchant by id. Returns commercial info, configured collect accounts, and current integration status.

List the bank accounts registered for a merchant to collect into. Use with refund_payment / conciliation flows to know which account funds settle to.

Create (onboard) a new receiver under an integrator account. The receiver can then collect Khipu payments. Only available to integrator-level API keys.

List receivers onboarded under the current integrator account.

Compatibility

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

Through the CodeSpar runtime, codespar_discover finds this server's tools, and a tools/call runs with the credential connected in your project, a test key included.

Start in seconds.

On the CodeSpar runtime, the credential you connect stays encrypted for your organization and the runtime adds it to each call. You just call the tool.