base-airdrop-mcp

MCP server for batch-sending ERC-20 tokens and ETH on Base chain. Wraps the BatchSender contract with airdrop-specific tooling: CSV-style recipient lists, equal/weighted splits, and gas estimation.

Install

npx -y base-airdrop-mcp

Or add to your MCP config:

{
  "mcpServers": {
    "base-airdrop": {
      "command": "npx",
      "args": ["-y", "base-airdrop-mcp"],
      "env": {
        "RPC_URL": "https://mainnet.base.org",
        "PRIVATE_KEY": "your-private-key"
      }
    }
  }
}

Tools

| Tool | Description | |------|-------------| | airdrop_tokens | Airdrop ERC-20 tokens to multiple recipients. Handles approval + batch send. | | airdrop_eth | Airdrop ETH to multiple recipients in a single transaction. | | estimate_airdrop | Estimate gas cost and fee for a token or ETH airdrop. | | generate_equal_split | Split a total token amount equally across a list of addresses. | | generate_weighted_split | Split a total token amount proportionally by weight across addresses. | | get_airdrop_info | Get BatchSender contract info (fee, treasury, address). |

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | PRIVATE_KEY | Yes (for sends) | - | Wallet private key for signing transactions | | RPC_URL | No | https://mainnet.base.org | Base RPC endpoint |

Use Cases

• Token launches - Distribute tokens to early supporters or community members
• Community rewards - Reward active participants with token or ETH airdrops
• Team compensation - Batch-send tokens to team members
• DAO distributions - Execute governance-approved token distributions

Contract

BatchSender: 0x7625a962Ba9dddc02F08847904cEA59e881f8907 (Base mainnet)

Fee: 0.0005 ETH per batch transaction.