bsc mcp

Local 2025-08-31 23:40:02 0

Developer Tools @TermiX-official/bsc-mcp

A backend service for executing transactions on Binance Smart Chain, enabling secure transfers of BNB and BEP-20 tokens, smart contract interactions, and token creation through structured MCP integration.

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

[
  {
    "description": "Transfer native token (BNB)",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {
        "amount": {
          "type": "string"
        },
        "recipientAddress": {
          "type": "string"
        }
      },
      "required": [
        "recipientAddress",
        "amount"
      ],
      "type": "object"
    },
    "name": "transferNativeToken"
  },
  {
    "description": "Transfer BEP-20 token by symbol or address",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {
        "amount": {
          "type": "string"
        },
        "recipientAddress": {
          "type": "string"
        },
        "token": {
          "type": "string"
        }
      },
      "required": [
        "recipientAddress",
        "amount",
        "token"
      ],
      "type": "object"
    },
    "name": "transferBEP20Token"
  },
  {
    "description": "Swap tokens in BSC chain via PancakeSwap",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {
        "amount": {
          "type": "string"
        },
        "inputToken": {
          "type": "string"
        },
        "outputToken": {
          "type": "string"
        }
      },
      "required": [
        "inputToken",
        "outputToken",
        "amount"
      ],
      "type": "object"
    },
    "name": "pancakeSwap"
  },
  {
    "description": "Get wallet info for an address",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {
        "address": {
          "type": "string"
        }
      },
      "type": "object"
    },
    "name": "getWalletInfo"
  },
  {
    "description": "create new meme token on four.meme",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {
        "desc": {
          "description": "description",
          "type": "string"
        },
        "imgUrl": {
          "description": "image url",
          "type": "string"
        },
        "name": {
          "description": "name",
          "type": "string"
        },
        "preSale": {
          "description": "pre sale value",
          "type": "string"
        },
        "shortName": {
          "description": "short name",
          "type": "string"
        },
        "telegramUrl": {
          "description": "telegramUrl",
          "type": "string"
        },
        "twitterUrl": {
          "description": "twitterUrl",
          "type": "string"
        },
        "webUrl": {
          "description": "webUrl",
          "type": "string"
        }
      },
      "required": [
        "name",
        "shortName",
        "imgUrl",
        "preSale",
        "desc"
      ],
      "type": "object"
    },
    "name": "createFourMeme"
  },
  {
    "description": "create bep20 token",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {
        "name": {
          "type": "string"
        },
        "symbol": {
          "type": "string"
        },
        "totalSupply": {
          "type": "string"
        }
      },
      "required": [
        "name",
        "symbol",
        "totalSupply"
      ],
      "type": "object"
    },
    "name": "createBEP20Token"
  },
  {
    "description": "buy meme token",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {
        "bnbValue": {
          "default": "0",
          "type": "string"
        },
        "token": {
          "type": "string"
        },
        "tokenValue": {
          "default": "0",
          "type": "string"
        }
      },
      "required": [
        "token"
      ],
      "type": "object"
    },
    "name": "buyMemeToken"
  },
  {
    "description": "sell meme token",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {
        "token": {
          "type": "string"
        },
        "tokenValue": {
          "type": "string"
        }
      },
      "required": [
        "token",
        "tokenValue"
      ],
      "type": "object"
    },
    "name": "sellMemeToken"
  },
  {
    "description": "add liquidity to pancake",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {
        "token0": {
          "type": "string"
        },
        "token0Amount": {
          "type": "string"
        },
        "token1": {
          "type": "string"
        },
        "token1Amount": {
          "type": "string"
        }
      },
      "required": [
        "token0",
        "token1",
        "token0Amount",
        "token1Amount"
      ],
      "type": "object"
    },
    "name": "pancakeAddLiquidity"
  },
  {
    "description": "check my liquidity position on panceke",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {},
      "type": "object"
    },
    "name": "pancakeMyPosition"
  },
  {
    "description": "remove liquidity position on panceke",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {
        "percent": {
          "maximum": 100,
          "minimum": 1,
          "type": "number"
        },
        "positionId": {
          "type": "string"
        }
      },
      "required": [
        "positionId",
        "percent"
      ],
      "type": "object"
    },
    "name": "pancakeRemovePosition"
  },
  {
    "description": "Check security of BSC tokens",
    "inputSchema": {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "additionalProperties": false,
      "properties": {
        "tokenAddress": {
          "type": "string"
        }
      },
      "required": [
        "tokenAddress"
      ],
      "type": "object"
    },
    "name": "securityCheck"
  }
]