# kukapay/sui-trader-mcp [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/kukapay/sui-trader-mcp  
**GitHub Stars:** 6  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/kukapay-sui-trader-mcp

## Description
An MCP server designed for AI agents to perform optimal token swaps on the Sui blockchain.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "sui-trader-mcp": {
    "command": "npx",
    "args": ["-y","kukapay-sui-trader-mcp"],
    "env": {
      "PRIVATE_KEY": ""
    }
  }
}
```

**Requires environment variables:** `PRIVATE_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What kukapay/sui-trader-mcp MCP server does

The kukapay/sui-trader-mcp MCP server exposes Sui mainnet token swapping to an AI agent through the Model Context Protocol. Its documented trading operation is the `swap` tool, which sends a swap transaction through the Cetus Aggregator. The README demonstrates a request to exchange 1.5 SUI for USDC with 2% slippage and a fixed input amount, followed by a transaction ID and success status.

This is intended for workflows where an MCP-compatible client needs to initiate an on-chain swap using a configured Sui wallet. It is not described as a portfolio tracker, price feed, balance viewer, or general-purpose Sui development server.

## How it works

The process runs locally with Node.js. After dependencies are installed, an MCP client starts the project’s `index.js` entry point. The server reads the wallet credential from the `PRIVATE_KEY` environment variable. The expected value is a Sui private key in Bech32 format, identified by the `suiprivkey` prefix.

When the client invokes `swap`, the server uses the configured wallet and Cetus Aggregator to execute the requested trade on Sui mainnet. A successful operation returns a transaction ID and status, as shown in the repository example. The material does not specify additional confirmation, simulation, routing, or wallet-management tools.

## Setup and configuration

The kukapay/sui-trader-mcp MCP server requires Node.js 18.x or newer and npm. The documented setup is:

1. Clone the repository.
2. Change into the project directory.
3. Run `npm install` to install dependencies.
4. Configure the MCP client to launch `node` with the absolute path to `index.js`.
5. Add `PRIVATE_KEY` to the client’s server environment configuration.

The private key should be supplied as a Bech32 Sui key rather than as an unspecified raw key format. The README uses a placeholder path and key value in its configuration example; those values must be replaced with the local installation path and the wallet key before use.

## Tools and capabilities

The kukapay/sui-trader-mcp MCP server documents one MCP tool:

- `swap`: Executes a Sui mainnet token swap through the Cetus Aggregator.

The example shows support for selecting the input and output tokens, providing an input amount, setting slippage, and choosing a fixed input amount. The result includes a blockchain transaction ID and a success status when the transaction succeeds.

## Limitations and notes

A valid Sui private key is required, so this server can submit transactions from the configured wallet. Keep `PRIVATE_KEY` out of source control and restrict access to the MCP client configuration that contains it. The README only documents Sui mainnet swaps and does not describe testnet support, transaction cancellation, balances, history, or other trading operations. The repository is licensed under MIT.

_Full upstream README: https://allmcps.com/mcp/kukapay-sui-trader-mcp/readme_