BSC Blockchain MCP server

A plug-and-play MCP tool server that enables you to manage BNB transactions, transfer BEP-20 tokens, deploy smart contracts, and interact with the Binance Smart Chain. This tool can be seamlessly integrated with Claude Desktop and offers both CLI and MCP interfaces for developers and AI agents.

Installation

Install the Package

Install the bnbchain-mcp package globally using npm:

npm install -g bnbchain-mcp

Configure the Server

Run the setup wizard to configure your server:

bnbchain-mcp --init

During setup, you'll need to provide:

• BSC Wallet Private Key (required)
• Wallet Password (required, minimum 6 characters)
• Custom RPC URL (optional, defaults to https://bsc-dataseed.binance.org)

Claude Desktop Integration

The tool can automatically configure itself for Claude Desktop after the initial CLI setup. It modifies the configuration file located at:

~/Library/Application Support/Claude/claude_desktop_config.json

Claude will automatically detect and run this MCP server with your selected tools.

Available Tools

Token Management

• Transfer BNB

  • Tool: transferNativeToken
  • Send BNB to any wallet address

• Transfer BEP-20 Tokens

  • Tool: transferBEP20Token
  • Transfer tokens using either the token symbol or contract address

• Check Balances

  • Tool: getBalance
  • View your token and native BNB balances

PancakeSwap Operations

• Token Swaps

  • Tool: pancakeSwap
  • Swap tokens via PancakeSwap

• Liquidity Management

  • Tool: pancakeAddLiquidity - Add liquidity
  • Tool: pancakeMyPosition - View your positions
  • Tool: pancakeRemovePosition - Remove liquidity

Smart Contract Functions

• Deploy BEP-20 Tokens

  • Tool: createBEP20Token
  • Create your own BEP-20 compliant token

• Create Meme Tokens

  • Tool: createFourMeme
  • Deploy meme tokens on Four.Meme

• Sell Meme Tokens

  • Tool: sellMemeToken
  • Sell meme tokens on Four.Meme

• Custom Contract Interactions

  • Tool: callContractFunction
  • Interact with any smart contract using its ABI

Utility Tools

• Wallet Information

  • Tool: getWalletInfo
  • Get detailed information about any wallet address

• Security Checks

  • Tool: securityCheck
  • Analyze BSC tokens for security issues

Running the Server

After installation and configuration, you can start the MCP server with:

npm start

Or directly using:

node build/index.js

Reconfiguration

If you need to update your configuration:

bnbchain-mcp --init

How to add this MCP server to Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > MCP and click "Add new global MCP server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "cursor-rules-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cursor-rules-mcp"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.