README.md
Coordinated multi-wallet trading on Base mainnet.
base-multi-wallet-mcp
MCP server for managing multiple wallets with coordinated trading on Base mainnet.
Features
- create_wallet - Generate new random wallets
- import_wallet - Import existing wallets by private key
- list_wallets - List all managed wallets with ETH + token balances
- fund_wallets - Distribute ETH from main wallet to all managed wallets equally
- coordinated_buy - Buy a token from all wallets simultaneously via Uniswap V2
- coordinated_sell - Sell a token from all wallets via Uniswap V2
- collect_funds - Sweep ETH + tokens from all wallets back to main wallet
- get_gas_estimate - Estimate gas costs for multi-wallet operations
Setup
npm install
npm run build
Environment Variables
| Variable | Description | Default |
|---|---|---|
RPC_URL |
Base RPC endpoint | https://mainnet.base.org |
DEPLOYER_PRIVATE_KEY |
Main wallet private key (funds source) | Required for fund/collect |
Usage with Claude Desktop
{
"mcpServers": {
"base-multi-wallet": {
"command": "node",
"args": ["path/to/base-multi-wallet-mcp/dist/index.js"],
"env": {
"RPC_URL": "https://mainnet.base.org",
"DEPLOYER_PRIVATE_KEY": "0x..."
}
}
}
}
Usage via npx
npx -y base-multi-wallet-mcp
Security
- Private keys are stored in-memory only (session-based, never persisted to disk)
- Private keys are never exposed in tool responses
- Main wallet key provided via environment variable only
Related MCP Servers
| Package | Tools | What it does |
|---|---|---|
obsd-launchpad-mcp |
14 | Deploy tokens, trade, earn OBSD |
base-security-scanner-mcp |
8 | Scan contracts for vulnerabilities |
base-price-oracle-mcp |
7 | On-chain price feeds from DEX pools |
base-multi-wallet-mcp |
8 | Coordinated multi-wallet trading |
base-gasless-deploy-mcp |
5 | Gasless ERC-20 token deployment |
base-flash-arb-mcp |
7 | Detect arbitrage opportunities |
base-token-sniper-mcp |
5 | Discover & trade new launches |
base-wallet-toolkit-mcp |
7 | Wallet balances, gas, tokens |
base-contract-reader-mcp |
6 | Read any smart contract (free) |
create-mcp-server-cli |
- | Scaffold a new MCP server |
Tools (8)
create_walletGenerate new random walletsimport_walletImport existing wallets by private keylist_walletsList all managed wallets with ETH + token balancesfund_walletsDistribute ETH from main wallet to all managed wallets equallycoordinated_buyBuy a token from all wallets simultaneously via Uniswap V2coordinated_sellSell a token from all wallets via Uniswap V2collect_fundsSweep ETH + tokens from all wallets back to main walletget_gas_estimateEstimate gas costs for multi-wallet operationsEnvironment Variables
RPC_URLBase RPC endpointDEPLOYER_PRIVATE_KEYrequiredMain wallet private key (funds source)Configuration
claude_desktop_config.json
{"mcpServers": {"base-multi-wallet": {"command": "node", "args": ["path/to/base-multi-wallet-mcp/dist/index.js"], "env": {"RPC_URL": "https://mainnet.base.org", "DEPLOYER_PRIVATE_KEY": "0x..."}}}}Try it
→Generate 5 new wallets for my trading strategy.
→Distribute 0.1 ETH from my main wallet to all managed wallets.
→Execute a coordinated buy of 100 USDC worth of the target token across all wallets.
→List all my managed wallets and show their current ETH balances.
→Sweep all remaining ETH and tokens from my managed wallets back to the main wallet.