Hyperion MCP Server

runtime: "typescript" categories: - blockchain - cryptocurrency - wallet - defi - tokens - erc20 keywords: - hyperion - hyperion-testnet - blockchain - cryptocurrency - wallet - tmetis - smart-contracts - defi - mcp - model-context-protocol - chain-133717 - erc20 - token - token-deployment - token-minting runtime: "typescript" startCommand: type: http configSchema: type: object required: ["privateKey"] properties: privateKey: type: string title: "Private Key" description: "Your funded private key for Hyperion testnet (Chain ID 133717). Example: 3cf90f4acdaee72ab90c0da7eda158ec1e908a5698aaf11a99070bba5da18b17" rpcUrl: type: string title: "RPC URL" description: "Hyperion testnet RPC endpoint" default: "https://hyperion-testnet.metisdevops.link" chainId: type: number title: "Chain ID" description: "Hyperion testnet chain ID" default: 133717 networkName: type: string title: "Network Name" description: "Network display name" default: "Hyperion Testnet" explorerUrl: type: string title: "Explorer URL" description: "Block explorer URL" default: "https://hyperion-testnet-explorer.metisdevops.link" currencySymbol: type: string title: "Currency Symbol" description: "Native currency symbol" default: "tMETIS" environment: required: - HYPERION_RPC_URL - HYPERION_PRIVATE_KEYS optional: - HYPERION_CHAIN_ID - HYPERION_NETWORK_NAME - HYPERION_CURRENCY_SYMBOL - HYPERION_EXPLORER_URL - HYPERION_ADDRESSES - HYPERION_CURRENT_ADDRESS tools: - name: create_wallet description: Create a new Hyperion wallet with generated mnemonic category: wallet - name: import_wallet description: Import existing wallet using private key or mnemonic category: wallet - name: list_wallets description: List all available wallets category: wallet - name: get_balance description: Get wallet balance (native or ERC20 tokens) category: query - name: get_native_balance description: Get native tMETIS balance of a wallet address category: query - name: send_transaction description: Send native tokens or ERC20 tokens category: transaction - name: get_transaction description: Get transaction details by hash category: query - name: get_block description: Get block information category: query - name: get_network_info description: Get network status and information category: query - name: estimate_gas description: Estimate transaction gas costs category: utility - name: call_contract description: Call smart contract methods (read-only) category: contract - name: send_contract_transaction description: Send transactions to smart contracts category: contract - name: set_current_wallet description: Set active wallet for transactions category: wallet - name: get_current_wallet description: Get current active wallet info category: wallet - name: deploy_erc20_token description: Deploy new ERC20 token contracts (standard or mintable) with custom parameters category: token parameters: - name: name type: string required: true description: Token name (e.g., "My Token") - name: symbol type: string required: true description: Token symbol (e.g., "MTK") - name: decimals type: number required: false description: Token decimals (default: 18) - name: initialSupply type: string required: true description: Initial token supply - name: mintable type: boolean required: false description: Whether token should be mintable (default: false) - name: gasLimit type: string required: false description: Gas limit for deployment - name: gasPrice type: string required: false description: Gas price for deployment - name: get_token_info description: Get comprehensive ERC20 token information including name, symbol, decimals, supply, and owner category: token parameters: - name: tokenAddress type: string required: true description: ERC20 token contract address - name: mint_tokens description: Mint additional tokens for mintable ERC20 contracts (owner only) category: token parameters: - name: tokenAddress type: string required: true description: ERC20 token contract address - name: to type: string required: true description: Address to mint tokens to - name: amount type: string required: true description: Amount of tokens to mint - name: gasLimit type: string required: false description: Gas limit for minting - name: gasPrice type: string required: false description: Gas price for minting examples: - name: Configuration Setup description: Configure your private key for ERC20 token deployment code: | // Required environment variables for ERC20 operations: // HYPERION_RPC_URL=https://hyperion-testnet.metisdevops.link // HYPERION_PRIVATE_KEYS=3cf90f4acdaee72ab90c0da7eda158ec1e908a5698aaf11a99070bba5da18b17 // Optional environment variables: // HYPERION_CHAIN_ID=133717 // HYPERION_CURRENT_ADDRESS=0x742d35Cc6634C0532925a3b8D4C9db96590c6C87 // Import your wallet if not configured via environment await mcp.callTool('import_wallet', { privateKey: '3cf90f4acdaee72ab90c0da7eda158ec1e908a5698aaf11a99070bba5da18b17' }); - name: Basic Wallet Operations description: Create wallet, check balance, send transaction code: | // Create a new wallet await mcp.callTool('create_wallet', { name: 'MyWallet' }); // Check native balance await mcp.callTool('get_native_balance', { address: '0x742d35Cc6634C0532925a3b8D4C9db96590c6C87' }); // Send transaction await mcp.callTool('send_transaction', { to: '0x1234567890123456789012345678901234567890', amount: '0.1' }); - name: Smart Contract Interaction description: Call and transact with smart contracts code: | // Call contract method (read-only) await mcp.callTool('call_contract', { contractAddress: '0xA0b86a33E6441e8e4E2f4c6c8C6c8C6c8C6c8C6c', methodName: 'balanceOf', parameters: ['0x742d35Cc6634C0532925a3b8D4C9db96590c6C87'] }); // Send contract transaction await mcp.callTool('send_contract_transaction', { contractAddress: '0xA0b86a33E6441e8e4E2f4c6c8C6c8C6c8C6c8C6c', methodName: 'transfer', parameters: ['0x1234567890123456789012345678901234567890', '1000000000000000000'] }); - name: ERC20 Token Deployment description: Deploy and manage ERC20 tokens code: | // Deploy a new ERC20 token await mcp.callTool('deploy_erc20_token', { name: 'My Token', symbol: 'MTK', decimals: 18, initialSupply: '1000000', mintable: true }); // Get token information await mcp.callTool('get_token_info', { tokenAddress: '0xTokenContractAddress' }); // Mint additional tokens (for mintable tokens) await mcp.callTool('mint_tokens', { tokenAddress: '0xTokenContractAddress', to: '0x1234567890123456789012345678901234567890', amount: '1000' }); documentation: setup: | 1. Install Node.js 18 or higher 2. Clone the repository 3. Run `npm install` 4. Copy `.env.example` to `.env` and configure 5. Run `npm run build` 6. Start with `npm start` configuration: | Configure environment variables in `.env`: - HYPERION_RPC_URL: Blockchain RPC endpoint - HYPERION_PRIVATE_KEYS: Comma-separated private keys - HYPERION_CURRENT_ADDRESS: Default wallet address usage: | The server provides comprehensive tools for: - Wallet management (create, import, list, switch) - Balance queries (native tMETIS and ERC20 tokens) - Transaction operations (send, query, track) - ERC20 token deployment (standard and mintable contracts) - Token management (info retrieval, minting, transfers) - Blockchain queries (blocks, network info, gas estimation) - Smart contract interactions (call, transact, deploy) - Explorer integration (direct links to transactions and contracts) support: documentation: https://github.com/cuongpo/hyperion-mcp-server/blob/main/README.md issues: https://github.com/cuongpo/hyperion-mcp-server/issues discussions: https://github.com/cuongpo/hyperion-mcp-server/discussions