bsc-mcp

📦 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

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