How do I install Universal Blockchain?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Universal Blockchain need an API key?

No required environment variable is listed on this record.

What transport does Universal Blockchain use?

Universal Blockchain runs locally over stdio.

When was Universal Blockchain last checked?

Last checked 2026-11-09. ZetaChain universal blockchain MCP server

Universal Blockchain MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add io.github.expertvagabond-universal-blockchain -- npx -y universal-blockchain-mcp@1.0.2

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.expertvagabond-universal-blockchain": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.0.2
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Universal Blockchain MCP

A comprehensive Model Context Protocol (MCP) server for universal blockchain development, providing full access to ZetaChain CLI, Foundry, and cross-chain functionality through AI assistants.

Features

🔐 Account Management

create_account: Create new ZetaChain accounts with mnemonic phrases
import_account: Import existing accounts using private keys or mnemonics
list_accounts: List all available ZetaChain accounts
show_account: Show detailed account information

💰 Balance & Token Operations

get_balances: Fetch native and ZETA token balances across chains
list_tokens: List all ZRC-20 tokens with addresses and chain info
request_faucet: Request testnet ZETA tokens from the faucet

🌐 Cross-Chain Operations

query_cctx: Query cross-chain transaction data in real-time
get_fees: Fetch omnichain and cross-chain messaging fees
call_contract: Call contracts on connected chains from ZetaChain
withdraw_tokens: Withdraw tokens from ZetaChain to connected chains
withdraw_and_call: Withdraw tokens and call contracts in one operation

⛓️ Network & Chain Information

list_chains: List all supported chains with IDs and token counts
get_network_info: Get current ZetaChain network status and information

🛠️ Development Tools

create_project: Create new universal contract projects with templates
check_foundry: Verify Foundry (forge, cast, anvil) installation and versions

🔧 Advanced Tools (65+ Available)

Foundry Integration: forge_build, forge_test, forge_create, forge_verify
Cast Operations: cast_call, cast_send, cast_balance, cast_nonce, cast_gas_price
Anvil Testing: anvil_start, anvil_snapshot, anvil_revert
ZetaChain Advanced: validator_create, governance_vote, staking_delegate, staking_rewards
Cross-Chain: cross_chain_send, cross_chain_status, bridge_status
Smart Contracts: contract_compile, contract_deploy, contract_interact
DeFi Operations: defi_swap, defi_liquidity_add, defi_yield_farm
NFT Operations: nft_mint, nft_transfer, nft_metadata
Wallet Management: wallet_export, wallet_backup, transaction_history
Security & Analysis: security_audit, gas_optimizer, multisig_create
Blockchain Tools: block_explorer, gas_tracker, portfolio_tracker

Note: Advanced tools provide full functionality when installed locally via NPM. Cloud versions provide helpful guidance and installation instructions.

Installation

🚀 Method 1: NPM Package (Recommended for Full Functionality)

One-Click Install with Auto-Setup:

npm install -g @ExpertVagabond/universal-blockchain-mcp

This automatically installs:

✅ ZetaChain CLI globally
✅ Foundry toolkit (forge, cast, anvil)
✅ All 65+ MCP tools with full functionality
✅ Complete development environment

Usage after installation:

# Run the MCP server
universal-blockchain-mcp

# Or use with Claude Desktop
# Add to Claude Desktop config:
{
  "mcpServers": {
    "universal-blockchain": {
      "command": "universal-blockchain-mcp",
      "args": []
    }
  }
}

🌐 Method 2: Smithery Cloud (Hosted)

Claude Code CLI:

claude mcp add --transport http universal-blockchain "https://server.smithery.ai/@ExpertVagabond/universal-blockchain-mcp/mcp"

Deep Link (HTTP):

claude://mcp/install?name=Universal%20Blockchain%20MCP&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fserver.smithery.ai%2F%40ExpertVagabond%2Funiversal-blockchain-mcp%2Fmcp%22%7D

Manual Configuration:

{
  "type": "http",
  "url": "https://server.smithery.ai/@ExpertVagabond/universal-blockchain-mcp/mcp"
}

Smithery Registry:

# Install via Smithery registry
SMITHERY_API_KEY=your_key smithery run @ExpertVagabond/universal-blockchain-mcp

📦 Method 3: Other MCP Registries

mcp.so Registry:

Visit: https://mcp.so
Search: "universal-blockchain-mcp"
One-click install available

