BSC MultiSend MCP

An MCP server that enables agents to perform bulk BNB and BEP20 token transfers on BSC.

Features

• distributeNative Tool: Sends BNB to multiple addresses in a single transaction.

  • Parameters:

    • receivers: Array of BSC addresses to receive BNB.

    • amounts: Array of BNB amounts (e.g., 0.1 BNB) to send, automatically summed for the total.

  • Automatically converts amounts to wei and handles gas estimation.

• distributeToken Tool: Sends BEP20 tokens to multiple addresses.

  • Parameters:

    • tokenAddress: Address of the BEP20 token contract.

    • receivers: Array of BSC addresses to receive tokens.

    • amounts: Array of token amounts (e.g., 100.5 tokens).

  • Queries token decimals, checks allowance, and auto-approves if needed.

Prerequisites

• Node.js: Version 18 or higher.

• pnpm: For installing dependencies.

• BNB Smart Chain Wallet: A wallet with sufficient BNB for gas and tokens for distribution.

• BSC RPC Endpoint: Access to a BSC node (e.g., https://bsc-dataseed.binance.org/).

Installation

1. Clone the repository:

   git clone https://github.com/kukapay/bsc-multisend-mcp.git cd bsc-multisend-mcp

2. Install dependencies:

   pnmp install

3. Configure MCP client:

   Claude Desktop configuration file as a reference:

   { "mcpServers": { "BSC MultiSend": { "command": "node", "args": [ "/path/to/bsc-multisend-mcp/index.js" ], "env": { "PRIVATE_KEY": "your-private-key" } } } }

   Replace /path/to/bsc-multisend-mcp with your actual installation path, and your-private-key with your BSC wallet private key.

Usage

The server offers two tools — distributeNative and distributeToken — for bulk token distribution.

distributeNative

Purpose: Distributes BNB to multiple addresses in a single transaction.

Example Prompt:

Expected Response:

distributeToken

Purpose: Distributes BEP20 tokens to multiple addresses. It queries the token's decimals, checks the contract's allowance, approves the contract if needed, and executes the transfer.

Example Prompt:

Expected Response:

License

This project is licensed under the MIT License. See the LICENSE file for details.