Bnbchain Mcp

What is Bnbchain Mcp about?

Bnbchain Mcp delivers a ready‑to‑run Model Context Protocol (MCP) server and command‑line interface that enable secure native BNB transfers, BEP‑20 token movements, smart‑contract calls, PancakeSwap swaps, liquidity management, and meme‑token creation on the Binance Smart Chain (BSC).

How to use Bnbchain Mcp?

1. Install the package globally (or use npx):

   npm install -g bnbchain-mcp   # or use npx bnbchain-mcp
   

2. Initialize the configuration wizard:

   bnbchain-mcp --init
   

   • Provide your BSC private key, a password (minimum 6 characters), and optionally a custom RPC URL.
3. Start the MCP server (or run commands directly):

   npm start               # runs node build/index.js
   # or simply
   npx bnbchain-mcp          # launches the server
   

4. The wizard automatically patches Claude Desktop’s config file so the assistant can invoke the registered tools.

Key features of Bnbchain Mcp

• Secure native BNB and BEP‑20 token transfers.
• Deploy custom BEP‑20 contracts and meme tokens.
• Full PancakeSwap integration: swap, add/remove liquidity, view positions.
• Generic contract interaction via ABI/function calls.
• Password‑protected private key handling.
• CLI‑ready and MCP‑compliant for AI agents (Claude Desktop, OpenAI, etc.).
• Extensible tool list (transfer, balance, security check, etc.).

Use cases of Bnbchain Mcp

• AI‑driven trading bots: agents invoke swap and liquidity tools to execute strategies autonomously.
• Developer tooling: quickly test token deployments or contract calls without writing boilerplate code.
• Automation scripts: batch transfers, balance checks, or security audits via CLI.
• Claude Desktop extensions: enable natural‑language powered Web3 interactions for end‑users.
• Meme‑token launch workflows: create and list tokens on Four.Meme directly from the command line.

FAQ from the Bnbchain Mcp

• Do I need to install Node.js? Yes, Node ≥ 14 is required.
• Can I run the server without global install? Absolutely; use npx bnbchain-mcp to execute without installing globally.
• Where are my private keys stored? Keys are encrypted with the password you set during --init and kept locally.
• Is the tool compatible with other AI assistants? It follows the MCP standard, so it works with Claude, OpenAI, and any MCP‑aware agent.
• How do I add a custom RPC endpoint? Provide it during the --init wizard or edit the generated config file.
• Can I extend the tool list? Yes, add new MCP‑compliant functions to the project and expose them via the server.

---

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

---