Skip to content
Back to search

bsc-mcp

πŸ“¦ BNBChain MCP – Binance Smart Chain Tool Server (MCP + CLI Ready)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/termix-official--bsc-mcp/badge.svg)](/listings/termix-official--bsc-mcp)

HTML

<a href="/listings/termix-official--bsc-mcp"><img src="/api/listings/termix-official--bsc-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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` *)

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md Β· README Β· 167 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. ## πŸ“¦ BNBChain MCP – Binance Smart Chain Tool Server (MCP + CLI Ready)
  3. > A comprehensive blockchain tool server for BNB, BEP-20 tokens, smart contract deployment and interaction built on BNB Smart Chain (BSC) and compatible with other EVM networks.
  4. ---
  5. ## Technology Stack
  6. - **Blockchain**: BNB Smart Chain (BSC)
  7. - **Web3 Libraries**: Viem 2.23.11, PancakeSwap SDK 5.8.8
  8. - **CLI/Backend**: TypeScript, Node.js (ESM)
  9. - **Protocol**: Model Context Protocol (MCP) SDK 1.4.0
  10. - **Security**: AES encryption with bcrypt for private key protection
  11. - **Token Security**: GoPlus SDK for security checks
  12. - **Data Provider**: Moralis SDK 2.27.2 for blockchain data
  13. ---
  14. ## Supported Networks
  15. - **BNB Smart Chain Mainnet** (Chain ID: 56)
  16. - RPC: https://bsc-dataseed.binance.org (default)
  17. - Custom RPC supported via environment configuration
  18. ---
  19. ## Contract Addresses
  20. | Contract Type | Address | Description |
  21. |--------------|---------|-------------|
  22. | Four.Meme Try Buy | 0xF251F83e40a78868FcfA3FA4599Dad6494E46034 | Four.Meme token purchase contract |
  23. | Four.Meme Buy/Sell AMAP | 0x5c952063c7fc8610FFDB798152D69F0B9550762b | Four.Meme auto-market-adjusted pricing |
  24. | Four.Meme Create Token | 0x5c952063c7fc8610FFDB798152D69F0B9550762b | Four.Meme token factory |
  25. | PancakeSwap Router V2 | Integrated via SDK | DEX routing and swaps |
  26. | PancakeSwap V3 Pools | Accessed via SDK | Liquidity pools management |
  27. ---
  28. ## Features
  29. - **Low-cost BNB & BEP-20 transfers** - Optimized for BSC's low gas fees
  30. - **PancakeSwap V2/V3 integration** - Automated swaps, liquidity management, and position tracking
  31. - **Four.Meme platform support** - Create, buy, and sell meme tokens directly
  32. - **Security-first architecture** - AES-256 encrypted private keys with bcrypt password protection
  33. - **Token security analysis** - Built-in GoPlus security checks for token verification
  34. - **Gas-efficient operations** - Smart routing for optimal gas usage on BSC
  35. - **AI-ready MCP protocol** - Seamless integration with Claude Desktop and AI agents
  36. - **Real-time wallet monitoring** - Track balances and positions across multiple tokens
  37. ---
  38. ## πŸ›  Installation & Setup
  39. ### 1. Install
  40. ```bash
  41. npm install -g bnbchain-mcp
  42. ```
  43. ### 2. Run the CLI Setup Wizard
  44. ```bash
  45. bnbchain-mcp --init
  46. ```
  47. You’ll be prompted to enter:
  48. - βœ… **BSC Wallet Private Key** *(required)*
  49. - βœ… **Wallet Password** *(required, must be 6 characters)*
  50. - βœ… **Custom RPC URL** *(optional, defaults to:* `https://bsc-dataseed.binance.org` *)
  51. ---
  52. ## 🧠 Claude Desktop Integration
  53. After CLI setup, the tool can **auto-configure itself into Claude Desktop**.
  54. πŸ“ File modified:
  55. ```
  56. ~/Library/Application Support/Claude/claude_desktop_config.json
  57. ```
  58. Claude will detect and run this MCP server with your selected tools.
  59. ---
  60. ## πŸ”¨ Supported MCP Tools
  61. | Tool Name | Description |
  62. |----------------------|------------------------------------------|
  63. | `transferNativeToken` | Send BNB to a wallet |
  64. | `transferBEP20Token` | Transfer BEP-20 token via symbol/address |
  65. | `pancakeSwap` | Swap tokens via PancakeSwap |
  66. | `createFourMeme` | Create meme token on Four.Meme |
  67. | `createBEP20Token` | Deploy a BEP-20 contract |
  68. | `getBalance` | Get token + native balance |
  69. | `callContractFunction`| Custom contract calls via ABI |
  70. | `getWalletInfo` | Get wallet info for an address |
  71. | `securityCheck` | Check token security of BSC tokens |
  72. | `pancakeAddLiquidity` | Add liquidity to PancakeSwap |
  73. | `pancakeMyPosition` | View your PancakeSwap positions |
  74. | `pancakeRemovePosition`| Remove liquidity from PancakeSwap |
  75. | `sellMemeToken` | Sell meme token on Four.Meme |
  76. | ...and more coming soon πŸ”§ |
  77. ---
  78. ## πŸ§ͺ Development Workflow
  79. ### Compile TypeScript:
  80. ```bash
  81. npm run build
  82. ```
  83. ### Start MCP Server:
  84. ```bash
  85. npm start
  86. # or
  87. node build/index.js
  88. ```
  89. ### Re-configure:
  90. ```bash
  91. bnbchain-mcp --init
  92. ```
  93. ---
  94. ## πŸ“˜ Model Context Protocol (MCP)
  95. This project is built on **Model Context Protocol** – a standard to help agents and models interact with structured tool APIs.
  96. **MCP Benefits**:
  97. - βœ… Structured input/output
  98. - βœ… Claude + OpenAI compatible
  99. - βœ… Secure + serverless-ready
  100. ---
  101. ## βœ… Roadmap
  102. - [x] CLI Configuration Wizard
  103. - [x] Claude Desktop Integration
  104. - [x] Token Deploy + Transfer
  105. - [ ] Token charting tools (DEXTools, Gecko)
  106. - [ ] Telegram auto-trading agent
  107. - [ ] AI assistant with BSC on-chain brain
  108. ---
  109. ## 🀝 Contributing
  110. Feel free to fork, PR, or raise issues.
  111. We're building **tool-first, AI-ready infrastructure** for the next wave of Web3 agents. Join us!
  112. ---
  113. ## πŸ›‘οΈ License
  114. MIT β€” Use freely, contribute openly.
  115. ---

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.