BNB Chain MCP Server

The most comprehensive MCP server for BNB Chain & EVM blockchains

README.md

                                                                                      
    ██████╗ ███╗   ██╗██████╗      ██████╗██╗  ██╗ █████╗ ██╗███╗   ██╗              
    ██╔══██╗████╗  ██║██╔══██╗    ██╔════╝██║  ██║██╔══██╗██║████╗  ██║              
    ██████╔╝██╔██╗ ██║██████╔╝    ██║     ███████║███████║██║██╔██╗ ██║              
    ██╔══██╗██║╚██╗██║██╔══██╗    ██║     ██╔══██║██╔══██║██║██║╚██╗██║              
    ██████╔╝██║ ╚████║██████╔╝    ╚██████╗██║  ██║██║  ██║██║██║ ╚████║              
    ╚═════╝ ╚═╝  ╚═══╝╚═════╝      ╚═════╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝╚═╝  ╚═══╝              
                                                                                      
              ███╗   ███╗ ██████╗██████╗     ███████╗███████╗██████╗ ██╗   ██╗███████╗██████╗  
              ████╗ ████║██╔════╝██╔══██╗    ██╔════╝██╔════╝██╔══██╗██║   ██║██╔════╝██╔══██╗ 
              ██╔████╔██║██║     ██████╔╝    ███████╗█████╗  ██████╔╝██║   ██║█████╗  ██████╔╝ 
              ██║╚██╔╝██║██║     ██╔═══╝     ╚════██║██╔══╝  ██╔══██╗╚██╗ ██╔╝██╔══╝  ██╔══██╗ 
              ██║ ╚═╝ ██║╚██████╗██║         ███████║███████╗██║  ██║ ╚████╔╝ ███████╗██║  ██║ 
              ╚═╝     ╚═╝ ╚═════╝╚═╝         ╚══════╝╚══════╝╚═╝  ╚═╝  ╚═══╝  ╚══════╝╚═╝  ╚═╝ 
                                                                                       

BNB Chain MCP Server

The most comprehensive Model Context Protocol server for BNB Chain & EVM blockchains

Enable AI agents to interact with BNB Chain, opBNB, and other EVM networks through natural language

If you find this useful, please star the repo! It helps others discover this project.

📖 Documentation🚀 Quick Start🛠️ Features📊 Roadmap🤝 Contributing


📋 Table of Contents


🌟 What is BNB Chain MCP?

BNB Chain MCP is a Model Context Protocol (MCP) server optimized for BNB Chain and opBNB, while also supporting other EVM-compatible blockchains. It enables AI assistants like Claude, ChatGPT, and Cursor to interact with blockchain networks through natural language.

Why BNB Chain MCP?

┌──────────────────────────────────────────────────────────────────────────────┐
│                                                                              │
│   User: "What's the current price of ETH and show me the best DEX pools"     │
│                                    │                                         │
│                                    ▼                                         │
│   ┌────────────────────────────────────────────────────────┐                 │
│   │              AI Assistant (Claude/ChatGPT)             │                 │
│   │                                                        │                 │
│   │         "Let me check that for you..."                 │                 │
│   └────────────────────────────────────────────────────────┘                 │
│                                    │                                         │
│                                    ▼                                         │
│   ┌───────────────────────────────────────────────────────┐                  │
│   │                  BNB Chain MCP Server                 │                  │
│   │                                                       │                  │
│   │   ┌──────────┐  ┌──────────┐  ┌──────────┐            │

Tools 3

get_balanceRetrieve the native token balance of a specific wallet address.
send_transactionExecute a token transfer or contract interaction on the network.
get_contract_dataRead data from a smart contract using its ABI and address.

Environment Variables

RPC_URLrequiredThe JSON-RPC endpoint for the blockchain network.
PRIVATE_KEYPrivate key for signing transactions if performing write operations.

Try it

What is the current BNB balance for the address 0x123...?
Send 0.1 BNB to 0xabc... using my connected wallet.
Check the total supply of the token at contract address 0xdef...
What is the current gas price on the opBNB network?

Frequently Asked Questions

What are the key features of BNB Chain MCP?

Interact with BNB Chain and opBNB networks via natural language. Support for standard EVM-compatible blockchain operations. Wallet management and token transaction execution. Smart contract data retrieval and interaction. Integration with BNB Greenfield decentralized storage.

What can I use BNB Chain MCP for?

Automating blockchain balance checks for portfolio tracking. Executing routine token transfers through AI-assisted workflows. Querying smart contract state for decentralized application development. Managing storage buckets on BNB Greenfield using natural language commands.

How do I install BNB Chain MCP?

Install BNB Chain MCP by running: npx -y @nirholas/bnbchain-mcp

What MCP clients work with BNB Chain MCP?

BNB Chain MCP works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep BNB Chain MCP docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Open Conare