# 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

```bash
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

```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..."
      }
    }
  }
}
```

## Usage via npx

```bash
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 |