bsc-mcp
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 Name | Description |
---|---|
transferNativeToken | Send BNB to a wallet |
transferBEP20Token | Transfer BEP-20 token via symbol/address |
pancakeSwap | Swap tokens via PancakeSwap |
createFourMeme | Create meme token on Four.Meme |
createBEP20Token | Deploy a BEP-20 contract |
getBalance | Get token + native balance |
callContractFunction | Custom contract calls via ABI |
getWalletInfo | Get wallet info for an address |
securityCheck | Check token security of BSC tokens |
pancakeAddLiquidity | Add liquidity to PancakeSwap |
pancakeMyPosition | View your PancakeSwap positions |
pancakeRemovePosition | Remove liquidity from PancakeSwap |
sellMemeToken | Sell 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.