README.md•1.71 kB
# 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**:
```bash
git clone https://github.com/kukapay/sui-trader-mcp.git
cd sui-trader-mcp
```
2. **Install Dependencies**:
```bash
npm install
```
3. **Configure MCP Client**:
```json
{
"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](LICENSE) file for details.