Zetrix MCP Server

╔════════════════════════════════════════════════════════════════════╗ ║ ║ ║ ✨ ZETRIX MCP SERVER - INSTALLATION COMPLETE! ✨ ║ ║ ║ ╚════════════════════════════════════════════════════════════════════╝ 📁 Project Location: /mnt/d/Projects/mcp/zetrix ✅ WHAT'S BEEN CREATED ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1. ✓ Complete MCP Server (24 tools) 2. ✓ HTTP Client (13 Zetrix APIs) 3. ✓ WebSocket Client (5 real-time APIs) 4. ✓ Comprehensive Test Suite 5. ✓ Interactive Setup Wizard 6. ✓ Pre-made Configuration Files 7. ✓ Complete Documentation 🚀 NEXT STEPS (Choose One) ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Option A: Automatic Setup (Recommended) ───────────────────────────────────────── npm run setup # Follow the wizard, then restart Claude Desktop Option B: Manual Setup ────────────────────── 1. Choose a config from configs/ (e.g., mcp-config-windows-mainnet.json) 2. Copy its content to your MCP client's config file: Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json 3. Update the path to match your installation 4. Restart your MCP client 📚 DOCUMENTATION ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ QUICKSTART.md → 5-minute setup guide EXAMPLES.md → 20+ usage examples SETUP_COMPLETE.md → Complete overview README.md → Full API reference configs/README.md → Configuration help 🧪 TESTING ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ npm test # Run all tests npm run test:mainnet # Test mainnet only npm run test:testnet # Test testnet only 💡 QUICK TEST ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ After setup, ask Claude: "What MCP tools do you have available?" You should see 24 Zetrix tools! Then try: "Check if the Zetrix node is healthy" "What's the latest block on Zetrix?" "Generate a test keypair" 📦 WHAT YOU HAVE ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Account Operations (6 tools) ✓ Get account, balance, assets, metadata ✓ Generate test keypairs Block & Ledger (3 tools) ✓ Get blocks, latest block, ledger info Transactions (6 tools) ✓ History, cache, create, submit, test fees Smart Contracts (1 tool) ✓ Call contracts in sandbox Utilities (3 tools) ✓ Health check, multi-query WebSocket (5 tools) ✓ Connect, submit, subscribe, real-time monitoring 🌐 NETWORKS ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Mainnet: HTTP: https://node.zetrix.com WS: ws://node-ws.zetrix.com Testnet: HTTP: https://test-node.zetrix.com WS: ws://test-node-ws.zetrix.com 🎯 COMMANDS ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ npm run build # Build TypeScript npm run dev # Run server manually npm run setup # Setup wizard npm test # Run tests 🆘 TROUBLESHOOTING ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Tools don't appear? → Run: npm run setup → Restart Claude Desktop completely Tests fail? → Check network: npm run test:mainnet Module not found? → Run: npm install && npm run build 📖 EXAMPLE USAGE IN CLAUDE ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ You: "What's the latest block on Zetrix?" Claude: [Uses zetrix_get_latest_block] "The latest block is #1,234,567 with 15 transactions" You: "Check balance for ZTX3Ta7d4GyAXD41H2kFCTd2eXhDesM83rvC3" Claude: [Uses zetrix_get_balance] "Balance: 1,000.000000 ZTX" You: "Connect to WebSocket and monitor that address" Claude: [Uses zetrix_ws_connect + zetrix_ws_subscribe_tx] "Connected! Now monitoring for transactions..." ✨ YOU'RE READY! ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Run the setup wizard: npm run setup Then open Claude Desktop and start exploring Zetrix! Questions? Check QUICKSTART.md or EXAMPLES.md Happy exploring! 🚀