sui-wallet

Use when performing on-chain transactions (transfer, Move call, publish) through the agent wallet. Triggers on wallet operations, transaction signing, or deployment requests.

MCP Wallet Tools

The following MCP tools are available via the sui-dev-mcp server:

Transaction Flow

All wallet tools follow a dry-run → approve → execute flow:

1. •Agent calls MCP tool → tool runs sui client ... --dry-run internally
2. •MCP returns summary with status: "PENDING_APPROVAL" including:
   • •Network, signer, gas estimate
   • •Effects preview (object changes, balance changes)
   • •The CLI command to execute
3. •Agent presents summary to user for review
4. •User approves in Claude Code
5. •Agent executes the command from execute_args

Safety Rules

• •NEVER execute a transaction without showing the dry-run summary first
• •ALWAYS confirm the network (testnet vs mainnet) before executing
• •ALWAYS use MCP wallet tools instead of direct sui client CLI when possible
• •The tx-approval-guard hook will warn if direct CLI signing is attempted

Examples

Check wallet status

Use the sui_wallet_status MCP tool.

Transfer SUI

Use sui_wallet_transfer with recipient and amount.
Review the dry-run output, then execute the command if user approves.

Publish package

Use sui_wallet_publish with the package path.
Review gas cost and effects, then execute if user approves.

Call Move function

Use sui_wallet_call with package_id, module, function_name, and args.
Review the effects preview, then execute if user approves.