Sui Trader MCP

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

1. Clone the Repository:

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

2. Install Dependencies:

    npm install

3. 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.