sperax-crypto-mcp / BNB-Chain-MCP

# 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)