bsc-mcp

bsc-mcp

78

BNBChain MCP is a tool server designed for interacting with Binance Smart Chain, focusing on secure token transfers and smart contract interactions. It is CLI-ready and integrates with Claude Desktop for enhanced AI and developer utility.


๐Ÿ“ฆ BNBChain MCP โ€“ Binance Smart Chain Tool Server (MCP + CLI Ready)

A plug-and-play MCP tool server to send BNB, transfer BEP-20 tokens, deploy tokens, and interact with smart contracts on the Binance Smart Chain (BSC) โ€” built for Claude Desktop, AI agents, and developers.


โš™๏ธ Core Capabilities

  • ๐Ÿ” Secure token & native transfers via CLI or MCP
  • ๐Ÿงฑ Interact with smart contracts (ABI/function-based)
  • ๐Ÿ”„ PancakeSwap integration for swaps & liquidity
  • โš™๏ธ Create meme tokens & deploy BEP-20 smart contracts
  • ๐Ÿง  Native Claude Desktop integration via MCP
  • ๐Ÿ”ง CLI-ready, MCP-compliant, developer-friendly
  • ๐Ÿ”‘ Password-protected private keys

๐Ÿ›  Installation & Setup

1. Install

npm install -g bnbchain-mcp

2. Run the CLI Setup Wizard

bnbchain-mcp --init

Youโ€™ll be prompted to enter:

  • โœ… BSC Wallet Private Key (required)
  • โœ… Wallet Password (required, must be 6 characters)
  • โœ… Custom RPC URL (optional, defaults to: https://bsc-dataseed.binance.org *)

๐Ÿง  Claude Desktop Integration

After CLI setup, the tool can auto-configure itself into Claude Desktop.

๐Ÿ“ File modified:

~/Library/Application Support/Claude/claude_desktop_config.json

Claude will detect and run this MCP server with your selected tools.


๐Ÿ”จ Supported MCP Tools

Tool NameDescription
transferNativeTokenSend BNB to a wallet
transferBEP20TokenTransfer BEP-20 token via symbol/address
pancakeSwapSwap tokens via PancakeSwap
createFourMemeCreate meme token on Four.Meme
createBEP20TokenDeploy a BEP-20 contract
getBalanceGet token + native balance
callContractFunctionCustom contract calls via ABI
getWalletInfoGet wallet info for an address
securityCheckCheck token security of BSC tokens
pancakeAddLiquidityAdd liquidity to PancakeSwap
pancakeMyPositionView your PancakeSwap positions
pancakeRemovePositionRemove liquidity from PancakeSwap
sellMemeTokenSell meme token on Four.Meme
...and more coming soon ๐Ÿ”ง

๐Ÿงช Development Workflow

Compile TypeScript:

npm run build

Start MCP Server:

npm start
# or
node build/index.js

Re-configure:

bnbchain-mcp --init

๐Ÿ“˜ Model Context Protocol (MCP)

This project is built on Model Context Protocol โ€“ a standard to help agents and models interact with structured tool APIs.

MCP Benefits:

  • โœ… Structured input/output
  • โœ… Claude + OpenAI compatible
  • โœ… Secure + serverless-ready

โœ… Roadmap

  • CLI Configuration Wizard
  • Claude Desktop Integration
  • Token Deploy + Transfer
  • Token charting tools (DEXTools, Gecko)
  • Telegram auto-trading agent
  • AI assistant with BSC on-chain brain

๐Ÿค Contributing

Feel free to fork, PR, or raise issues. We're building tool-first, AI-ready infrastructure for the next wave of Web3 agents. Join us!


๐Ÿ›ก๏ธ License

MIT โ€” Use freely, contribute openly.