ZetaChain CLI

A command-line interface for building and interacting with ZetaChain universal applications. Seamlessly interact with EVM, Solana, Bitcoin, Sui, and TON, all from one CLI.

✨ Features

Scaffold new ZetaChain universal apps from templates
Spin up a local multi-chain development environment (EVM, Solana, etc.) in one command
Query cross-chain fees, contracts, balances, cross-chain transaction, tokens, and more
Make cross-chain calls between Solana, Sui, Bitcoin, TON, and universal apps on ZetaChain
Transfer supported tokens across connected chains

✅ Prerequisites

Node.js ≥ 18
Git (for template cloning)
(Optional) Docker ≥ 24 for localnet

🚀 Quick Start

Run without installing:

npx zetachain@next new

Or install globally:

npm install -g zetachain@latest

Use zetachain@next for bleeding-edge builds.

📘 Examples

Create a new project:

zetachain new

Start localnet:

zetachain localnet start

Query cross-chain balances:

zetachain query balances

🤖 MCP Server Installation

The ZetaChain CLI can be used as an MCP (Model Context Protocol) server, allowing AI assistants like Claude Code and Cursor to execute ZetaChain commands.

Local Installation (Recommended)

Install locally for full access to your filesystem, accounts, and localnet:

npm install -g zetachain
zetachain mcp install --client claude    # for Claude Code
# or
zetachain mcp install --client cursor    # for Cursor

Then restart your AI editor to activate the MCP server.

Check installation status:

zetachain mcp list

Remove:

zetachain mcp remove --client claude

Cloud Installation (Smithery)

For quick setup without local installation, visit Smithery and click "One-Click Install".

⚠️ Note: The cloud version runs on remote servers and cannot access your local files, accounts, or localnet.

🧭 CLI Reference

For full command documentation:

zetachain docs

Or use --help with any command:

zetachain accounts --help

🤝 Contributing

We welcome contributions! Please open issues or submit pull requests.

universal-blockchain