The access-key path puts a human approval step in the dashboard between the model and any transfer; the private-key path removes it entirely, which is exactly what makes it convenient and exactly what makes it worth a decision rather than a default. Note before you start: the README now points onward to a successor repository at tamago-labs/sui-mcp, so check there for the current state of the project.
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.
- 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`
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.
One command plus a key — npm install -g sui-butler, then supply credentials