# Required
Node.js >= 18.0.0
npm >= 9.0.0

# Clone the repository
git clone https://github.com/Tairon-ai/monad-mcp.git
cd monad-mcp

# Install dependencies
npm install

# Configure environment (optional)
cp .env.example .env
# Edit .env only if you have custom RPC or private key

# Start the server
npm start

# Development mode
npm run dev

# MCP stdio server for Claude Desktop
npm run mcp

{
  "mcpServers": {
    "monad": {
      "command": "node",
      "args": ["/path/to/monad-mcp/mcp/index.js"],
      "env": {
        "MONAD_RPC_URL": "https://testnet-rpc.monad.xyz",
        "MONAD_API_KEY": "",  // Optional: Get API key at https://dashboard.blockvision.org
        "WALLET_PRIVATE_KEY": "",  // Optional: Leave empty for read-only
        "WALLET_ADDRESS": ""  // Optional: Your wallet address
      }
    }
  }
}

// Request
{
  "tool": "get_block_number",
  "params": {}
}

// Response
{
  "blockNumber": 39454804,
  "network": "Monad Testnet"
}

{
  "tool": "get_block",
  "params": {
    "blockNumber": "39454804"
  }
}

{
  "tool": "get_balance",
  "params": {
    "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
  }
}

{
  "tool": "get_transaction",
  "params": {
    "txHash": "0x..."
  }
}

{
  "tool": "get_gas_price",
  "params": {}
}

{
  "tool": "estimate_gas",
  "params": {
    "to": "0x...",
    "value": "1000000000000000000",
    "data": "0x"
  }
}

{
  "tool": "get_token_balance",
  "params": {
    "tokenAddress": "0x...",
    "walletAddress": "0x..."
  }
}

{
  "tool": "call",
  "params": {
    "to": "0x...",
    "data": "0x...",
    "from": "0x..."
  }
}

{
  "tool": "get_logs",
  "params": {
    "fromBlock": "39000000",
    "toBlock": "latest",
    "address": "0x...",
    "topics": []
  }
}

"What's the current block on Monad Testnet?"
"Show me details of block 39454804"
"Get the latest block information"
"How many transactions in the last block?"
"Show block production rate"
"Get block by hash"
"Find blocks with high transaction count"
"Show me blocks from last hour"
"Get block timestamp"
"Check block confirmations"

"Get transaction details for hash 0x..."
"Show me transaction receipt"
"Check if transaction is confirmed"
"Get transaction logs"
"Decode transaction input data"
"Show gas used by transaction"
"Get transaction status"
"Find transactions from address"
"Show failed transactions"
"Get internal transactions"

"Check balance of address 0x..."
"Get my wallet balance"
"Show balance in ether"
"Get transaction count for address"
"Check nonce for wallet"
"Generate new wallet"
"Create wallet from mnemonic"
"Show all my wallets"
"Get wallet transaction history"
"Check if address is contract"

"Show available tokens on Monad"
"Get USDC token balance"
"Check all tokens for address"
"Get token information"
"Show token decimals"
"List all stablecoins"
"Find governance tokens"
"Get token total supply"
"Show token holders"
"Check token allowance"

"Send 0.1 MON to address 0x..."
"Transfer 100 USDC to 0x..."
"Send native tokens to wallet"
"Transfer ERC20 tokens"
"Send USDT using my private key"
"Transfer tokens with custom gas"
"Send transaction with specific nonce"
"Batch transfer to multiple addresses"
"Send all balance to address"
"Transfer NFT to wallet"

"What's current gas price?"
"Estimate gas for transfer"
"Get priority fee"
"Show gas price in gwei"
"Calculate transaction cost"
"Get fee history"
"Optimize gas for transaction"
"Show base fee"
"Get max fee per gas"
"Check gas limit"

"Get contract code at address"
"Call read function on contract"
"Estimate gas for contract call"
"Get contract events"
"Read contract storage"
"Decode contract data"
"Get contract ABI"
"Verify contract source"
"Show contract creation tx"
"Get contract balance"

"Get Transfer events for token"
"Show events from block range"
"Filter events by topic"
"Get all events for address"
"Decode event data"
"Show event signatures"
"Get indexed parameters"
"Find specific event"
"Monitor events real-time"
"Get event history"

"Show Monad network details"
"Get chain ID"
"Check network status"
"Show RPC endpoint"
"Get network version"
"Check if syncing"
"Show peer count"
"Get protocol version"
"Check network congestion"
"Show mempool status"

"Generate new wallet for me"
"Create wallet with mnemonic"
"Generate HD wallet"
"Create multiple wallets"
"Get wallet from private key"
"Derive wallet addresses"
"Generate vanity address"
"Create multisig wallet"
"Get wallet keystore"
"Export wallet"

"Get all transactions in last 100 blocks"
"Find contracts deployed today"
"Show high value transactions"
"Get MEV transactions"
"Find arbitrage opportunities"
"Show liquidity pools"
"Get staking rewards"
"Find token swaps"
"Show bridge transactions"
"Get protocol statistics"

"Check DeFi protocols on Monad"
"Get lending rates"
"Show liquidity pools"
"Find yield farming options"
"Get swap quotes"
"Check collateral ratio"
"Show borrowed amount"
"Get LP token balance"
"Find flash loan providers"
"Check protocol TVL"

"Deploy contract to Monad"
"Verify contract on explorer"
"Get contract creation code"
"Test contract function"
"Debug transaction failure"
"Simulate transaction"
"Get revert reason"
"Check contract size"
"Optimize contract gas"
"Test contract upgrade"

"Bridge assets to Monad"
"Check bridge status"
"Get wrapped token address"
"Show cross-chain messages"
"Verify bridge transaction"
"Get bridge fees"
"Check finality status"
"Show supported bridges"
"Get bridge limits"
"Track bridge volume"

"Show Monad statistics"
"Get daily transaction count"
"Show unique addresses"
"Get average gas price"
"Show TPS metrics"
"Get block time average"
"Show network growth"
"Get active addresses"
"Show gas usage trends"
"Get protocol metrics"

# Start production server
NODE_ENV=production npm start

# With PM2
pm2 start mcp/index.js --name monad-mcp

# With Docker
docker build -t monad-mcp .
docker run -d -p 8080:8080 --env-file .env monad-mcp

# Monad RPC Configuration
MONAD_RPC_URL=https://testnet-rpc.monad.xyz

# Wallet Configuration (Optional)
WALLET_ADDRESS=your_wallet_address  # Optional: For default wallet
WALLET_PRIVATE_KEY=your_private_key  # Optional: For write operations

# Server Configuration
PORT=8080
NODE_ENV=production

# Advanced Settings
MAX_BLOCK_RANGE=1000
DEFAULT_GAS_LIMIT=3000000
CONFIRMATION_BLOCKS=1

# Fork the repository on GitHub, then clone
git clone https://github.com/Tairon-ai/monad-mcp

# Create feature branch
git checkout -b feature/amazing-feature

# Make changes and test
npm test

# Commit and push
git commit -m 'feat: add amazing feature'
git push origin feature/amazing-feature

# Open Pull Request