Sui Butler

What it is

An MCP client library for the Sui blockchain that runs inside Claude Desktop and similar hosts. It covers two different jobs at once: moving value on Sui — balances, transfers, swaps, staking, SNS domains — and developing on it, by driving the Sui CLI for Move projects. It is non-custodial in both of its modes.

What you get

• Wallet reads: your address and every token balance — sui_get_wallet_address, sui_get_all_balances
• Transfers and swaps, with a quote you can inspect before the swap executes on the Cetus Aggregator — sui_transfer_token, sui_get_swap_quote, sui_swap_tokens
• Staking end to end: list active validators, stake, read your staked positions, unstake — sui_get_validators, sui_stake, sui_get_stake, sui_unstake
• Token deployment and SNS domains — mint a new token, look up a .sui domain record, register one — sui_deploy_token, sui_get_sns_name_record, sui_register_sns
• The Sui CLI as tools: create, build and test a Move project, publish a package, call a Move function, and manage which network and address the CLI is pointed at — sui_cli_move_new, sui_cli_move_build, sui_cli_move_test, sui_cli_publish, sui_cli_call, sui_cli_active_env, sui_cli_active_address, sui_cli_addresses, sui_cli_switch_address
• Live market data from Pyth price oracles — search for a feed, fetch prices by feed ID, or pull the common crypto prices in one call — pyth_search_price_feeds, pyth_get_prices, pyth_get_common_crypto_prices

Requirements

One of two credentials, and the choice changes how writes behave. Private Key mode takes --sui_private_key on the launch command and executes every operation, including transfers, without further approval — the client handles transactions locally and sends nothing to an external server. zkLogin mode takes --sui_access_key instead, obtained from the Sui Butler dashboard; reads such as balances and quotes work immediately, while transfers and swaps queue as pending and have to be approved in the dashboard. Either way you also pass --sui_network. The package is sui-butler (0.1.3 in package.json) and the documented launch is npx -y sui-butler. For the CLI tools to reach your Move project you also need a filesystem server loaded alongside it.

Setup effort

One command plus a key — npm install -g sui-butler, then supply credentials

Tools you get

24 tools named in the project's documentation.

Requires

npx on PATH

Where it runs

All 3 documented setups run the server on your machine.