BSC MultiSend

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

javascript

1

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "kukapay-bsc-multisend-mcp": {
      "command": "node",
      "args": [
        "/path/to/bsc-multisend-mcp/index.js"
      ],
      "env": {
        "PRIVATE_KEY": "YOUR_PRIVATE_KEY"
      }
    }
  }
}

You can run a dedicated MCP server to perform bulk BNB and BEP20 token transfers on the BSC network. This server provides two practical tools to distribute funds to many recipients in a single operation, saving time and reducing on-chain interactions.

How to use

You will interact with two tools exposed by the server: distributeNative for sending BNB to multiple addresses and distributeToken for sending BEP20 tokens to multiple addresses. Use clear prompts that list each recipient and the amount you want them to receive. The server handles token decimals, allowance checks, and gas estimation where applicable. When you run a distribution, you will receive a transaction hash indicating a successful transfer.

Examples of practical usage prompts you can send include:

For native BNB distribution: “Distribute 0.1 BNB to 0xRecipient1 and 0.2 BNB to 0xRecipient2 on BSC.”
For token distribution: “Send tokens to the following addresses on BSC using the token contract at 0xTokenAddress: 0xRecipient1: 100.5 tokens, 0xRecipient2: 200 tokens, 0xRecipient3: 50.75 tokens.” After processing, you will receive a response like: Token distribution successful. Tx Hash: 0x... or BNB distribution successful. Tx Hash: 0x... depending on the operation.

How to install

Follow these concrete steps to get started on your machine.

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

pnmp install

# Prepare MCP client configuration example (adjust paths and keys as needed)

{ "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.

Additional notes

Prerequisites you need to prepare before running the server: a compatible Node.js runtime (version 18 or higher), the pnpm package manager, a BSC wallet with sufficient BNB for gas and BEP20 tokens for distribution, and access to a BSC RPC endpoint (for example, https://bsc-dataseed.binance.org/). These components enable the server to perform bulk transfers efficiently.

Available tools

distributeNative

Distributes BNB to multiple addresses in a single transaction. Automatically converts amounts to wei and estimates gas.

distributeToken

Distributes BEP20 tokens to multiple addresses. Looks up token decimals, checks and handles allowances, and transfers tokens to recipients.