Sui Trader MCP

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.