Sui Agent MCP

MCP (Model Context Protocol) server that provides Sui blockchain tools for Claude Code.

Features

• Wallet Control: Interact with Sui Agent Wallet for signing transactions
• Move Development: Build, test, and publish Move smart contracts
• On-chain Queries: Fetch object data and decompile contracts

Tools (14 total)

Wallet Tools

Tool	Description
sui_wallet_address	Get current wallet address
sui_wallet_balance	Check SUI balance
sui_wallet_accounts	List all derived accounts
sui_wallet_pending	View pending signing requests
sui_wallet_approve	Approve a pending transaction
sui_wallet_reject	Reject a pending transaction
sui_wallet_switch_network	Switch network (mainnet/testnet/devnet/localnet)
sui_wallet_sign_execute	Sign and execute unsigned transaction

CLI Tools

Tool	Description
sui_cli	Run any Sui CLI command
sui_move_build	Build a Move package
sui_move_test_coverage	Run tests with coverage analysis
sui_move_publish_unsigned	Generate unsigned publish transaction

Query Tools

Tool	Description
sui_object	Get information about a Sui object
sui_decompile	Get Suivision URL for package source

Installation

Prerequisites

1. Node.js 18+
2. Sui CLI installed and configured
3. Sui Agent Wallet (optional, for wallet tools): sui-skills

Add to Claude Code

# Option 1: Install from npm (recommended)
claude mcp add sui -- npx -y sui-agent-mcp

# Option 2: Clone and run locally
git clone https://github.com/EasonC13-agent/sui-mcp.git
cd sui-mcp
npm install
npm run build
claude mcp add sui -- node $(pwd)/dist/index.js

Verify Installation

claude mcp list
# Should show: sui

Configuration

Wallet Server URL

By default, the server connects to http://localhost:3847 for wallet operations. Override with environment variable:

SUI_WALLET_SERVER=http://localhost:3847 npx sui-mcp

Usage Examples

Once added to Claude Code, you can use natural language:

• "What's my Sui wallet address?"
• "Check my SUI balance"
• "Build the Move package at ./my-contract"
• "Run tests with coverage for the counter module"
• "Publish this contract to testnet"
• "Get info about object 0x123..."

Contract Deployment Workflow

1. Build: sui_move_build
2. Generate unsigned tx: sui_move_publish_unsigned
3. Sign and execute: sui_wallet_sign_execute

Related Projects

• sui-agent-wallet - Chrome extension + local server for AI-controlled Sui wallet
• sui-move skill - Sui Move development reference
• sui-coverage skill - Test coverage analysis
• sui-decompile skill - On-chain contract decompilation

License

MIT