You're Invited:Meet the Socket Team at RSAC and BSidesSF 2026, March 23–26.RSVP →
Socket
Book a DemoSign in
Socket
Book a DemoSign in

@nirholas/bnb-chain-toolkit

Package Overview
Dependencies
Maintainers
1
Versions
1
Alerts
File Explorer

Advanced tools

License
Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@nirholas/bnb-chain-toolkit

BNB Chain AI Toolkit - 78 AI agents, 6 MCP servers, 1,100+ tools for BNB Chain. Built by nich.

latest
Source
npmnpm
Version
2.0.0
Version published
Maintainers
1
Created
Source

npm version


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

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


MIT License Stars Forks Issues PRs Welcome Live Demo


Agents MCP Servers Tools Languages

Deploy with Vercel



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


BNB Chain AI Toolkit

🧐 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?

ProblemSolution
Fragmented BNB Chain toolingSingle repo with everything integrated
AI can't interact with blockchains6 MCP servers give AI direct chain access
Complex DeFi interactions78 specialized agents for every protocol
Multi-chain complexityMulti-chain support with unified interfaces
No accessibility standardsW3AG + ERC-8004 for inclusive Web3

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

ContractAddressExplorer
IdentityRegistry0x8004A169FB4a3325136EB29fA0ceB6D2e539a432BscScan →
ReputationRegistry0x8004BAa17C55a88189AE136b182e5fdA19dE9b63BscScan →

BSC Testnet (Chain ID: 97)

ContractAddressExplorer
IdentityRegistry0x8004A818BFB912233c491871b3d84c89A494BD9eBscScan →
ReputationRegistry0x8004B663056A597Dffe9eCcC1965A193B7388713BscScan →
ValidationRegistry0x8004Cb1BF31DAf7788923b405b754f57acEB4272BscScan →

opBNB Testnet (Chain ID: 5611)

ContractAddressExplorer
IdentityRegistry0x8004A818BFB912233c491871b3d84c89A494BD9eopBNBScan →
ReputationRegistry0x8004B663056A597Dffe9eCcC1965A193B7388713opBNBScan →
ValidationRegistry0x8004Cb1BF31DAf7788923b405b754f57acEB4272opBNBScan →

opBNB Mainnet (Chain ID: 204)

ContractAddressExplorer
IdentityRegistry0x8004A169FB4a3325136EB29fA0ceB6D2e539a432opBNBScan →
ReputationRegistry0x8004BAa17C55a88189AE136b182e5fdA19dE9b63opBNBScan →

📋 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.

BNB Chain Agents (36) — Click to expand
AgentDescription
PancakeSwap TraderDEX trading, liquidity, yield farming on PancakeSwap v3
Venus Protocol ExpertLending, borrowing, liquidation on Venus
BNB Staking AdvisorLiquid staking optimization across validators
Binance Earn SpecialistSavings, staking, Launchpool yields
BSC Bridge NavigatorCross-chain bridging (BSC ↔ opBNB ↔ L2s)
BEP-20 Token AnalystToken security, smart money tracking
Binance Copy TradingMirror top performers' strategies
opBNB Scaling ExpertL2 gas optimization
Greenfield StorageDecentralized storage on BNB Greenfield
Thena DEX Expertve(3,3) DEX trading on Thena
+ 26 more...Full ecosystem coverage
DeFi Agents (42) — Click to expand
CategoryCountExamples
Portfolio Management8Tracking, rebalancing, tax optimization
Trading Automation7Grid trading, DCA, arbitrage, signals
Yield Optimization6Auto-compounding, IL protection
Risk & Security5Auditing, rug detection
Market Intelligence5Sentiment, whale tracking
DeFi Protocols6Lending, DEX, derivatives
Infrastructure5Bridge, gas, RPC, indexing

📚 Full guide: Agents Documentation

🔌 MCP Servers (6)

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

ServerToolsWhat It Does
BNB Chain MCP466+BSC, opBNB, Greenfield — swaps, transfers, contracts
Binance MCP554+Spot, futures, margin trading on Binance.com
Binance US MCP—US regulatory-compliant Binance access
Universal Crypto MCP59+Multi-network, cross-chain DeFi
Agenti—EVM + Solana, AI-to-AI payments (x402)
UCAIDynamicTurn any smart contract ABI into an MCP server
# One-command ABI-to-MCP conversion
ucai generate --abi ./Contract.json --chain bsc --output ./my-server

📚 Full guide: MCP Servers Documentation

📊 Market Data

ComponentSourcesFeatures
Crypto Market DataCoinGecko, DeFiLlama, Fear & GreedZero-dependency, Edge Runtime compatible
Crypto News200+ sources150+ endpoints, sentiment analysis, MCP server
// 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

StandardDescription
ERC-8004On-chain AI agent discovery, reputation, and trust protocol
W3AGWeb3 Accessibility Guidelines — making DeFi accessible to all

📚 Full guide: Standards Documentation

🌐 Supported Networks

NetworkTypeStatus
BNB Smart Chain (BSC)L1✅
opBNBL2✅
BNB GreenfieldStorage✅

📊 Tool Summary

CategoryCountSource
BNB Chain + EVM on-chain tools466+bnbchain-mcp
Binance exchange tools554+binance-mcp
Cross-chain DeFi tools59+universal-crypto-mcp
EVM chain tools58+agenti
ABI-to-MCP generationDynamicucai
Market data endpoints150+crypto-news + crypto-market-data
Wallet operations20+ethereum-wallet-toolkit
Total1,100+

🛠️ 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

GuideForDescription
What Is This?EveryoneSimple explanation, no jargon
GlossaryEveryoneterms explained in plain English
Getting StartedBeginnersStep-by-step setup guide
ArchitectureDevelopersSystem design & data flows
AgentsUsersComplete agent catalog
MCP ServersDevelopersServer setup & configuration
Market DataDevelopersPrice feeds & news APIs
DeFi ToolsUsersDust sweeping & utilities
WalletsUsersWallet generation & signing
StandardsResearchersERC-8004 & W3AG specs
ExamplesEveryoneReal-world usage patterns
FAQEveryoneCommon questions
TroubleshootingEveryoneProblem solving
Awesome ListEveryoneCurated resources

🤝 Contributing

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

  • Fork the repo
  • Create your branch: git checkout -b feat/my-improvement
  • Commit: git commit -m "✨ feat: add amazing feature"
  • Push: git push origin feat/my-improvement
  • 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

Star on GitHub

Keywords

web3
blockchain
ethereum
solana
ai
machine-learning

FAQs

Package last updated on 08 Mar 2026

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

Trivy Supply Chain Attack Expands to Compromised Docker Images

Security News

/

Research

Trivy Supply Chain Attack Expands to Compromised Docker Images

Newly published Trivy Docker images (0.69.4, 0.69.5, and 0.69.6) were found to contain infostealer IOCs and were pushed to Docker Hub without corresponding GitHub releases.

By Philipp Burckhardt  -  Mar 22, 2026