{"_id":"@codespar/mcp-kushki","name":"@codespar/mcp-kushki","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@codespar/mcp-kushki","version":"0.1.0","description":"MCP server for Kushki — omnichannel LATAM PSP: card charges, preauth/capture, PSE/SPEI transfer-in, cash, subscriptions","type":"module","main":"./dist/index.js","bin":{"mcp-kushki":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","kushki","payments","psp","pse","spei","cash","subscriptions","mexico","colombia","chile","peru","ecuador"],"mcpName":"io.github.codespar/mcp-kushki","_id":"@codespar/mcp-kushki@0.1.0","gitHead":"0cf000f9cad29acc97dc1e29789d180431c6fe12","types":"./dist/index.d.ts","_nodeVersion":"22.23.1","_npmVersion":"10.9.8","dist":{"integrity":"sha512-Glnj867edKxFXcFzkxXhRbu7OUL2DhIFOOiiXmEGCbqdw19n02dF1By30qPoseE8admef+adx3lEJEYAwZmPGQ==","shasum":"dedeea727dd3b1135f893517bf32b59cd1fff1d2","tarball":"https://registry.npmjs.org/@codespar/mcp-kushki/-/mcp-kushki-0.1.0.tgz","fileCount":4,"unpackedSize":26485,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCzFQeYeiGz2b3SXMA0Cx3hj6nQxkhNhEUaMHYBkufBhgIgGm37YTC7Eq6ccYojTfofhLRq3bAHtSim/FzNqie82uw="}]},"_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-kushki_0.1.0_1783129661726_0.932776301701749"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-04T01:47:41.540Z","0.1.0":"2026-07-04T01:47:41.857Z","modified":"2026-07-04T01:47:42.117Z"},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"description":"MCP server for Kushki — omnichannel LATAM PSP: card charges, preauth/capture, PSE/SPEI transfer-in, cash, subscriptions","keywords":["mcp","kushki","payments","psp","pse","spei","cash","subscriptions","mexico","colombia","chile","peru","ecuador"],"license":"MIT","readme":"# @codespar/mcp-kushki\n\n> MCP server for **Kushki** — the omnichannel PSP spanning Mexico, Colombia, Chile, Peru and Ecuador: card tokenization + one-step/two-step charges, bank transfer-in (PSE / SPEI), cash networks and subscriptions, all on one REST API.\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-kushki)](https://www.npmjs.com/package/@codespar/mcp-kushki)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to `~/.config/claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"kushki\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-kushki\"],\n      \"env\": {\n        \"KUSHKI_PUBLIC_MERCHANT_ID\": \"your-public-merchant-id\",\n        \"KUSHKI_PRIVATE_MERCHANT_ID\": \"your-private-merchant-id\",\n        \"KUSHKI_ENV\": \"sandbox\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add kushki --env KUSHKI_PUBLIC_MERCHANT_ID=... --env KUSHKI_PRIVATE_MERCHANT_ID=... -- npx -y @codespar/mcp-kushki\n```\n\n### Cursor / VS Code\n\nAdd the same block to `.cursor/mcp.json` or `.vscode/mcp.json`.\n\n## Tools (10)\n\n| Tool | Endpoint | What it does |\n|---|---|---|\n| `tokenize_card` | `POST /card/v1/tokens` | Raw card → single-use token (public id) |\n| `create_charge` | `POST /card/v1/charges` | One-step card charge |\n| `create_preauthorization` | `POST /card/v1/preAuthorization` | Hold funds (two-step, step 1) |\n| `capture_preauthorization` | `POST /card/v1/capture` | Capture a preauth (step 2, partial OK) |\n| `void_charge` | `DELETE /card/v1/charges/{ticket}` | Void (same-day) or refund (settled) |\n| `create_transfer_token` | `POST /transfer/v1/tokens` | Token for PSE (CO) / SPEI (MX) transfer-in |\n| `create_transfer_charge` | `POST /transfer/v1/init` | Start the bank transfer; returns redirect URL |\n| `create_cash_charge` | `POST /cash/v1/charges` | Cash voucher for OXXO-style networks |\n| `create_subscription` | `POST /card/v1/subscriptions` | Recurring card charge on a periodicity |\n| `cancel_subscription` | `DELETE /card/v1/subscriptions/{id}` | Stop future charges |\n\n## Authentication\n\nTwo merchant ids with distinct powers:\n\n| Variable | Required | Description |\n|---|---|---|\n| `KUSHKI_PUBLIC_MERCHANT_ID` | yes | Tokenization only — safe for client-side use |\n| `KUSHKI_PRIVATE_MERCHANT_ID` | yes | Money movement — server-side only |\n| `KUSHKI_ENV` | no | `sandbox` (api-uat, default) or `production` |\n\nAmounts use Kushki's per-country tax shape: `{ subtotalIva, subtotalIva0, iva, currency }` — currencies MXN, COP, CLP, PEN, USD.\n\n## Example\n\n> \"Tokenize this test card and charge COP 85,000 with 19% IVA.\"\n\nThe agent calls `tokenize_card`, then `create_charge` with `{ subtotalIva: 85000, subtotalIva0: 0, iva: 16150, currency: \"COP\" }`.\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## Managed tier\n\nThis open-source server calls Kushki's API directly with your credentials. CodeSpar's managed tier routes one interface across every LATAM provider with automatic failover, governance, audit and a credential vault: [codespar.dev/agents](https://codespar.dev/agents).\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-fa3448200221626ecddb4fc7d6a283b0"}