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:

Terminal

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:

bash

# 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:

Terminal

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

Deep Link (HTTP):

Code

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:

config.json

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

Smithery Registry:

bash

# 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):

config.json

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

Custom CLI Path:

config.json

{
  "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

bash

# 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

bash

# 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:

server.ts

export ZETACHAIN_CLI_PATH=/path/to/zetachain
npm start

Development

bash

# 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

Code

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

Code

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

Code

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

Development

Code

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