Sui Trader MCP

1# Sui Trader MCP
2 
3An MCP server designed for AI agents to perform optimal token swaps on the Sui blockchain.
4 
5![License](https://img.shields.io/badge/license-MIT-blue.svg)
6![Node.js](https://img.shields.io/badge/Node.js-18.x-green.svg)
7![Status](https://img.shields.io/badge/status-active-brightgreen.svg)
8 
9## Features
10 
11- **Token Swaps**: Execute token swaps on Sui mainnet via the Cetus Aggregator.
12- **Bech32 Private Key Support**: Securely load a Sui private key (starting with `suiprivkey`) from environment variables.
13 
14## Prerequisites
15 
16- **Node.js**: Version 18.x or higher.
17- **npm**: For dependency management.
18- **Sui Wallet**: A Sui private key in bech32 format (starts with `suiprivkey`).
19 
20## Installation
21 
221. **Clone the Repository**:
23   ```bash
24   git clone https://github.com/kukapay/sui-trader-mcp.git
25   cd sui-trader-mcp
26   ```
27 
282. **Install Dependencies**:
29   ```bash
30   npm install
31   ```
32 
333. **Configure MCP Client**:
34    ```json
35    {
36      "mcpServers": {
37        "sui-trader": {
38          "command": "node",
39          "args": ["/absolute/path/to/sui-trader-mcp/index.js"],
40          "env": { "PRIVATE_KEY": "your_private_key" }
41          }
42        }
43      }
44    }
45    ```
46    Replace `/absolute/path/to/sui-trader-mcp/` with the actual installation path, and `your_private_key` with your Bech32-formatted private key..
47    
48## Usage
49 
50Use an MCP-compatible client to invoke the `swap` tool. 
51 
52### Example
53 
54Prompt:
55```
56Swap 1.5 SUI to USDC with 2% slippage, using a fixed input amount.
57```
58 
59Output:
60```
61Transaction ID: zjGekhLBfMYzGqu57fTeu3K1NX5jC5wNUy8rpdPcLyv. Status: success
62```
63 
64## License
65 
66This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
67 
68