Sui Trader

Providing token swap capabilities on the Sui mainnet via Cetus Aggregator, loading a Bech32 private key from environment variables.

javascript

4

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You run an MCP server named Sui Trader MCP Server that enables AI agents to perform optimal token swaps on the Sui blockchain via the Cetus Aggregator. It securely loads a Sui private key from environment variables and exposes a simple, MCP-compatible interface to execute swaps.

How to use

Use an MCP-compatible client to invoke the swap tool. You will provide your swap parameters (amounts, assets, slippage, and flow) and the server will execute the token swap on Sui mainnet through the Cetus Aggregator. Ensure your private key is loaded via the configured environment variable so the server can sign transactions.

How to install

Prerequisites you need before installing the server:

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

Step-by-step installation commands:

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

Configuration and running

Configure the MCP client to load your private key and point to the local or remote MCP server as needed. The following configuration creates an MCP server entry that runs the Node.js script directly and passes your private key via an environment variable.

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

Usage notes and security

Keep your private key secure. Do not share the PRIVATE_KEY value and consider loading it from a secure secret manager in production.
The server uses the Cetus Aggregator to perform token swaps on the Sui mainnet. Validate all swap parameters before invoking the swap tool.

Available tools

swap

Execute token swaps on the Sui mainnet using the Cetus Aggregator and return a transaction ID and status.