Bnbchain Mcp

What is Bnbchain Mcp about?

Bnbchain Mcp provides a plug‑and‑play tool server that enables native BNB transfers, BEP‑20 token operations, token deployment, PancakeSwap swaps, liquidity management, and arbitrary contract calls on the Binance Smart Chain.

How to use Bnbchain Mcp?

1. Install the package globally: npm install -g bnbchain-mcp (or run with npx).
2. Initialise the configuration wizard: bnbchain-mcp --init and provide your BSC private key, a 6‑character password, and an optional custom RPC URL.
3. Start the server: npm start or node build/index.js.
4. The CLI automatically writes Claude Desktop configuration, allowing Claude agents to invoke the MCP tools.

Key Features

• Secure native BNB transfers and BEP‑20 token transfers.
• Deploy custom BEP‑20 (meme) tokens.
• PancakeSwap integration for token swaps, adding/removing liquidity, and viewing positions.
• Generic contract interaction via ABI and function name.
• Password‑protected private key storage.
• Fully MCP‑compliant and CLI‑ready for AI agents and developers.
• Automatic Claude Desktop integration.

Use Cases

• Automated trading bots that need on‑chain token swaps or liquidity provision.
• AI assistants (e.g., Claude) that can query balances, send funds, or deploy contracts on behalf of users.
• Developers building Web3 services that require a simple server to expose BSC operations.
• Meme‑token creators who want a one‑click deployment workflow.

FAQ

Q: Do I need to expose my private key? A: The private key is stored locally and encrypted with the password you set during --init.

Q: Can I use a custom RPC endpoint? A: Yes, the wizard accepts an optional RPC URL; otherwise it defaults to https://bsc-dataseed.binance.org.

Q: How does Claude Desktop discover the server? A: The setup wizard modifies claude_desktop_config.json in the Claude support folder, enabling Claude to launch the MCP server automatically.

Q: Is the tool open‑source? A: Yes, it is released under the MIT license.

Q: What if I need additional tools? A: The project is extensible; new MCP tools can be added and registered in the server configuration.

---

📦 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.

---