Skip to main content
KH

Khipu

v0.2.0-alpha.2API Keyalpha

PSP chileno de transferencia bancaria instantánea. Complementa a Transbank para merchants que quieren pagos por transferencia bancaria además de tarjetas — los consumidores chilenos suelen preferir transferencias bancarias para transacciones más grandes (sin límite de crédito, sin comisiones de tarjeta).

21 herramientas4 env vars🇨🇱 Chilealpha — validación pendiente

Qué puede hacer tu agente

Khipu le da a tu agente 21 tools que llama directo — elegí las que necesite, en Claude, Cursor o cualquier cliente MCP.

  • create_paymentCreate 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.
  • get_paymentRetrieve 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_paymentDelete (cancel) a pending Khipu payment. Only works while the payment has not been paid by the payer.
Ejemplo de llamada
// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("create_payment", { /* ... */ });

Instalar

terminal
$ npm install @codespar/mcp-khipu@alpha

Quickstart

Agregá esta entrada a tu claude_desktop_config.json (o a la config de cualquier cliente compatible con MCP).

claude_desktop_config.json
{
  "mcpServers": {
    "khipu": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-khipu@alpha"
      ],
      "env": {}
    }
  }
}

Después de reiniciar, tu agente puede llamar cualquiera de las 21 herramientas de abajo — probá create_payment primero.

Variables de entorno · 4

Necesarias para autenticar el server. Almacenadas cifradas al usar el hosting gestionado de CodeSpar.

KHIPU_API_KEY
opcionalsecret

Khipu v3 API key (sent as x-api-key header). Obtain from Khipu merchant panel → Developers.

KHIPU_RECEIVER_ID
opcional

Khipu receiver id (merchant id). Required only for legacy v2 HTTP Basic auth; not needed when KHIPU_API_KEY is set.

KHIPU_SECRET
opcionalsecret

Khipu receiver secret. Required only for legacy v2 HTTP Basic auth; not needed when KHIPU_API_KEY is set.

KHIPU_BASE_URL
opcional

Khipu API base URL. Defaults to https://payment-api.khipu.com/v3.

Herramientas disponibles · 21

Cada herramienta es independiente — tu agente carga solo lo que necesita para reducir contexto y tiempo de respuesta.

WRITEcreate_payment
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.
WRITEget_payment
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).
DELETEdelete_payment
Delete (cancel) a pending Khipu payment. Only works while the payment has not been paid by the payer.
WRITEconfirm_payment
Manually confirm a Khipu payment. Use when the merchant has opted into manual confirmation and the backend has validated the underlying transfer.
DELETErefund_payment
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).
WRITElist_payments
List Khipu payments for the current merchant, optionally filtered by date range and status. Useful for reconciliation jobs and agent-driven reporting.
WRITEpredict_payment
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.
READget_merchants
List the merchant receiver accounts accessible with the current API key. Useful to confirm auth + discover receiver_id values.

Frameworks compatibles

MCP es un protocolo — cualquier framework que lo hable puede montar este server.

Claude Agent SDKAnthropic
OpenAI AgentsOpenAI
Vercel AI SDKVercel
LangChainLangChain
LlamaIndexLlamaIndex
CrewAICrewAI
MastraMastra
Cualquier cliente MCPProtocolo

Preguntas frecuentes

Corré `npx -y @codespar/mcp-khipu` y agregá el bloque de config de arriba a tu cliente MCP — Claude, Cursor, VS Code o cualquier cliente compatible con MCP. Sin build, sin SDK. ¿Preferís hosted? El tier gestionado de CodeSpar lo corre por vos, con la auth resuelta.
Khipu — MCP server · 21 tools | CodeSpar