{"_id":"@codespar/mcp-khipu","_rev":"5-cfa554ef5a926b228a630867e25009bb","name":"@codespar/mcp-khipu","dist-tags":{"latest":"0.2.0-alpha.3","alpha":"0.2.0-alpha.2"},"versions":{"0.1.0":{"name":"@codespar/mcp-khipu","version":"0.1.0","keywords":["mcp","khipu","payments","bank-transfer","chile","psp","instant-payments","transferencia"],"license":"MIT","_id":"@codespar/mcp-khipu@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-khipu":"dist/index.js"},"dist":{"shasum":"1e9754cd45e63b2abd2c40ac8e2342eeb8b992ac","tarball":"https://registry.npmjs.org/@codespar/mcp-khipu/-/mcp-khipu-0.1.0.tgz","fileCount":6,"integrity":"sha512-dYOU5LSN1ovmL5h7OJ4ETqPyNa5qfXlG9ayLmEjca2YBEk7hcqXF+k+gVCKkkY8S/fXsYcIBdpkZoTajhIEoOA==","signatures":[{"sig":"MEYCIQDaPHKTpnzYXKIct1PYOqHy18qfBwC9dCK9NIuBLdS/AAIhAJZVnzkSeCf9RNxdQLV0c8Pe7j+JjS/kcP7POnWoAbnQ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":36949},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"e1164fd411e8952e8b9f8c723795dc85f86f15d2","mcpName":"io.github.codespar/mcp-khipu","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Khipu — Chilean instant bank-transfer payments (complement to Transbank card acquiring)","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-khipu_0.1.0_1776993357517_0.8250691311969827","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.1":{"name":"@codespar/mcp-khipu","version":"0.2.0-alpha.1","keywords":["mcp","khipu","payments","bank-transfer","chile","psp","instant-payments","transferencia"],"license":"MIT","_id":"@codespar/mcp-khipu@0.2.0-alpha.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-khipu":"dist/index.js"},"dist":{"shasum":"d0fd85bdff9ffc7f3104b2b3d1b06bda0553edf6","tarball":"https://registry.npmjs.org/@codespar/mcp-khipu/-/mcp-khipu-0.2.0-alpha.1.tgz","fileCount":6,"integrity":"sha512-sIf5xMBX2c8S7M/6btHCybZ8o8xEJDtJFlhVkkKQpVCdVvlgAYus49vk0MHwo7pOeNn5cTCBB50l96hu7yiWGQ==","signatures":[{"sig":"MEQCIBiSarhWHbqiN4IBSTJ/F/6/MFyGZvAqRv4Fi5wqhTADAiBuOLSfBzIwzWSU+sLLgr9Z+lLrzcdq1CwhBRWIJI9Y1Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":62605},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"518f2f58e9384339c77b20df2a52366d15958a38","mcpName":"io.github.codespar/mcp-khipu","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Khipu — Chilean instant bank-transfer payments (complement to Transbank card acquiring)","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-khipu_0.2.0-alpha.1_1777072489874_0.33718366495391217","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.2":{"name":"@codespar/mcp-khipu","version":"0.2.0-alpha.2","keywords":["mcp","khipu","payments","bank-transfer","chile","psp","instant-payments","transferencia"],"license":"MIT","_id":"@codespar/mcp-khipu@0.2.0-alpha.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-khipu":"dist/index.js"},"dist":{"shasum":"26785a47d2c63bb16e65092292425ef4ce04dcd7","tarball":"https://registry.npmjs.org/@codespar/mcp-khipu/-/mcp-khipu-0.2.0-alpha.2.tgz","fileCount":6,"integrity":"sha512-xqEgfpObLmfjD55yB5hvLLoRUmoYHPZIAOAgcgjJiYR1k0JEMo1hrEshseIHl34p/3Br5j4EIAKGAdWXlbOzpw==","signatures":[{"sig":"MEYCIQDKJ32yYidKDcptWrOqXL/qMibAuXf53EJNNRJzZ2bgkgIhAJXPEZpoJqOogv2QrkOBF68kdyPSLemQPOBPXa233S4q","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":63795},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-khipu","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Khipu — Chilean instant bank-transfer payments (complement to Transbank card acquiring)","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-khipu_0.2.0-alpha.2_1777123213569_0.567620750158593","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.3":{"name":"@codespar/mcp-khipu","version":"0.2.0-alpha.3","description":"MCP server for Khipu — Chilean instant bank-transfer payments (complement to Transbank card acquiring)","type":"module","main":"./dist/index.js","bin":{"mcp-khipu":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","khipu","payments","bank-transfer","chile","psp","instant-payments","transferencia"],"mcpName":"io.github.codespar/mcp-khipu","_id":"@codespar/mcp-khipu@0.2.0-alpha.3","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-bOtwO1iIwQpPGAzb92vMxzSt1Lkp2p9sNalm61fboiVzTBJQRBUJcnxX1IxQFsrvc8BO73ke9eXMuzOTMrjidA==","shasum":"58ae46b6c39f0f8925f6a7c9e2c66fad383452b7","tarball":"https://registry.npmjs.org/@codespar/mcp-khipu/-/mcp-khipu-0.2.0-alpha.3.tgz","fileCount":6,"unpackedSize":65276,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC5IqfhGROhXGSh/GmVQi7NCEldxfLWCVYCJeaaPGDx/wIhAPT+2aXj/tldrbmr0M/BFq/RUWonf/nlJ2jHTc2NQrWw"}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-khipu_0.2.0-alpha.3_1782153869158_0.28738964346557916"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-24T01:15:57.371Z","modified":"2026-06-22T18:44:29.469Z","0.1.0":"2026-04-24T01:15:57.658Z","0.2.0-alpha.1":"2026-04-24T23:14:50.039Z","0.2.0-alpha.2":"2026-04-25T13:20:13.748Z","0.2.0-alpha.3":"2026-06-22T18:44:29.315Z"},"license":"MIT","keywords":["mcp","khipu","payments","bank-transfer","chile","psp","instant-payments","transferencia"],"description":"MCP server for Khipu — Chilean instant bank-transfer payments (complement to Transbank card acquiring)","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-khipu\n\nMCP server for [Khipu](https://khipu.com) — Chilean instant bank-transfer PSP.\n\nKhipu 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.\n\nChilean agents typically bundle Khipu with [`@codespar/mcp-transbank`](../transbank): Webpay for cards, Khipu for bank transfers. Together they cover the vast majority of Chilean checkout preferences.\n\n## Tools (21)\n\n| Tool | Purpose |\n|---|---|\n| `create_payment` | Create a Khipu payment (bank-transfer charge). |\n| `get_payment` | Retrieve a Khipu payment. |\n| `delete_payment` | Delete (cancel) a pending Khipu payment. |\n| `confirm_payment` | Manually confirm a Khipu payment. |\n| `refund_payment` | Refund a paid Khipu payment (full or partial). |\n| `list_payments` | List Khipu payments for the current merchant, optionally filtered by date range and status. |\n| `predict_payment` | Predict whether a payment is likely to succeed for a given payer+amount+bank, and recommend the best bank/r... |\n| `get_merchants` | List the merchant receiver accounts accessible with the current API key. |\n| `get_merchant` | Fetch a single merchant by id. |\n| `list_merchant_accounts` | List the bank accounts registered for a merchant to collect into. |\n| `create_receiver` | Create (onboard) a new receiver under an integrator account. |\n| `list_receivers` | List receivers onboarded under the current integrator account. |\n| `list_conciliations` | List settlement / conciliation records for a date range. |\n| `list_reviews` | List payer reviews / opinions left after a Khipu payment. |\n| `register_webhook` | Register a webhook endpoint to receive Khipu notifications (payment.paid, payment.refunded, etc). |\n| `list_webhooks` | List registered webhook endpoints for the current merchant. |\n| `delete_webhook` | Delete (unregister) a webhook endpoint by id. |\n| `create_terminal_session` | Create a Khipu terminal session for in-person / POS bank-transfer checkout. |\n| `get_terminal_session` | Retrieve the current status of a terminal (POS) session — whether the payer has scanned, paid, or the sessi... |\n| `get_banks` | List Chilean banks supported by Khipu for bank-transfer payments. |\n| `create_automatic_payment` | Create a Khipu automatic payment (recurring / subscription charge against a previously enrolled subscriptio... |\n\n## Install\n\n```bash\nnpm install @codespar/mcp-khipu@alpha\n```\n\n## Environment\n\n```bash\n# Preferred — v3 API key auth\nKHIPU_API_KEY=\"...\"       # sent as x-api-key header\n\n# Legacy — v2 HTTP Basic auth (only if no API key available)\nKHIPU_RECEIVER_ID=\"...\"   # merchant receiver id\nKHIPU_SECRET=\"...\"        # receiver secret\n\n# Optional\nKHIPU_BASE_URL=\"...\"      # defaults to https://payment-api.khipu.com/v3\n```\n\n## Authentication\n\nKhipu 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.\n\nIf `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.\n\nAll request bodies are JSON (v3); the server sets `Content-Type: application/json` automatically.\n\n## Run\n\n```bash\n# stdio (default — for Claude Desktop, Cursor, etc)\nnpx @codespar/mcp-khipu\n\n# HTTP (for server-to-server testing)\nMCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-khipu\n```\n\n## Why Khipu + Transbank\n\nChile has two dominant checkout rails:\n\n1. **Card (Transbank Webpay)** — universal, works everywhere, interchange fees apply.\n2. **Bank transfer (Khipu)** — no card needed, no credit limit, cheaper fees, preferred for larger purchases and B2B.\n\nAn 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.\n\n## Pair with\n\n- [`@codespar/mcp-transbank`](../transbank) — Chilean card acquiring (Webpay Plus, Oneclick, Full Transaction)\n- [`@codespar/mcp-dlocal`](../dlocal) — cross-border LatAm coverage when you need CL + other countries through one API\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}