bnb-chain-toolkit

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

🔶 The most comprehensive open-source AI toolkit for BNB Chain

Live Demo ·
Quick Start ·
What Is This? ·
Components ·
Docs ·
Examples ·
FAQ

🧐 What Is This?

BNB Chain AI Toolkit gives AI assistants superpowers on the blockchain.

It's a single repository with everything you need to build AI-powered applications on BNB Chain — agents, blockchain connectors, market data, DeFi tools, wallets, and Web3 standards. All open source.

In plain English: Imagine giving Claude or ChatGPT a crypto wallet, a trading terminal, and 78 expert advisors. That's what this toolkit does.

New to crypto or AI? Start with our What Is This? guide — written for non-technical people.

Why This Toolkit?

⚡ Quick Start

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

# Install & build
bun install && bun run build

# Start any MCP server
cd mcp-servers/bnbchain-mcp && bun install && bun start

Use with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "bnbchain": {
      "command": "npx",
      "args": ["-y", "@nirholas/bnbchain-mcp"],
      "env": {
        "BSC_RPC_URL": "https://bsc-dataseed.binance.org"
      }
    }
  }
}

📚 Full setup guide: Getting Started

🔗 Onchain Proof

ERC-8004 contracts are deployed and verified on BSC Mainnet, BSC Testnet.

BSC Mainnet (Chain ID: 56)

BSC Testnet (Chain ID: 97)

opBNB Testnet (Chain ID: 5611)

opBNB Mainnet (Chain ID: 204)

📋 First deployment TX: 0xfc55d83d...dc1962 on BSC Testnet

⚠️ Note: Smart contracts in standards/erc-8004/contracts/ are reference implementations and have not been formally audited. Do not deploy to mainnet without an independent security audit.

🏗️ Architecture

bnb-chain-toolkit/
├── agents/                     # 🤖 78 AI Agent definitions
│   ├── bnb-chain-agents/       #    36 BNB Chain-specific agents
│   └── defi-agents/            #    42 general DeFi agents (30+ languages)
│
├── mcp-servers/                # 🔌 6 Model Context Protocol servers
│   ├── bnbchain-mcp/           #    BNB Chain + EVM (466+ tools)
│   ├── binance-mcp/            #    Binance.com (554+ tools)
│   ├── binance-us-mcp/         #    Binance.US (US compliance)
│   ├── universal-crypto-mcp/   #    Multi-network (59+ tools)
│   ├── agenti/                 #    Universal EVM + Solana (58+ tools)
│   └── ucai/                   #    ABI-to-MCP generator (Python)
│
├── market-data/                # 📊 Market data & news
│   ├── crypto-market-data/     #    CoinGecko, DeFiLlama, Fear & Greed
│   └── crypto-news/            #    200+ sources, 150+ endpoints
│
├── defi-tools/                 # 🧹 DeFi utilities
│   └── sweep/                  #    Multi-chain dust sweeper
│
├── wallets/                    # 👛 Wallet tooling
│   └── ethereum-wallet-toolkit/#    Offline-capable, BSC compatible
│
├── standards/                  # 📜 Web3 standards
│   ├── erc-8004/               #    Agent discovery & trust protocol
│   └── w3ag/                   #    Web3 Accessibility Guidelines
│
└── docs/                       # 📖 Comprehensive documentation

📐 Deep dive: Architecture Guide

🧩 Components

🤖 AI Agents (78)

Pre-built agent definitions for every major BNB Chain protocol and DeFi use case.

📚 Full guide: Agents Documentation

🔌 MCP Servers (6)

Model Context Protocol servers that give AI assistants direct blockchain access.

# One-command ABI-to-MCP conversion
ucai generate --abi ./Contract.json --chain bsc --output ./my-server

📚 Full guide: MCP Servers Documentation

📊 Market Data

// Quick example
const btc = await CoinGecko.getPrice('bitcoin');
const fear = await FearAndGreed.getIndex();
console.log(`BTC: $${btc.usd} | Sentiment: ${fear.classification}`);

📚 Full guide: Market Data Documentation

🧹 DeFi Tools

Dust Sweeper — Scan 8 chains for tiny token balances, batch-swap them into stablecoins.

bun run scan --wallet 0xYourAddress --chain bsc    # Preview (safe)
bun run sweep --wallet 0xYourAddress --target USDC  # Execute

📚 Full guide: DeFi Tools Documentation

👛 Wallets

Ethereum Wallet Toolkit — Offline-capable, BSC-compatible wallet operations.

• HD wallet generation (BIP-39/44)
• Vanity address generation
• Message signing (EIP-191, EIP-712)
• Transaction signing (legacy + EIP-1559)
• Keystore V3 import/export

📚 Full guide: Wallets Documentation

📜 Standards

📚 Full guide: Standards Documentation

🌐 Supported Networks

📊 Tool Summary

🛠️ Development

bun install           # Install dependencies
bun run build         # Build agent index
bun run format        # Format agent JSONs
bun run lint          # Lint TypeScript
bun run test          # Run tests
bun run type-check    # Type checking

Adding a New Agent

cp agents/bnb-chain-agents/agent-template.json agents/bnb-chain-agents/my-agent.json
# Edit the file, then:
bun run build

📚 Full guide: Creating Agents

📖 Documentation

🤝 Contributing

Contributions are welcome! Whether it's a new agent, a bug fix, documentation improvement, or a new MCP server.

1. Fork the repo
2. Create your branch: git checkout -b feat/my-improvement
3. Commit: git commit -m "✨ feat: add amazing feature"
4. Push: git push origin feat/my-improvement
5. Open a Pull Request

📚 Full guide: CONTRIBUTING.md

📄 License

MIT © nirholas

Built with 🔶 for BNB Chain
_{78 agents · 6 MCP servers · 1,100+ tools · 30+ languages}

⭐ Found this useful? Star the repo! ⭐
_{It helps others discover this project and keeps development active}