PulseMCP Directory:

Visit: https://pulsemcp.com
Browse: Blockchain & Web3 category
Direct integration with Cursor, Claude, Cline

Glama Registry:

Visit: https://glama.ai
Search: "ZetaChain" or "blockchain"
Multi-tool ecosystem integration

Fleur (Mac + Claude):

Visit: https://fleur.ai
Zero-code MCP installation
Perfect for non-technical users

🔧 Method 4: Manual Configuration

stdio Configuration (Local):

{
  "type": "stdio", 
  "command": "npx",
  "args": ["-y", "@ExpertVagabond/universal-blockchain-mcp"]
}

Custom CLI Path:

{
  "type": "stdio",
  "command": "/path/to/universal-blockchain-mcp",
  "args": []
}

Manual Installation

Prerequisites

Node.js 18+
ZetaChain CLI (installed automatically)
Foundry (for smart contract development - installed automatically)

Quick Setup

# Clone and setup everything
git clone https://github.com/ExpertVagabond/zetachain-mcp-server.git
cd zetachain-mcp-server
npm run setup  # Installs dependencies, CLI, and builds project

Manual Setup

# 1. Clone repository
git clone https://github.com/ExpertVagabond/zetachain-mcp-server.git
cd zetachain-mcp-server

# 2. Install dependencies (includes ZetaChain CLI via npm)
npm install

# 3. Install ZetaChain CLI globally (optional, recommended)
npm install -g zetachain@latest

# 4. Build the project
npm run build

# 5. Run the server
npm start

Using Local ZetaChain Installation

If you have ZetaChain CLI installed locally, you can specify the path:

export ZETACHAIN_CLI_PATH=/path/to/zetachain
npm start

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Start production server
npm start

Usage Examples

Once added to Claude, you can use all ZetaChain functionality through natural language:

Account Management

Create a new ZetaChain account called "my-wallet"
Import my existing account using this private key: 0x...
Show me all my ZetaChain accounts

Cross-Chain Operations

Check ZETA balances for address 0x742d35Cc6634C0532925a3b8D5C20aE6f0f3FFaa
What are the current cross-chain fees from Ethereum to Polygon?
Query the status of cross-chain transaction 0xabc123...
Withdraw 100 ZETA from ZetaChain to Ethereum address 0x...

Token & Chain Information

List all supported chains on ZetaChain
Show me all ZRC-20 tokens
What tokens are available on BSC testnet?

Development

Create a new ZetaChain project called "my-dapp" 
Get testnet ZETA tokens for address 0x...
What's the current ZetaChain testnet status?

Supported Chains

ZetaChain MCP server supports all ZetaChain connected chains:

Ethereum (Sepolia Testnet)
BSC (Testnet)
Polygon (Amoy Testnet)
Avalanche (Fuji Testnet)
Arbitrum (Sepolia)
Base (Sepolia)
Bitcoin (Testnet/Signet)
Solana (Devnet)
TON (Testnet)
Sui (Testnet)
Kaia (Testnet)

Requirements

Node.js 18+
ZetaChain CLI (installed automatically as dependency)
Foundry (for smart contract development - installed automatically)

Architecture

This MCP server provides a bridge between AI assistants and the ZetaChain CLI, enabling:

Direct CLI Integration: All commands are executed through the official ZetaChain CLI
Real-time Data: Live blockchain data from ZetaChain networks
Cross-chain Functionality: Full access to ZetaChain's omnichain capabilities
Developer Tools: Project creation, account management, and testing utilities

License

MIT

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Universal Blockchain?

Does Universal Blockchain need an API key?

What transport does Universal Blockchain use?

When was Universal Blockchain last checked?

Documentation

Universal Blockchain MCP

Features

🔐 Account Management

💰 Balance & Token Operations

🌐 Cross-Chain Operations

⛓️ Network & Chain Information

🛠️ Development Tools

🔧 Advanced Tools (65+ Available)

Installation

🚀 Method 1: NPM Package (Recommended for Full Functionality)

🌐 Method 2: Smithery Cloud (Hosted)

📦 Method 3: Other MCP Registries

🔧 Method 4: Manual Configuration

Manual Installation

Prerequisites

Quick Setup

Manual Setup

Using Local ZetaChain Installation

Development

Usage Examples

Account Management

Cross-Chain Operations

Token & Chain Information

Development

Supported Chains

Requirements

Architecture

License