{
  "markdown": "# Universal Blockchain MCP\n\nA comprehensive Model Context Protocol (MCP) server for universal blockchain development, providing full access to ZetaChain CLI, Foundry, and cross-chain functionality through AI assistants.\n\n## Features\n\n### 🔐 Account Management\n- **create_account**: Create new ZetaChain accounts with mnemonic phrases\n- **import_account**: Import existing accounts using private keys or mnemonics  \n- **list_accounts**: List all available ZetaChain accounts\n- **show_account**: Show detailed account information\n\n### 💰 Balance & Token Operations\n- **get_balances**: Fetch native and ZETA token balances across chains\n- **list_tokens**: List all ZRC-20 tokens with addresses and chain info\n- **request_faucet**: Request testnet ZETA tokens from the faucet\n\n### 🌐 Cross-Chain Operations\n- **query_cctx**: Query cross-chain transaction data in real-time\n- **get_fees**: Fetch omnichain and cross-chain messaging fees\n- **call_contract**: Call contracts on connected chains from ZetaChain\n- **withdraw_tokens**: Withdraw tokens from ZetaChain to connected chains\n- **withdraw_and_call**: Withdraw tokens and call contracts in one operation\n\n### ⛓️ Network & Chain Information\n- **list_chains**: List all supported chains with IDs and token counts\n- **get_network_info**: Get current ZetaChain network status and information\n\n### 🛠️ Development Tools  \n- **create_project**: Create new universal contract projects with templates\n- **check_foundry**: Verify Foundry (forge, cast, anvil) installation and versions\n\n### 🔧 **Advanced Tools (65+ Available)**\n- **Foundry Integration**: forge_build, forge_test, forge_create, forge_verify\n- **Cast Operations**: cast_call, cast_send, cast_balance, cast_nonce, cast_gas_price\n- **Anvil Testing**: anvil_start, anvil_snapshot, anvil_revert\n- **ZetaChain Advanced**: validator_create, governance_vote, staking_delegate, staking_rewards\n- **Cross-Chain**: cross_chain_send, cross_chain_status, bridge_status\n- **Smart Contracts**: contract_compile, contract_deploy, contract_interact\n- **DeFi Operations**: defi_swap, defi_liquidity_add, defi_yield_farm\n- **NFT Operations**: nft_mint, nft_transfer, nft_metadata\n- **Wallet Management**: wallet_export, wallet_backup, transaction_history\n- **Security & Analysis**: security_audit, gas_optimizer, multisig_create\n- **Blockchain Tools**: block_explorer, gas_tracker, portfolio_tracker\n\n> **Note**: Advanced tools provide full functionality when installed locally via NPM. Cloud versions provide helpful guidance and installation instructions.\n\n## Installation\n\n### 🚀 **Method 1: NPM Package (Recommended for Full Functionality)**\n\n**One-Click Install with Auto-Setup:**\n```bash\nnpm install -g @ExpertVagabond/universal-blockchain-mcp\n```\n\nThis automatically installs:\n- ✅ ZetaChain CLI globally\n- ✅ Foundry toolkit (forge, cast, anvil)\n- ✅ All 65+ MCP tools with full functionality\n- ✅ Complete development environment\n\n**Usage after installation:**\n```bash\n# Run the MCP server\nuniversal-blockchain-mcp\n\n# Or use with Claude Desktop\n# Add to Claude Desktop config:\n{\n  \"mcpServers\": {\n    \"universal-blockchain\": {\n      \"command\": \"universal-blockchain-mcp\",\n      \"args\": []\n    }\n  }\n}\n```\n\n### 🌐 **Method 2: Smithery Cloud (Hosted)**\n\n**Claude Code CLI:**\n```bash\nclaude mcp add --transport http universal-blockchain \"https://server.smithery.ai/@ExpertVagabond/universal-blockchain-mcp/mcp\"\n```\n\n**Deep Link (HTTP):**\n```\nclaude://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\n```\n\n**Manual Configuration:**\n```json\n{\n  \"type\": \"http\",\n  \"url\": \"https://server.smithery.ai/@ExpertVagabond/universal-blockchain-mcp/mcp\"\n}\n```\n\n**Smithery Registry:**\n```bash\n# Install via Smithery registry\nSMITHERY_API_KEY=your_key smithery run @ExpertVagabond/universal-blockchain-mcp\n```\n\n### 📦 **Method 3: Other MCP Registries**\n\n**mcp.so Registry:**\n- Visit: https://mcp.so\n- Search: \"universal-blockchain-mcp\"\n- One-click install available\n\n**PulseMCP Directory:**\n- Visit: https://pulsemcp.com\n- Browse: Blockchain & Web3 category\n- Direct integration with Cursor, Claude, Cline\n\n**Glama Registry:**\n- Visit: https://glama.ai\n- Search: \"ZetaChain\" or \"blockchain\"\n- Multi-tool ecosystem integration\n\n**Fleur (Mac + Claude):**\n- Visit: https://fleur.ai\n- Zero-code MCP installation\n- Perfect for non-technical users\n\n### 🔧 **Method 4: Manual Configuration**\n\n**stdio Configuration (Local):**\n```json\n{\n  \"type\": \"stdio\", \n  \"command\": \"npx\",\n  \"args\": [\"-y\", \"@ExpertVagabond/universal-blockchain-mcp\"]\n}\n```\n\n**Custom CLI Path:**\n```json\n{\n  \"type\": \"stdio\",\n  \"command\": \"/path/to/universal-blockchain-mcp\",\n  \"args\": []\n}\n```\n\n### Manual Installation\n\n#### Prerequisites\n- Node.js 18+\n- ZetaChain CLI (installed automatically)\n- Foundry (for smart contract development - installed automatically)\n\n#### Quick Setup\n```bash\n# Clone and setup everything\ngit clone https://github.com/ExpertVagabond/zetachain-mcp-server.git\ncd zetachain-mcp-server\nnpm run setup  # Installs dependencies, CLI, and builds project\n```\n\n#### Manual Setup\n```bash\n# 1. Clone repository\ngit clone https://github.com/ExpertVagabond/zetachain-mcp-server.git\ncd zetachain-mcp-server\n\n# 2. Install dependencies (includes ZetaChain CLI via npm)\nnpm install\n\n# 3. Install ZetaChain CLI globally (optional, recommended)\nnpm install -g zetachain@latest\n\n# 4. Build the project\nnpm run build\n\n# 5. Run the server\nnpm start\n```\n\n#### Using Local ZetaChain Installation\nIf you have ZetaChain CLI installed locally, you can specify the path:\n```bash\nexport ZETACHAIN_CLI_PATH=/path/to/zetachain\nnpm start\n```\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Run in development mode\nnpm run dev\n\n# Build for production\nnpm run build\n\n# Start production server\nnpm start\n```\n\n## Usage Examples\n\nOnce added to Claude, you can use all ZetaChain functionality through natural language:\n\n### Account Management\n```\nCreate a new ZetaChain account called \"my-wallet\"\nImport my existing account using this private key: 0x...\nShow me all my ZetaChain accounts\n```\n\n### Cross-Chain Operations\n```\nCheck ZETA balances for address 0x742d35Cc6634C0532925a3b8D5C20aE6f0f3FFaa\nWhat are the current cross-chain fees from Ethereum to Polygon?\nQuery the status of cross-chain transaction 0xabc123...\nWithdraw 100 ZETA from ZetaChain to Ethereum address 0x...\n```\n\n### Token & Chain Information  \n```\nList all supported chains on ZetaChain\nShow me all ZRC-20 tokens\nWhat tokens are available on BSC testnet?\n```\n\n### Development\n```\nCreate a new ZetaChain project called \"my-dapp\" \nGet testnet ZETA tokens for address 0x...\nWhat's the current ZetaChain testnet status?\n```\n\n## Supported Chains\n\nZetaChain MCP server supports all ZetaChain connected chains:\n\n- **Ethereum** (Sepolia Testnet)\n- **BSC** (Testnet) \n- **Polygon** (Amoy Testnet)\n- **Avalanche** (Fuji Testnet)\n- **Arbitrum** (Sepolia)\n- **Base** (Sepolia)\n- **Bitcoin** (Testnet/Signet)\n- **Solana** (Devnet)\n- **TON** (Testnet)\n- **Sui** (Testnet)\n- **Kaia** (Testnet)\n\n## Requirements\n\n- Node.js 18+\n- ZetaChain CLI (installed automatically as dependency)\n- Foundry (for smart contract development - installed automatically)\n\n## Architecture\n\nThis MCP server provides a bridge between AI assistants and the ZetaChain CLI, enabling:\n\n- **Direct CLI Integration**: All commands are executed through the official ZetaChain CLI\n- **Real-time Data**: Live blockchain data from ZetaChain networks  \n- **Cross-chain Functionality**: Full access to ZetaChain's omnichain capabilities\n- **Developer Tools**: Project creation, account management, and testing utilities\n\n## License\n\nMIT",
  "bytes": 7741,
  "sha": "69c997bfd211b132006cd3446dd5d6c9b23bf6313978313ec318cd20318e2040",
  "repo_slug": "expertvagabond/universal-blockchain-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_expertvagabond_universal_block_59bcb8a5/readme"
}