Avalanche Mainnet Wallet Agent

Safety-first CLI and MCP server for Avalanche C-Chain mainnet (chainId 43114): AVAX balance, guarded sends, ERC-20 checks, and transaction status.

REAL MAINNET AVAX. You are solely responsible for your funds. Not financial advice.

Security

• Mainnet only — Avalanche C-Chain (43114)
• Do not use high-value wallets
• Private key in ~/.config/avalanche-mainnet-wallet-agent/wallet.json (600)
• send requires typing CONFIRM
• MCP prepare_avalanche_transfer only — never broadcasts
• No MCP send tool; keys/seeds never logged

Install

npm install -g avalanche-mainnet-wallet-agent

Local dev:

cd avalanche-mainnet-wallet-agent
npm install
npm run build
npm link

Quick start

avalanche-wallet setup
avalanche-wallet address
avalanche-wallet balance

Send AVAX:

avalanche-wallet send --to 0x... --amount 0.01
# Type CONFIRM when prompted

avalanche-wallet tx --hash 0x...
avalanche-wallet tokens
avalanche-wallet mcp

CLI commands

| Command | Description | |---------|-------------| | setup | Fresh wallet or import 0x key | | address | Address + QR | | balance | Native AVAX | | send --to --amount | Send AVAX (CONFIRM required) | | tx --hash | Status + Snowtrace link | | tokens | USDC, USDT, WAVAX, JOE balances (curated) | | mcp | MCP stdio server |

Configuration

| File | Purpose | |------|---------| | ~/.config/avalanche-mainnet-wallet-agent/config.json | RPC, maxSendAvax | | ~/.config/avalanche-mainnet-wallet-agent/wallet.json | { "privateKey": "0x..." } |

Default RPC: https://api.avax.network/ext/bc/C/rpc

export AVALANCHE_RPC_URL=https://your-rpc.example.com

MCP tools

| Tool | Broadcasts? | |------|-------------| | get_avalanche_address | No | | get_avalanche_balance | No | | get_avalanche_transaction_status | No | | prepare_avalanche_transfer | No (preview only) |

Claude Desktop

{
  "mcpServers": {
    "avalanche-mainnet-wallet-agent": {
      "command": "avalanche-wallet",
      "args": ["mcp"]
    }
  }
}

Publish

npm login
npm publish --access public

Disclaimer

Software provided as-is. Transactions are irreversible. Authors are not liable for lost funds or user error.

License

MIT