sui

The Sui MCP Server provides wallet management, balance and object queries, transaction operations, network switching, and utility functions for the Sui blockchain. It exposes a set of MCP tools that let you create and manage wallets, query SUI balances and objects, transfer SUI or objects, and switch between networks such as mainnet, testnet, devnet, and localnet. Typical workflows include creating wallets from mnemonic phrases, importing existing wallets, inspecting balances and owned objects, and performing transfers. The server is designed to integrate with the MCP SDK, enabling programmatic access to wallet management, transaction handling, and network operations through the available tools such as create_wallet, transfer_sui, get_balance, switch_network, and get_wallet_transactions. You can operate the server via the included CLI (sui-mcp-server) or by invoking individual tools exposed by the MCP API.

Prerequisites:

• Node.js (LTS) and npm installed on your system
• Basic familiarity with command line usage

Install from NPM (global):

npm install -g @ExpertVagabond/sui-mcp-server

Alternatively, install from source:

git clone https://github.com/ExpertVagabond/sui-mcp-server.git
cd sui-mcp-server
npm install
npm run build

Run the MCP server (CLI):

sui-mcp-server

Development workflow (optional):

npm run dev

Test suite (optional):

npm test

Notes:

• Ensure your environment has network access to the Sui network endpoints.
• If you plan to store private keys, consider secure storage solutions and access controls.

Environment considerations:

• This server stores private keys in memory during runtime. For production, implement secure key storage and access controls.
• When switching networks, ensure the target network is reachable and you have the correct chain ID and faucet access for test/dev nets.
• Monitor resources (memory/CPU) since wallet signing and key handling can be sensitive to performance constraints.

Configuration tips:

• Use the provided utility functions for address validation and normalization to avoid formatting errors.
• For test networks, you can request test tokens from the faucet to enable initial transactions.
• Review the MCP SDK integration guidelines to understand the available API surfaces and their expected input shapes.