# BNB Chain MCP - LLM Reference
> A Model Context Protocol (MCP) server enabling AI agents to interact with BNB Chain and EVM-compatible blockchains through natural language.
## Overview
BNB Chain MCP is a TypeScript-based MCP server providing 175+ tools for comprehensive blockchain interaction across BSC, opBNB, Arbitrum, Ethereum, Polygon, Base, Optimism, and testnets.
## Quick Start
```json
{
"mcpServers": {
"bnb-chain-mcp": {
"command": "npx",
"args": ["-y", "@nirholas/bnb-chain-mcp@latest"],
"env": {
"PRIVATE_KEY": "optional_for_write_operations"
}
}
}
}
```
## Capabilities Summary
| Category | Tools | Key Functions |
|----------|-------|---------------|
| **Network** | 8 | Chain info, health, gas oracle, finality |
| **Tokens** | 14 | ERC20/721/1155, wrap/unwrap, batch transfers |
| **Swap/DEX** | 12 | Quotes, swaps, liquidity, arbitrage |
| **Bridge** | 6 | Cross-chain transfers, status tracking |
| **Security** | 20 | Honeypot detection, rug pull analysis, GoPlus |
| **Staking** | 14 | Lido, LP farming, liquid staking |
| **Lending** | 10 | Aave/Compound: supply, borrow, flash loans |
| **NFTs** | 12 | Metadata, transfers, marketplace approvals |
| **Governance** | 6 | Proposals, voting, delegation |
| **Price Feeds** | 6 | Chainlink, Uniswap pools, TWAP |
| **Market Data** | 25+ | CoinGecko, CoinStats, Fear & Greed |
| **DeFi Analytics** | 20+ | DefiLlama TVL, yields, protocol data |
| **DEX Analytics** | 22 | DexPaprika, GeckoTerminal pools/trades |
| **Social** | 12 | LunarCrush sentiment, influencers |
| **News** | 7 | Multi-source crypto news aggregation |
| **Utility** | 30+ | ENS, signatures, multicall, deployment |
## Environment Variables
| Variable | Required | Description |
|----------|----------|-------------|
| `PRIVATE_KEY` | Optional | Wallet key for write operations |
| `COINGECKO_API_KEY` | Optional | Higher rate limits |
| `COINSTATS_API_KEY` | Optional | CoinStats access |
| `LUNARCRUSH_API_KEY` | Optional | Social metrics |
| `CRYPTOPANIC_API_KEY` | Optional | News feeds |
## Supported Networks
**Mainnets:** Ethereum (1), BSC (56), Arbitrum (42161), Polygon (137), Base (8453), Optimism (10), opBNB (204), IoTeX (4689)
**Testnets:** Sepolia, BSC Testnet, Arbitrum Sepolia, Base Sepolia, Polygon Amoy, opBNB Testnet
## Server Modes
- **stdio** (default): Claude Desktop, Cursor
- **HTTP**: ChatGPT Developer Mode (`--http`)
- **SSE**: Legacy clients (`--sse`)
## Links
- Documentation: https://bnb-chain-mcp.vercel.app
- GitHub: https://github.com/nirholas/bnb-chain-mcp
- npm: @nirholas/bnb-chain-mcp
## Full Reference
For complete tool documentation, parameters, and examples, see: [llms-full.txt](./llms-full.txt)
