io.github.codespar/mcp-kushki

io.github.codespar/mcp-kushki · 273 stars · TypeScript · MIT

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

Install

The repo has no one-line install. Follow its README.

Published as

npm@codespar/mcp-kushkistdio

From the server's entry in the official MCP Registry.

Open the repo

Configuration

Name	Set as	What it is
`KUSHKI_PUBLIC_MERCHANT_ID`Required · Secret	Env var	Kushki public merchant id (card/transfer tokenization)
`KUSHKI_PRIVATE_MERCHANT_ID`Required · Secret	Env var	Kushki private merchant id (charges, captures, voids, subscriptions)
`KUSHKI_ENV`Optional	Env var	Environment: 'sandbox' (api-uat) or 'production'. Defaults to 'sandbox'.

Files

packages/payments/kushki/README.md

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

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.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

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)

Tool	Endpoint	What it does
`tokenize_card`	`POST /card/v1/tokens`	Raw card → single-use token (public id)
`create_charge`	`POST /card/v1/charges`	One-step card charge
`create_preauthorization`	`POST /card/v1/preAuthorization`	Hold funds (two-step, step 1)
`capture_preauthorization`	`POST /card/v1/capture`	Capture a preauth (step 2, partial OK)
`void_charge`	`DELETE /card/v1/charges/{ticket}`	Void (same-day) or refund (settled)
`create_transfer_token`	`POST /transfer/v1/tokens`	Token for PSE (CO) / SPEI (MX) transfer-in
`create_transfer_charge`	`POST /transfer/v1/init`	Start the bank transfer; returns redirect URL
`create_cash_charge`	`POST /cash/v1/charges`	Cash voucher for OXXO-style networks
`create_subscription`	`POST /card/v1/subscriptions`	Recurring card charge on a periodicity
`cancel_subscription`	`DELETE /card/v1/subscriptions/{id}`	Stop future charges

Authentication

Two merchant ids with distinct powers:

Variable	Required	Description
`KUSHKI_PUBLIC_MERCHANT_ID`	yes	Tokenization only — safe for client-side use
`KUSHKI_PRIVATE_MERCHANT_ID`	yes	Money movement — server-side only
`KUSHKI_ENV`	no	`sandbox` (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

Facts

Kind: MCP server
Repo: codespar/mcp-dev-latam
Group: Uncategorized
Stars: 273
License: MIT
Language: TypeScript
Last push: 2026-09-27
Forks: 50
MCP Registry: io.github.codespar/mcp-kushki
Homepage: codespar.dev/servers
Topics: agentic-commerce, ai-agents, brazil, claude, fintech, latin-america, llm-tools, mcp, model-context-protocol, nfe, open-finance, payments, pix