base-airdrop-mcp

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.