io.github.ExpertVagabond/universal-blockchain

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