Mcp Kushki

io.github.codespar由 GitHub 帳號 codespar 發布v0.1.0更新於 Oct 27, 2026

MCP server for Kushki — LATAM PSP: card charges, preauth, PSE/SPEI transfer, cash, subscriptions

已驗證STDIO僅桌面金融商業與電商

概覽

AI 產生的概覽

針對 Kushki 拉丁美洲支付服務商的本地 MCP 伺服器，讓助理完成卡片權杖化、扣款、預先授權、轉帳、現金付款與訂閱管理。

可以做什麼
  • 將信用卡權杖化，並為 PSE/SPEI 銀行轉帳產生權杖
  • 建立單步卡片扣款、預先授權、請款以及作廢或退款
  • 發起銀行轉帳扣款，並產生 OXXO 類現金付款憑證
  • 建立與取消週期性卡片訂閱
適用情境
適合需要讓助理操作墨西哥、哥倫比亞、智利、秘魯或厄瓜多 Kushki 付款的情境，例如在沙箱測試卡片、轉帳、現金與訂閱流程，或在正式環境發起真實扣款。
執行需求
透過 npx 從 npm 套件 @codespar/mcp-kushki 在本機執行，需在桌面 MCP 用戶端中設定。需要 KUSHKI_PUBLIC_MERCHANT_ID 與 KUSHKI_PRIVATE_MERCHANT_ID，另可選擇以 KUSHKI_ENV 設為 sandbox（預設）或 production。需要連線至 Kushki API 的網路。
安裝前請注意
私有商家 ID 可動用資金，必須僅在伺服器端使用；兩個 ID 都是透過環境變數傳入的密鑰。相關工具會建立真實扣款、資金凍結、轉帳與訂閱，並可作廢或退款，正式環境使用會實際花費金錢。卡號資料會傳送給 Kushki 進行權杖化。README 另推廣付費的企業版與代管服務。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Kushki，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@codespar/mcp-kushki

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.

[npm] [License: MIT]

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json
{  "mcpServers": {    "kushki": {      "command": "npx",      "args": ["-y", "@codespar/mcp-kushki"],      "env": {        "KUSHKI_PUBLIC_MERCHANT_ID": "your-public-merchant-id",        "KUSHKI_PRIVATE_MERCHANT_ID": "your-private-merchant-id",        "KUSHKI_ENV": "sandbox"      }    }  }}

Claude Code

bash
claude mcp add kushki --env KUSHKI_PUBLIC_MERCHANT_ID=... --env KUSHKI_PRIVATE_MERCHANT_ID=... -- npx -y @codespar/mcp-kushki

Cursor / VS Code

Add the same block to .cursor/mcp.json or .vscode/mcp.json.

Tools (10)

ToolEndpointWhat it does
tokenize_cardPOST /card/v1/tokensRaw card → single-use token (public id)
create_chargePOST /card/v1/chargesOne-step card charge
create_preauthorizationPOST /card/v1/preAuthorizationHold funds (two-step, step 1)
capture_preauthorizationPOST /card/v1/captureCapture a preauth (step 2, partial OK)
void_chargeDELETE /card/v1/charges/{ticket}Void (same-day) or refund (settled)
create_transfer_tokenPOST /transfer/v1/tokensToken for PSE (CO) / SPEI (MX) transfer-in
create_transfer_chargePOST /transfer/v1/initStart the bank transfer; returns redirect URL
create_cash_chargePOST /cash/v1/chargesCash voucher for OXXO-style networks
create_subscriptionPOST /card/v1/subscriptionsRecurring card charge on a periodicity
cancel_subscriptionDELETE /card/v1/subscriptions/{id}Stop future charges

Authentication

Two merchant ids with distinct powers:

VariableRequiredDescription
KUSHKI_PUBLIC_MERCHANT_IDyesTokenization only — safe for client-side use
KUSHKI_PRIVATE_MERCHANT_IDyesMoney movement — server-side only
KUSHKI_ENVnosandbox (api-uat, default) or production

Amounts use Kushki's per-country tax shape: { subtotalIva, subtotalIva0, iva, currency } — currencies MXN, COP, CLP, PEN, USD.

Example

"Tokenize this test card and charge COP 85,000 with 19% IVA."

The agent calls tokenize_card, then create_charge with { subtotalIva: 85000, subtotalIva0: 0, iva: 16150, currency: "COP" }.

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.

Managed tier

This 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.

License

MIT

來源：packages/payments/kushki/README.md，提交 d0a519a

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分