Kushki MCP Server

A Model Context Protocol (MCP) server that enables AI assistants to interact with Kushki payment services.

Overview

This MCP server provides tools for AI assistants (Claude, ChatGPT, etc.) to execute Kushki payment operations through function calling. It uses the MCP standard protocol over stdio transport.

Installation

Using npx (recommended)

npx @kushki/mcp --public-key=YOUR_PUBLIC_KEY --private-key=YOUR_PRIVATE_KEY

Global installation

npm install -g @kushki/mcp
kushki-mcp --public-key=YOUR_PUBLIC_KEY --private-key=YOUR_PRIVATE_KEY

Authentication

The server requires both a public key and private key from your Kushki account.

CLI Flags

npx @kushki/mcp --public-key=YOUR_PUBLIC_KEY --private-key=YOUR_PRIVATE_KEY

Environment Variables

Alternatively, set environment variables:

export KUSHKI_PUBLIC_KEY=your_public_key
export KUSHKI_PRIVATE_KEY=your_private_key
npx @kushki/mcp

Note: CLI flags take precedence over environment variables.

Configuration with Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "kushki": {
      "command": "npx",
      "args": [
        "-y",
        "@kushki/mcp",
        "--public-key=YOUR_PUBLIC_KEY",
        "--private-key=YOUR_PRIVATE_KEY"
      ]
    }
  }
}

Or using environment variables:

{
  "mcpServers": {
    "kushki": {
      "command": "npx",
      "args": ["-y", "@kushki/mcp"],
      "env": {
        "KUSHKI_PUBLIC_KEY": "your_public_key",
        "KUSHKI_PRIVATE_KEY": "your_private_key"
      }
    }
  }
}

Getting Your API Keys

1. Log in to your Kushki Dashboard
2. Navigate to Developers > API Keys
3. Copy your Public Key and Private Key

For testing, use keys from your test environment.

Available Tools

Tools will be added in future releases. This version establishes the authentication foundation.

Development

Building

cd tools/modelcontextprotocol
npm install
npm run build

Testing

npm test

Running locally

node dist/index.js --public-key=YOUR_PUBLIC_KEY --private-key=YOUR_PRIVATE_KEY

Debugging the Server

To debug your server, you can use the MCP Inspector.

First build the server:

npm run build

Run the following command in your terminal:

npx @modelcontextprotocol/inspector node dist/index.js --public-key=YOUR_PUBLIC_KEY --private-key=YOUR_PRIVATE_KEY

Instructions

1. Replace YOUR_PUBLIC_KEY and YOUR_PRIVATE_KEY with your actual Kushki API keys.
2. Run the command to start the MCP Inspector.
3. Open the MCP Inspector UI in your browser and click Connect to start the MCP server.
4. You can see the list of tools you selected and test each tool individually.

Requirements

• Node.js >= 18
• Kushki account with API keys

License

MIT