universal-blockchain-mcp

ExpertVagabond/universal-blockchain-mcp

3.2

If you are the rightful owner of universal-blockchain-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Universal Blockchain MCP is a comprehensive server designed for universal blockchain development, offering full access to ZetaChain CLI, Foundry, and cross-chain functionality through AI assistants.

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