Mcp Kushki

io.github.codesparPublished by GitHub account codesparv0.1.0Updated Oct 27, 2026

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

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Local MCP server for the Kushki LATAM payment provider, letting an assistant tokenize cards, charge, preauthorize, transfer, take cash payments and manage…

What you can do
  • Tokenize cards and create transfer tokens for PSE/SPEI bank transfers
  • Create one-step card charges, preauthorizations, captures and voids or refunds
  • Start bank transfer charges and issue cash vouchers for OXXO-style networks
  • Create and cancel recurring card subscriptions
When to use it
Useful when an assistant should drive Kushki payments for Mexico, Colombia, Chile, Peru or Ecuador — testing card, transfer, cash and subscription flows in the sandbox, or running real charges in production.
Requirements
Runs locally via npx from the npm package @codespar/mcp-kushki, configured in a desktop MCP client. Needs KUSHKI_PUBLIC_MERCHANT_ID and KUSHKI_PRIVATE_MERCHANT_ID, plus optional KUSHKI_ENV set to sandbox (default) or production. Network access to Kushki's API.
Before you install
The private merchant id moves money and must stay server-side; both ids are secrets passed as environment variables. Tools create real charges, holds, transfers and subscriptions, and voids or refunds, so production use spends money. Card data is sent to Kushki for tokenization. The README promotes a paid enterprise and managed tier.

Installation

In SourceWeft

  1. Open Mcp Kushki in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

Source: packages/payments/kushki/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts