Kushki

What your agent can do

Kushki gives your agent 10 tools it calls directly — pick the ones it needs, in Claude, Cursor, or any MCP client.

• →tokenize_card — Exchange raw card data for a single-use token (POST /card/v1/tokens, public merchant id). The token feeds create_charge / create_preauthorization / create_subscription. Card data never touches your backend.
• →create_charge — One-step card charge (POST /card/v1/charges, private merchant id). Pass the token from tokenize_card plus the amount object. Supports metadata, months (MX installments) and deferred (installment plans).
• →create_preauthorization — Two-step charge, step 1: hold funds on the card (POST /card/v1/preAuthorization, private merchant id). Returns a ticketNumber to capture later.

// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("tokenize_card", { /* ... */ });

Install

$ npm install @codespar/mcp-kushki

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

{
  "mcpServers": {
    "kushki": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-kushki"
      ],
      "env": {
        "KUSHKI_PUBLIC_MERCHANT_ID": "<your_kushki_public_merchant_id>",
        "KUSHKI_PRIVATE_MERCHANT_ID": "<your_kushki_private_merchant_id>"
      }
    }
  }
}

After restart, your agent can call any of the 10 tools below — try tokenize_card first.

Environment variables · 3

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

Available tools · 10

Each tool is independent — your agent loads only what it needs to reduce context and response time.

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Frequently asked questions