Bnbchain Mcp

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

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

[](https://opensource.org/licenses/MIT) [](https://modelcontextprotocol.io) [](https://www.typescriptlang.org/) [](https://www.bnbchain.org)

[](https://www.bnbchain.org) [](https://opbnb.bnbchain.org)

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

📖 Documentation • [🚀 Quick Start](#-quick-start) • [🛠️ Features](#-features-overview) • [📊 Roadmap](#️-roadmap) • [🤝 Contributing](#-contributing)

---

📋 Table of Contents

• [What is BNB Chain MCP?](#-what-is-bnb-chain-mcp)
• [Quick Start](#-quick-start)
• [Features Overview](#-features-overview)
• [Supported Networks](#-supported-networks)
• [Installation](#-installation)
• [Configuration](#-configuration)
• [Data Sources](#-data-sources)
• [Example Conversations](#-example-conversations)
• [Architecture](#-architecture)
• [Roadmap](#️-roadmap)
• [Related MCP Servers](#-related-mcp-servers)
• [Troubleshooting](#-troubleshooting)
• [Contributing](#-contributing)
• [License](#-license)

---

🌟 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                 │                  │
│   │                                                       │                  │
│   │   ┌──────────┐  ┌──────────┐  ┌──────────┐            │                  │
│   │   │CoinGecko │  │GeckoTerm │  │DefiLlama │   ...      │                  │
│   │   └────┬─────┘  └────┬─────┘  └────┬─────┘            │                  │
│   └────────┼─────────────┼─────────────┼──────────────────┘                  │
│            │             │             │                                     │
│            ▼             ▼             ▼                                     │
│   ┌────────────────────────────────────────────────────────┐                 │
│   │                  Blockchain Networks                   │                 │
│   │   BNB Chain  │  Ethereum  │  Arbitrum  │  Polygon      │                 │
│   └────────────────────────────────────────────────────────┘                 │
│                                                                              │
└──────────────────────────────────────────────────────────────────────────────┘

Key Benefits

| Benefit | Description | |---------|-------------| | Natural Language | Ask questions in plain English, get blockchain data instantly | | Multi-Chain | One server supports 10+ EVM networks simultaneously | | Read + Write | Query data or execute transactions (with wallet) | | Security Built-In | GoPlus integration for token/contract safety checks | | Rich Data | Prices, DEX pools, TVL, social sentiment, news & more | | AI-Native | Built specifically for LLMs with structured responses |

Use Cases

🔍 Research & Analysis

• Check token prices and historical data
• Analyze DEX liquidity pools
• Monitor protocol TVL and metrics
• Research new tokens before investing
• Track whale wallets and movements

💹 Trading & DeFi

• Get swap quotes across DEX aggregators
• Find best yield farming opportunities
• Monitor lending rates on Aave/Compound
• Execute token swaps and transfers
• Bridge tokens across chains

🛡️ Security & Compliance

• Detect honeypot tokens
• Check for rug pull risks
• Verify smart contract safety
• Screen wallet addresses
• Check token holder distribution

👨‍💻 Development

• Deploy and verify smart contracts
• Query contract state and events
• Test transactions before execution
• Manage multi-sig operations
• Debug failed transactions

DeFi tools in action: swap quotes, TVL tracking, and more

---

🚀 Quick Start

Get up and running in under 60 seconds!

Option 1: Claude Desktop (Recommended)

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "bnb-chain-mcp": {
      "command": "npx",
      "args": ["-y", "@nirholas/bnb-chain-mcp@latest"]
    }
  }
}

📁 Config file locations

| OS | Path | |----|------| | macOS | ~/Library/Application Support/Claude/claude_desktop_config.json | | Windows | %APPDATA%\Claude\claude_desktop_config.json | | Linux | ~/.config/claude/claude_desktop_config.json |

Option 2: Cursor / VS Code

Add to your MCP settings:

{
  "mcpServers": {
    "bnb-chain-mcp": {
      "command": "npx",
      "args": ["-y", "@nirholas/bnb-chain-mcp@latest"]
    }
  }
}

Option 3: ChatGPT Developer Mode

1. Enable Developer Mode in ChatGPT settings
2. Start the HTTP server:

``bash npx @nirholas/bnb-chain-mcp@latest --http ``

1. In ChatGPT Settings → Apps, click Create app
2. Enter your server URL: http://localhost:3001/mcp
3. Select the app in conversations via Developer mode menu

📖 Full ChatGPT Setup Guide

Option 4: npx Instant Start

# stdio mode (Claude, Cursor)
npx @nirholas/bnb-chain-mcp@latest

# HTTP mode (ChatGPT Developer Mode)
npx @nirholas/bnb-chain-mcp@latest --http

# SSE mode (legacy clients)
npx @nirholas/bnb-chain-mcp@latest --sse

---

🛠️ Features Overview

Feature Matrix

| Category | Features | Status | |----------|----------|--------| | Swap/DEX | Token swaps via 1inch, 0x, ParaSwap | ✅ | | Bridge | Cross-chain transfers via LayerZero, Stargate | ✅ | | Gas | Gas prices across chains, EIP-1559 suggestions | ✅ | | Multicall | Batch read/write operations | ✅ | | Events/Logs | Query historical events, decode logs | ✅ | | Security | Rug pull detection, honeypot check, GoPlus integration | ✅ | | Staking | Liquid staking (Lido), LP farming | ✅ | | Signatures | Sign messages, verify signatures, EIP-712 | ✅ | | Lending | Aave/Compound positions, borrow rates | ✅ | | Price Feeds | Historical prices, TWAP, oracle aggregation | ✅ | | Portfolio | Track holdings across chains | ✅ | | Governance | Snapshot votes, on-chain proposals | ✅ | | Deployment | Deploy contracts, CREATE2, upgradeable proxies | ✅ | | MEV Protection | Flashbots Protect, private transactions | ✅ | | ENS/Domains | Register, transfer, renew, set records | ✅ | | Market Data | CoinGecko prices, OHLCV, trending | ✅ | | DeFi Analytics | DefiLlama TVL, yields, fees, protocols | ✅ | | Social Sentiment | LunarCrush metrics, influencers, trending | ✅ | | DEX Analytics | GeckoTerminal pools, trades, OHLCV | ✅ |

Tool Categories

🔗 Core Blockchain (45+ tools)

| Tool | Description | |------|-------------| | get_chain_info | Get chain ID, block number, gas price | | get_block | Get block by number or hash | | get_transaction | Get transaction details and receipt | | send_transaction | Send native token transfer | | estimate_gas | Estimate gas for transaction | | get_balance | Get native/token balance | | call_contract | Call view/pure contract functions | | ... | See full list → |

💰 Token Operations (30+ tools)

| Tool | Description | |------|-------------| | get_token_info | Get name, symbol, decimals, supply | | get_token_balance | Get token balance for address | | transfer_token | Transfer ERC-20 tokens | | approve_token | Approve spending allowance | | get_nft_metadata | Get NFT metadata and traits | | transfer_nft | Transfer ERC-721 NFT | | ... | See full list → |

🏦 DeFi (50+ tools)

| Tool | Description | |------|-------------| | get_swap_quote | Get swap quote from DEX aggregators | | execute_swap | Execute token swap | | add_liquidity | Add liquidity to DEX pools | | get_lending_rates | Get Aave/Compound rates | | supply_to_lending | Supply assets to lending protocol | | get_farming_apy | Get yield farming APY | | ... | See full list → |

🔒 Security (15+ tools)

| Tool | Description | |------|-------------| | check_token_security | GoPlus token security analysis | | detect_honeypot | Check if token is honeypot | | check_rug_pull | Assess rug pull risk | | get_holder_distribution | Get top holder breakdown | | check_contract_verified | Verify contract source | | screen_address | Check address risk score | | ... | See full list → |

📊 Market Data (25+ tools)

| Tool | Description | |------|-------------| | get_price | Get current token price | | get_price_history | Get historical OHLCV data | | get_trending_coins | Get trending tokens | | get_tvl | Get protocol TVL from DefiLlama | | get_dex_pools | Get DEX pool data | | get_social_metrics | Get LunarCrush sentiment | | ... | See full list → |

---

🌐 Supported Networks

| Network | Chain ID | Native Token | Status | |---------|----------|--------------|--------| | BNB Smart Chain | 56 | BNB | ✅ Full Support | | opBNB | 204 | BNB | ✅ Full Support | | Arbitrum One | 42161 | ETH | ✅ Full Support | | Ethereum | 1 | ETH | ✅ Full Support | | Polygon | 137 | MATIC | ✅ Full Support | | Base | 8453 | ETH | ✅ Full Support | | Optimism | 10 | ETH | ✅ Full Support | | Avalanche C-Chain | 43114 | AVAX | ✅ Full Support | | Fantom | 250 | FTM | ✅ Full Support | | Gnosis | 100 | xDAI | ✅ Full Support | | BSC Testnet | 97 | tBNB | ✅ Testnet | | Sepolia | 11155111 | SepoliaETH | ✅ Testnet | | Goerli | 5 | GoerliETH | ✅ Testnet |

Adding Custom Networks

{
  "mcpServers": {
    "bnb-chain-mcp": {
      "command": "npx",
      "args": ["-y", "@nirholas/bnb-chain-mcp@latest"],
      "env": {
        "CUSTOM_RPC_56": "https://your-bnb-rpc.com",
        "CUSTOM_RPC_1": "https://your-eth-rpc.com"
      }
    }
  }
}

---

📦 Installation

Server Modes

| Mode | Command | Use Case | |------|---------|----------| | stdio | npx @nirholas/bnb-chain-mcp | Claude Desktop, Cursor | | HTTP | npx @nirholas/bnb-chain-mcp --http | ChatGPT Developer Mode | | SSE | npx @nirholas/bnb-chain-mcp --sse | Legacy HTTP clients |

From npm (Recommended)

# Run directly with npx (no install required)
npx @nirholas/bnb-chain-mcp@latest

# Or install globally
npm install -g @nirholas/bnb-chain-mcp

# Then run
bnb-chain-mcp

From Source

# Clone
git clone https://github.com/nirholas/bnb-chain-mcp
cd bnb-chain-mcp

# Install dependencies
bun install

# Build
bun run build

# Run dev server (stdio - Claude)
bun dev

# Run dev server (HTTP - ChatGPT)
bun dev:http

# Run dev server (SSE - legacy)
bun dev:sse

Docker

# Build
docker build -t bnb-chain-mcp .

# Run stdio mode
docker run -it bnb-chain-mcp

# Run HTTP mode
docker run -p 3001:3001 bnb-chain-mcp --http

---

⚙️ Configuration

Environment Variables

| Variable | Description | Default | Required | |----------|-------------|---------|----------| | PRIVATE_KEY | Wallet private key for transactions | - | No (read-only without) | | COINGECKO_API_KEY | CoinGecko Pro API key | - | No | | COINSTATS_API_KEY | CoinStats API key | - | No | | LUNARCRUSH_API_KEY | LunarCrush API key | - | No | | CRYPTOPANIC_API_KEY | CryptoPanic news API key | - | No | | CUSTOM_RPC_ | Custom RPC for specific chain | - | No | | PORT | HTTP server port | 3001 | No | | LOG_LEVEL | Logging level | info | No |

Full Configuration Example

{
  "mcpServers": {
    "bnb-chain-mcp": {
      "command": "npx",
      "args": ["-y", "@nirholas/bnb-chain-mcp@latest"],
      "env": {
        "PRIVATE_KEY": "0x...",
        "COINGECKO_API_KEY": "CG-xxx",
        "LUNARCRUSH_API_KEY": "xxx",
        "CUSTOM_RPC_56": "https://bsc-rpc.publicnode.com",
        "CUSTOM_RPC_1": "https://eth-rpc.publicnode.com",
        "LOG_LEVEL": "debug"
      }
    }
  }
}

Claude Desktop Configuration

macOS

# Open config file
open ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows

# Open config file
notepad %APPDATA%\Claude\claude_desktop_config.json

Linux

# Open config file
nano ~/.config/claude/claude_desktop_config.json

---

📊 Data Sources

This MCP server integrates with the following APIs:

| Provider | Data Type | API Key | Rate Limits | |----------|-----------|---------|-------------| | CoinGecko | Market data, prices, OHLCV | Optional | 10-50 req/min | | CoinStats | Portfolio, prices, wallets | Required | Varies | | DefiLlama | TVL, yields, fees, protocols | No | Generous | | LunarCrush | Social sentiment, influencers | Required | Varies | | GoPlus | Security analysis, honeypot | No | Generous | | GeckoTerminal | DEX pools, trades, OHLCV | No | Generous | | DexPaprika | DEX analytics, pools | No | Generous | | CryptoPanic | Cryp

…

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: nirholas
• Source: nirholas/bnbchain-mcp
• License: Apache-2.0
• Homepage: https://bnbchainmcp.vercel.app

Install and usage instructions live in the source repository linked above.