Sui Trader MCP

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

Features

Token Swaps: Execute token swaps on Sui mainnet via the Cetus Aggregator.
Bech32 Private Key Support: Securely load a Sui private key (starting with suiprivkey) from environment variables.

Prerequisites

Node.js: Version 18.x or higher.
npm: For dependency management.
Sui Wallet: A Sui private key in bech32 format (starts with suiprivkey).

Installation

Clone the Repository:

git clone https://github.com/kukapay/sui-trader-mcp.git
cd sui-trader-mcp

Install Dependencies:
```
npm install
```

Configure MCP Client:

{
  "mcpServers": {
    "sui-trader": {
      "command": "node",
      "args": ["/absolute/path/to/sui-trader-mcp/index.js"],
      "env": { "PRIVATE_KEY": "your_private_key" }
      }
    }
  }
}

Replace /absolute/path/to/sui-trader-mcp/ with the actual installation path, and your_private_key with your Bech32-formatted private key..

Usage

Use an MCP-compatible client to invoke the swap tool.

Example

Prompt:

Swap 1.5 SUI to USDC with 2% slippage, using a fixed input amount.

Output:

Transaction ID: zjGekhLBfMYzGqu57fTeu3K1NX5jC5wNUy8rpdPcLyv. Status: success

License

This project is licensed under the MIT License. See the LICENSE file for details.

sui-trader-mcp

README Documentation