Sui Butler

by tamago-labs

Not rated
GitHub

About

An MCP server for the Sui blockchain ecosystem that bridges AI intelligence for simplified development. Supports both zkLogin and Private Key modes.

Details

Author
tamago-labs
Categories
Developer Tools

Setup

Install Sui Butler in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/tamago-labs/sui-butler

Follow the installation instructions in the repository README, then restart your MCP client.

Move tohttps://github.com/tamago-labs/sui-mcp

Sui Butleris a Model Context Protocol (MCP) server implementation for the Sui blockchain ecosystem that bridges AI intelligence for simplified development and more.

- YouTube Demo
-
Website
-
Presentation
-
NPM Registry
-
Backend Repo

The system is composed of two subsystems:

- Sui Butler Client– (This repository) A Node.js TypeScript library designed to run inside MCP-compatible AI model clients such as Claude Desktop. It enables AI agents to interact with the Sui blockchain.
- Sui Butler Backend– The backend system built using the AWS Serverless Stack. It includes backend services and a dashboard for issuing access keys and managing transactions in zkLogin mode.

- 30+ MCP tools covering account management, smart contract development, staking, token operations and market data
- Token swaps on Mainnet via the Cetus DEX Aggregator
- Pyth price oracle integration for real-time market data
- Sui CLI integration for smart contract development and testing
- Fully non-custodial, enables transactions using zkLogin wallets from the AI chat interface

There are two mode available: zkLogin (recommended for most new users) and Private Key (for advanced users).

In Private Key mode, all operations (including transfers and other write operations) will be executed automatically without requiring additional approval.
- Install Claude Desktop if you haven't already
- Open Claude Desktop settings
- Add the Sui MCP client to your configuration:

{ "mcpServers": { "sui-butler": { "command": "npx", "args": [ "-y", "sui-butler", "--sui_private_key=YOUR_PRIVATE_KEY", "--sui_network=mainnet" ], "disabled": false } } }

Private Key mode is recommended for advanced users who can securely manage their private keys. The MCP client handles transactions locally without exposing any data to external servers.

With zkLogin authentication, read operations (balance checks, quotes) work immediately, but write operations (transfers, swaps) require approval in the dashboard.
- Install Claude Desktop if you haven't already
- Open Claude Desktop settings
- Add the Sui MCP client to your configuration:

{ "mcpServers": { "sui-butler": { "command": "npx", "args": [ "-y", "sui-butler", "--sui_access_key=YOUR_ACCESS_KEY", "--sui_network=mainnet" ], "disabled": false } } }

The access key can be obtained from the dashboard. After logging in, a unique access key will be generated for each user.

Butler connects to Pyth price oracles and external sources to help you:

- Monitor real-time cryptocurrency prices across multiple assets
- Compare prices across different platforms for optimal trading opportunities
- Execute token swaps via Cetus Aggregator

2. Smart Contract Development & Testing Assistance

Butler integrates with the Sui CLI to help developers:

- Analyze existing Move code and suggest improvements
- Generate comprehensive test cases for smart contracts
- Publish and upgrade packages directly through AI conversation

3. Protocol Governance & Parameter Management

Butler assists DeFi protocol managers with:

- Checking external sources to determine optimal parameters based on current market conditions
- For example, in collateralization protocols, Butler can analyze asset prices to suggest better collateral ratio settings for smart contracts
- Then propose new governance parameters through AI conversations

Today, when building AI applications—especially those focused on crypto, we often rely on agent kits based on Langchain. These kits tightly couple the AI model and components, requiring frequent updates, otherwise, the application risks becoming non-functional within a few months or even weeks.

Model Context Protocol (MCP), introduced by Claude AI in late 2024, has quickly become popular today. It solves this issue by integrating directly with AI interfaces, allowing users to easily switch to the latest models and interact with Web3 through standardized tools.

When a user operates in zkLogin mode using an MCP-compatible AI client:
-

The client pushes a transaction request to the backend.

The transaction is stored in the database with a pending status.

The user can visit the dashboard to manually approve the transaction using their zkLogin-authenticated session.

If you're using Ubuntu or another Linux environment with NVM, you'll need to manually configure the path. Follow these steps:
- Install the Sui Butler under your current NVM-managed Node.js version.
- Due to how NVM installs libraries, you may need to use absolute paths in your config. Replace the example values below with your actual username and Node version:

{ "mcpServers": { "sui-mcp": { "command": "/home/YOUR_NAME/.nvm/versions/node/YOUR_NODE_VERSION/bin/node", "args": [ "/home/YOUR_NAME/.nvm/versions/node/YOUR_NODE_VERSION/bin/sui-butler", "--sui_access_key=YOUR_ACCESS_KEY", "--sui_network=mainnet" ] } } }

- Restart Claude Desktop and it should work now.

When working with local files especially when using Sui CLI tools for smart contract development to create, build, and test a Move package on your machine—you’ll need to import an additional MCP server library offilesystemmade by Claude team. Use with:

"filesystem": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-filesystem", "${workspaceFolder}" ], "disabled": false }

workspaceFolderrefers to your working directory. You can provide more than one argument. Subfolders or specific files can then be referenced in your AI prompt.

If you're using Linux and encounter issues during setup, please refer to the troubleshooting section.

This project is licensed under the MIT License.

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Create crafted UI components inspired by the best 21st.dev design engineers.

Bring agent evaluations, observability, and synthetic test set generation directly into your IDE for free with Galileo's new MCP server

An MCP server to help AI assistants to answer questions and generate AccelByte Extend SDK code more effectively .

MCP server for AI Diagram Maker — generate beautiful software engineering diagrams directly inside Cursor, Claude Desktop, Claude Code, or any MCP-compatible AI agent

ALAPI MCP Tools,Call hundreds of API interfaces via MCP

AI-powered SVG animation generator that transforms static files into animated SVG components using the Allyson platform

MCP server that gives AI assistants on-demand access to 1,500+ amCharts docs, ~300 code examples, and 1000+ class API references.

APIMatic MCP Server is used to validate OpenAPI specifications using APIMatic. The server processes OpenAPI files and returns validation summaries by leveraging APIMatic’s API.

One shared context layer for AI agents and humans — live API specs, DB schemas, and versioned contracts across repos so every agent and teammate works from the same source of truth.

Build and deploy full-stack Next.js apps with 98 tools for React, AWS, and MongoDB

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.