Universal Blockchain

You gain a powerful MCP server that bridges AI assistants with ZetaChain’s CLI, Foundry, and cross-chain capabilities. It enables you to manage accounts, inspect balances and tokens, perform cross-chain actions, and develop with an integrated toolchain all from a single, extensible interface.

How to use

You can interact with the Universal Blockchain MCP server through an MCP client by connecting to the local or remote server configuration. Once connected, you access ZetaChain functionality such as account management, balance checks, token operations, cross-chain calls, contract interactions, and development tooling. Use natural language prompts or CLI-compatible requests to perform actions like creating a new ZetaChain account, querying balances, or deploying and testing smart contracts across supported chains.

Typical usage patterns include: creating and importing accounts, querying native and ZETA balances across chains, listing supported chains and tokens, issuing cross-chain transfers or contract calls, and leveraging Foundry-based tooling for building, testing, and deploying smart contracts. You can also run development workflows to scaffold projects, verify Foundry installations, and perform security analyses or optimizations as part of your workflow.

How to install

Prerequisites you need before installation include Node.js 18 or newer and an active environment where you can install npm packages. ZetaChain CLI and Foundry tooling are installed automatically as part of the MCP setup process.

Step 1: Install the MCP package globally. This brings in the MCP server, the ZetaChain CLI, Foundry tooling, and all 65+ MCP tools.

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

Step 2: Run the MCP server locally. This starts the server so you can begin issuing commands immediately.

universal-blockchain-mcp

Optional configuration for integration with Claude Desktop involves adding the MCP server to your Claude config. The following example shows how to register the server with an empty argument list.

{
  "mcpServers": {
    "universal-blockchain": {
      "command": "universal-blockchain-mcp",
      "args": []
    }
  }
}

Additional notes

Development and usage rely on a modern Node.js environment. If you already have a local ZetaChain CLI installed, you can point the MCP to that binary by setting the ZETACHAIN_CLI_PATH environment variable before starting the server.

The MCP server provides real-time access to cross-chain functionality, contract orchestration, and a rich set of development tools. For best results, ensure your environment has internet access and any required API keys or access credentials configured as needed by external services you intend to use with cross-chain operations.

Supported chains

The MCP server supports all ZetaChain connected chains, including Ethereum, BSC, Polygon, Avalanche, Arbitrum, Base, Bitcoin, Solana, TON, Sui, and Kaia testnets or devnets where available.

Security and troubleshooting

Keep your private keys and mnemonic phrases secure. Use environment-based secret management for credentials and avoid exposing sensitive information in logs or shared configurations.

If you encounter startup issues, verify Node.js version compatibility, ensure npm global installations are allowed by your environment, and confirm that the MCP server command is accessible in your shell. Review console logs for any dependency installation errors and re-run installation steps if necessary.

Available tools

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.

get_balances

Fetch native and ZETA token balances across chains.

list_tokens

List all ZRC-20 tokens with addresses and chain information.

request_faucet

Request testnet ZETA tokens from the faucet.

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.

list_chains

List all supported chains with IDs and token counts.

get_network_info

Get current ZetaChain network status and information.

create_project

Create new universal contract projects with templates.

check_foundry

Verify Foundry installation and versions.

forge_build

Build Foundry projects.

forge_test

Run Foundry tests.

forge_create

Create Foundry projects or artifacts.

forge_verify

Verify Foundry artifacts.

cast_call

Call contracts using Foundry's cast.

cast_send

Send transactions using Foundry's cast.

cast_balance

Check balances with Foundry tools.

cast_nonce

Retrieve transaction nonces with Foundry.

cast_gas_price

Check current gas prices via Foundry.

anvil_start

Start an Anvil local node for testing.

anvil_snapshot

Take a snapshot of Anvil state.

anvil_revert

Revert Anvil to a previous snapshot.

validator_create

Create a ZetaChain validator.

governance_vote

Cast governance votes on ZetaChain proposals.

staking_delegate

Delegate staking on ZetaChain.

staking_rewards

Query staking rewards on ZetaChain.

cross_chain_send

Send assets across chains.

cross_chain_status

Check cross-chain transfer status.

bridge_status

Check bridge status between chains.

contract_compile

Compile smart contracts.

contract_deploy

Deploy contracts to connected chains.

contract_interact

Interact with deployed contracts.

defi_swap

Perform DeFi token swaps.

defi_liquidity_add

Add liquidity to DeFi pools.

defi_yield_farm

Participate in yield farming strategies.

nft_mint

Mint new NFTs.

nft_transfer

Transfer NFTs between accounts.

nft_metadata

Query NFT metadata.

wallet_export

Export wallet data.

wallet_backup

Backup wallet data.

transaction_history

Retrieve transaction history.

security_audit

Perform a security audit on contracts and configurations.

gas_optimizer

Optimize gas usage in interactions.

multisig_create

Create multisignature wallets.

block_explorer

Explore blocks and transactions on chains.

gas_tracker

Track gas usage across operations.

portfolio_tracker

Track token portfolios across chains.