How do I install the sui butler mcp server?

Run it through your MCP client's configuration using `npx -y sui-butler`. Add the server block to Claude Desktop's config file (or use `claude mcp add` for Claude Code), restart the client, and the tools appear automatically. Full snippets are on this page.

What credentials does it need?

It reads `YOUR_PRIVATE_KEY`, `YOUR_ACCESS_KEY` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

Sui Butler MCP Server — Features, Setup & Tools

Name: Sui Butler MCP Server
Author: tamago-labs

What is the Sui Butler MCP server?

Most developer tooling work still happens through a UI a human drives. Sui Butler MCP server moves it into the conversation instead. Serverless-based MCP server implementation for Sui blockchain using zkLogin.

The short version

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

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

Getting it running

The server ships on npm as sui-butler, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

What it needs from you

Configuration is passed through the environment: YOUR_PRIVATE_KEY, YOUR_ACCESS_KEY. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

How it compares

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. It is maintained by tamago-labs; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Things to watch

It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

How to install the Sui Butler MCP server

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

Configuration as documented by the project. Restart the client after saving.

Configuration

Variable	Description	Required
YOUR_PRIVATE_KEY	Credential the server authenticates with.	Yes
YOUR_ACCESS_KEY	Credential the server authenticates with.	Yes

Frequently asked questions

It connects Sui Butler to MCP-compatible AI assistants such as Claude and Cursor. Instead of copying data back and forth by hand, the assistant works with Sui Butler directly.

Sui Butler MCP Server

What is the Sui Butler MCP server?

The short version

Getting it running

What it needs from you

How it compares

Things to watch

How to install the Sui Butler MCP server

Configuration

Frequently asked questions

Alternatives to the Sui Butler MCP server

Context7

Playwright

GitHub

Linear

Git

Time

Sui Butler MCP Server

What is the Sui Butler MCP server?

The short version

Getting it running

What it needs from you

How it compares

Things to watch

How to install the Sui Butler MCP server

Configuration

Frequently asked questions

What does the sui butler mcp server do?

How do I install the sui butler mcp server?

What credentials does it need?

Alternatives to the Sui Butler MCP server

Context7

Playwright

GitHub

Linear

Git

Time