Binance MCP server
Commit Nov 11, 2026Enables AI assistants to interact with the Binance exchange to execute trades, manage portfolios, and analyze market data using natural language.
Also known as nirholas/Binance-MCP
- Stars
- 40
- Tools
- 6
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 11, 2026
- License
- —
What is Binance MCP?
Binance enables AI assistants to interact with the Binance exchange to execute trades, manage portfolios, and analyze market data using natural language. It exposes 6 tools, such as get_ticker_price, get_24h_stats, get_order_book.
Summary generated from the project's README
About Binance MCP server
Managing cryptocurrency portfolios and executing trades through natural language is what Binance-MCP enables for users of AI assistants like Claude, ChatGPT, and Cursor. This server provides a massive suite of over 478 tools that cover the entire Binance.com API, allowing for direct interaction with the exchange. Users can perform spot and margin trading, manage futures positions, handle staking, and oversee wallet transfers through their preferred MCP-compatible client.
To use this server, you need a Binance account with API credentials and Node.js version 18 or higher. The setup can be configured via a wizard to handle your API keys securely on your local machine. It supports dual transport methods, using STDIO for desktop applications like Claude Desktop or Cursor, and SSE for web-based applications and ChatGPT. This flexibility ensures that your trading strategies and market analysis can be integrated into various AI workflows depending on your specific environment.
What you can do with it
- 1Execute market ordersAsk your AI assistant to buy a specific amount of a cryptocurrency at the current market price.
- 2Automate investment strategiesInstruct an AI client to set up a recurring purchase plan for a specific asset.
- 3Monitor market depthRequest detailed order book information for a specific trading pair to analyze market liquidity.
Written from the project's README. Every use case is checked against a quote from it.
Binance MCP tools 6
Detected from the READMEget_ticker_priceget_24h_statsget_order_bookget_recent_tradesget_klineslist_all_symbols
Configuration
BINANCE_API_KEYBINANCE_API_SECRET
Automated checks
Ran Nov 13, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablenirholas/binance-mcp is public and reachablegithub.com/nirholas/binance-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-11github.com/nirholas/binance-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model6 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub🔶 Binance MCP Server
The most comprehensive Model Context Protocol server for Binance — 478+ tools covering the entire Binance.com API
Quick Start • Features • Configuration • Documentation • Contributing
🎯 Overview
Binance MCP Server enables AI assistants like Claude, ChatGPT, and other MCP-compatible clients to interact directly with the Binance cryptocurrency exchange. Execute trades, manage portfolios, analyze markets, and automate strategies through natural language.
Why Binance MCP?
- Complete Coverage — 478+ tools spanning every Binance API endpoint
- 🔐 Secure by Design — API credentials never leave your machine
- ⚡ Production Ready — Built with official Binance SDKs and TypeScript
- 🔌 Universal Compatibility — Works with Claude Desktop, Cursor, ChatGPT, and any MCP client
- 📡 Dual Transport — STDIO for desktop apps, SSE for web applications
✨ Features
Trading & Markets
- Spot Trading — Orders, market data, account info
- Margin Trading — Cross & isolated margin
- Futures (USD-M & COIN-M) — Perpetual contracts
- Options — European-style options
- Portfolio Margin — Unified margin accounts
- Algo Trading — TWAP, VP algorithms
Earn & Invest
- Simple Earn — Flexible & locked products
- Staking — ETH & SOL staking
- Auto-Invest — DCA & recurring buys
- Dual Investment — Structured products
- Crypto Loans — Flexible rate loans
- VIP Loans — Institutional lending
Wallet & Transfers
- Wallet — Deposits, withdrawals, transfers
- Sub-Accounts — Multi-account management
- Convert — Instant asset conversion
- Pay — Binance Pay integration
- Gift Cards — Create & redeem
Additional Services
- Copy Trading — Lead trader features
- Mining — Pool mining operations
- NFT — NFT marketplace
- C2C/P2P — Peer-to-peer trading
- Fiat — Fiat on/off ramps
- Rebate — Referral program
🚀 Quick Start
Prerequisites
- Node.js ≥ 18.0.0
- Binance account with API credentials
- An MCP-compatible client (Claude Desktop, Cursor, etc.)
Installation
# Clone the repository
git clone https://github.com/nirholas/Binance-MCP.git
cd Binance-MCP
# Install dependencies
npm install
# Build the project
npm run build
Interactive Setup
Run the setup wizard to configure your environment:
npm run init
This will guide you through:
- Setting up your Binance API credentials
- Choosing your transport method (STDIO/SSE)
- Configuring your MCP client
⚙️ Configuration
Environment Variables
Create a .env file in the project root:
BINANCE_API_KEY=your_api_key_here
BINANCE_API_SECRET=your_api_secret_here
🔒 Security Note: Never commit your
.envfile. It's already in.gitignore.
Running the Server
STDIO Transport (Claude Desktop, Cursor)
npm run start
SSE Transport (ChatGPT, Web Apps)
npm run start:sse
Development Mode (Hot Reload)
npm run dev # STDIO
npm run dev:sse # SSE
🖥️ Client Configuration
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"binance": {
"command": "node",
"args": ["/absolute/path/to/Binance-MCP/build/index.js"],
"env": {
"BINANCE_API_KEY": "your_api_key",
"BINANCE_API_SECRET": "your_api_secret"
}
}
}
}
Cursor
Add to your Cursor MCP settings:
{
"binance": {
"command": "node",
"args": ["/absolute/path/to/Binance-MCP/build/index.js"],
"env": {
"BINANCE_API_KEY": "your_api_key",
"BINANCE_API_SECRET": "your_api_secret"
}
}
}
ChatGPT (via SSE)
- Start the SSE server:
npm run start:sse - Connect to
http://localhost:3000/sse
📖 Usage Examples
Check Account Balance
"What's my current Binance account balance?"
Place a Market Order
"Buy 0.01 BTC at market price"
Get Market Data
"Show me the order book for BTCUSDT with 20 levels"
Set Up Auto-Invest
"Create a daily auto-invest plan to buy $100 of ETH"
Manage Futures Position
"Open a 5x long position on ETHUSDT futures with $1000"
📊 Module Coverage
| Module | Tools | Description |
|---|---|---|
| Wallet | 40+ | Deposits, withdrawals, transfers, asset management |
| Spot | 35+ | Market data, trading, order management |
| Futures (USD-M) | 40+ | Perpetual futures, positions, leverage |
| Futures (COIN-M) | 35+ | Coin-margined futures contracts |
| Margin (Cross) | 26 | Cross-margin trading and borrowing |
| Margin (Isolated) | 15 | Isolated margin pairs |
| Options | 27 | European-style options trading |
| Portfolio Margin | 15 | Unified margin account management |
| Sub-Account | 22 | Sub-account creation and management |
| Staking | 22+ | ETH, SOL, and other staking products |
| Simple Earn | 15+ | Flexible and locked savings products |
| Auto-Invest | 13 | DCA and recurring purchase plans |
| Mining | 13+ | Mining pool statistics and earnings |
| Algo Trading | 11+ | TWAP, VP, and algorithmic orders |
| VIP Loan | 9+ | Institutional lending services |
| Convert | 9+ | Instant asset conversion |
| Dual Investment | 10+ | Structured yield products |
| NFT | 10+ | NFT marketplace operations |
| Gift Card | 8 | Gift card creation and redemption |
| Copy Trading | 10+ | Lead trader and copy features |
| Crypto Loans | 12+ | Flexible rate crypto loans |
| Fiat | 5+ | Fiat deposit and withdrawal |
| Pay | 5+ | Binance Pay transactions |
| C2C/P2P | 5+ | Peer-to-peer trading |
| Rebate | 5+ | Referral rebate tracking |
Total: 478+ tools
🏗️ Project Structure
Binance-MCP/
├── src/
│ ├── index.ts # Entry point
│ ├── binance.ts # Module registration
│ ├── init.ts # Setup wizard
│ ├── config/
│ │ ├── binanceClient.ts # API clients with signing
│ │ └── client.ts # HTTP utilities
│ ├── server/
│ │ ├── base.ts # Base MCP server
│ │ ├── stdio.ts # STDIO transport
│ │ └── sse.ts # SSE transport
│ ├── modules/ # API module definitions
│ │ ├── spot/
│ │ ├── margin/
│ │ ├── futures-usdm/
│ │ ├── futures-coinm/
│ │ └── ... (24 modules)
│ ├── tools/ # Tool implementations
│ │ ├── binance-spot/
│ │ ├── binance-margin/
│ │ ├── binance-futures-usdm/
│ │ └── ... (24 tool sets)
│ └── utils/
│ └── logger.ts
├── docs/
│ ├── QUICK_START.md # Getting started guide
│ └── TOOLS_REFERENCE.md # Complete tool documentation
├── build/ # Compiled JavaScript
├── package.json
├── tsconfig.json
└── config.json # Runtime configuration
🛠️ Development
Build
npm run build
Type Check
npx tsc --noEmit
Test with MCP Inspector
npm run test
Adding New Tools
- Create tool file in
src/tools/binance-{module}/ - Export registration function
- Import and register in module's
index.ts - Register module in
src/binance.ts
📚 Documentation
| Resource | Description |
|---|---|
| Quick Start Guide | Get running in 5 minutes |
| Tools Reference | Complete API for all 478+ tools |
| Binance API Docs | Official Binance documentation |
| MCP Specification | Model Context Protocol spec |
⚠️ Disclaimer
This software is provided for educational and informational purposes only.
- Not Financial Advice — This tool does not provide financial, investment, or trading advice
- Use at Your Own Risk — Cryptocurrency trading involves substantial risk of loss
- API Security — Protect your API credentials; use IP restrictions and withdrawal limits
- No Warranty — The software is provided "as is" without warranty of any kind
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
👤 Author
nich — @nichxbt
Comprehensive keyword list for ERC-8004 Trustless Agents ecosystem
Core Protocol Keywords
ERC-8004, ERC8004, EIP-8004, EIP8004, Trustless Agents, trustless agent, trustless AI, trustless AI agents, agent protocol, agent standard, Ethereum agent standard, blockchain agent protocol, on-chain agents, onchain agents, on-chain AI, onchain AI, decentralized agents, decentralized AI agents, autonomous agents, autonomous AI agents, AI agent protocol, AI agent standard, agent discovery, agent trust, agent reputation, agent validation, agent identity, agent registry, identity registry, reputation registry, validation registry, agent NFT, ERC-721 agent, agent tokenId, agentId, agentURI, agentWallet, agent registration, agent registration file, agent-registration.json, agent card, agent metadata, agent endpoints, agent discovery protocol, agent trust protocol, open agent protocol, open agent standard, permissionless agents, permissionless AI, censorship-resistant agents, portable agent identity, portable AI identity, verifiable agents, verifiable AI agents, accountable agents, accountable AI, agent accountability
Blockchain & Web3 Keywords
Ethereum, Ethereum mainnet, ETH, EVM, Ethereum Virtual Machine, smart contracts, Solidity, blockchain, decentralized, permissionless, trustless, on-chain, onchain, L2, Layer 2, Base, Optimism, Polygon, Linea, Arbitrum, Scroll, Monad, Gnosis, Celo, Sepolia, testnet, mainnet, singleton contracts, singleton deployment, ERC-721, NFT, non-fungible token, tokenURI, URIStorage, EIP-712, ERC-1271, wallet signature, EOA, smart contract wallet, gas fees, gas sponsorship, EIP-7702, subgraph, The Graph, indexer, blockchain indexing, IPFS, decentralized storage, content-addressed, immutable data, public registry, public good, credibly neutral, credibly neutral infrastructure, open protocol, open standard, Web3, crypto, cryptocurrency, DeFi, decentralized finance
AI & Agent Technology Keywords
AI agents, artificial intelligence agents, autonomous AI, AI autonomy, LLM agents, large language model agents, machine learning agents, ML agents, AI assistant, AI chatbot, intelligent agents, software agents, digital agents, virtual agents, AI automation, automated agents, agent-to-agent, A2A, A2A protocol, Google A2A, Agent2Agent, MCP, Model Context Protocol, agent communication, agent interoperability, agent orchestration, agent collaboration, multi-agent, multi-agent systems, agent capabilities, agent skills, agent tools, agent prompts, agent resources, agent completions, AgentCard, agent card, agent endpoint, agent service, AI service, AI API, agent API, AI infrastructure, agent infrastructure, agentic, agentic web, agentic economy, agentic commerce, agent economy, agent marketplace, AI marketplace, agent platform, AI platform
Trust & Reputation Keywords
trust, trustless, reputation, reputation system, reputation protocol, reputation registry, feedback, client feedback, user feedback, on-chain feedback, on-chain reputation, verifiable reputation, portable reputation, reputation aggregation, reputation scoring, reputation algorithm, trust signals, trust model, trust verification, trust layer, recursive reputation, reviewer reputation, spam prevention, Sybil attack, Sybil resistance, anti-spam, feedback filtering, trusted reviewers, rating, rating system, quality rating, starred rating, uptime rating, success rate, response time, performance history, track record, audit trail, immutable feedback, permanent feedback, feedback response, appendResponse, giveFeedback, revokeFeedback, feedback tags, feedback value, valueDecimals, feedbackURI, feedbackHash, clientAddress, reviewer address
Validation & Verification Keywords
validation, validation registry, validator, validator contract, cryptographic validation, cryptographic proof, cryptographic attestation, zero-knowledge, ZK, zkML, zero-knowledge machine learning, ZK proofs, trusted execution environment, TEE, TEE attestation, TEE oracle, stake-secured, staking validators, crypto-economic security, inference re-execution, output validation, work verification, third-party validation, independent validation, validation request, validation response, validationRequest, validationResponse, requestHash, responseHash, verifiable computation, verified agents, verified behavior, behavioral validation, agent verification
Payment & Commerce Keywords
x402, x402 protocol, x402 payments, programmable payments, micropayments, HTTP payments, pay-per-request, pay-per-task, agent payments, AI payments, agent monetization, AI monetization, agent commerce, AI commerce, agentic commerce, agent economy, AI economy, agent marketplace, service marketplace, agent-to-agent payments, A2A payments, stablecoin payments, USDC, crypto payments, on-chain payments, payment settlement, programmable settlement, proof of payment, proofOfPayment, payment receipt, payment verification, Coinbase, Coinbase x402, agent pricing, API pricing, service pricing, subscription, API keys, revenue, trading yield, cumulative revenues, agent wallet, payment address, toAddress, fromAddress, txHash
Discovery & Registry Keywords
agent discovery, service discovery, agent registry, identity registry, agent registration, register agent, mint agent, agent NFT, agent tokenId, agent browsing, agent explorer, agent scanner, 8004scan, 8004scan.io, agentscan, agentscan.info, 8004agents, 8004agents.ai, agent leaderboard, agent ranking, top agents, agent listing, agent directory, agent catalog, agent index, browse agents, search agents, find agents, discover agents, agent visibility, agent discoverability, no-code registration, agent creation, create agent, my agents, agent owner, agent operator, agent transfer, transferable agent, portable agent
Endpoints & Integration Keywords
endpoint, agent endpoint, service endpoint, API endpoint, MCP endpoint, A2A endpoint, web endpoint, HTTPS endpoint, HTTP endpoint, DID, decentralized identifier, ENS, Ethereum Name Service, ENS name, agent.eth, vitalik.eth, email endpoint, OASF, Open Agent Specification Format, endpoint verification, domain verification, endpoint ownership, .well-known, well-known, agent-registration.json, endpoint domain, endpoint URL, endpoint URI, base64 data URI, on-chain metadata, off-chain metadata, metadata storage, JSON metadata, agent JSON, registration JSON
SDK & Developer Tools Keywords
SDK, Agent0 SDK, Agent0, ChaosChain SDK, ChaosChain, Lucid Agents, Daydreams AI, create-8004-agent, npm, TypeScript SDK, Python SDK, JavaScript, Solidity, smart contract, ABI, contract ABI, deployed contracts, contract addresses, Hardhat, development tools, developer tools, dev tools, API, REST API, GraphQL, subgraph, The Graph, indexer, blockchain explorer, Etherscan, contract verification, open source, MIT license, CC0, public domain, GitHub, repository, code repository, documentation, docs, best practices, reference implementation
Ecosystem & Community Keywords
ecosystem, community, builder, builders, developer, developers, contributor, contributors, partner, partners, collaborator, collaborators, co-author, co-authors, MetaMask, Ethereum Foundation, Google, Coinbase, Consensys, AltLayer, Virtuals Protocol, Olas, EigenLayer, Phala, ElizaOS, Flashbots, Polygon, Base, Optimism, Arbitrum, Scroll, Linea, Monad, Gnosis, Celo, Near Protocol, Filecoin, Worldcoin, ThirdWeb, ENS, Collab.land, DappRadar, Giza Tech, Theoriq, OpenServ, Questflow, Semantic, Semiotic, Cambrian, Nevermined, Oasis, Towns Protocol, Warden Protocol, Terminal3, Pinata Cloud, Silence Labs, Rena Labs, Index Network, Trusta Network, Turf Network
Key People & Organizations Keywords
Marco De Rossi, MetaMask AI Lead, Davide Crapis, Ethereum Foundation AI, Head of AI, Jordan Ellis, Google engineer, Erik Reppel, Coinbase engineering, Head of Engineering, Sumeet Chougule, ChaosChain founder, YQ, AltLayer co-founder, Wee Kee, Virtuals contributor, Cyfrin audit, Nethermind audit, Ethereum Foundation Security Team, security audit, audited contracts
Use Cases & Applications Keywords
trading bot, DeFi agent, yield optimizer, data oracle, price feed, analytics agent, research agent, coding agent, development agent, automation agent, task agent, workflow agent, portfolio management, asset management, supply chain, service agent, API service, chatbot, AI assistant, virtual assistant, personal agent, enterprise agent, B2B agent, agent-as-a-service, AaaS, SaaS agent, AI SaaS, delegated agent, proxy agent, helper agent, worker agent, coordinator agent, orchestrator agent, validator agent, auditor agent, insurance agent, scoring agent, ranking agent
Technical Specifications Keywords
ERC-8004 specification, EIP specification, Ethereum Improvement Proposal, Ethereum Request for Comment, RFC 2119, RFC 8174, MUST, SHOULD, MAY, OPTIONAL, REQUIRED, interface, contract interface, function signature, event, emit event, indexed event, storage, contract storage, view function, external function, public function, uint256, int128, uint8, uint64, bytes32, string, address, array, struct, MetadataEntry, mapping, modifier, require, revert, transfer, approve, operator, owner, tokenId, URI, hash, keccak256, KECCAK-256, signature, deadline
Events & Conferences Keywords
8004 Launch Day, Agentic Brunch, Builder Nights Denver, Trustless Agent Day, Devconnect, ETHDenver, community call, meetup, hackathon, workshop, conference, summit, builder program, grants, bounties, ecosystem fund
News & Media Keywords
announcement, launch, mainnet launch, testnet launch, protocol update, upgrade, security review, audit, milestone, breaking news, ecosystem news, agent news, AI news, blockchain news, Web3 news, crypto news, DeFi news, newsletter, blog, article, press release, media coverage
Competitor & Alternative Keywords
agent framework, agent platform, AI platform, centralized agents, closed agents, proprietary agents, gatekeeper, intermediary, platform lock-in, vendor lock-in, data silos, walled garden, open alternative, decentralized alternative, permissionless alternative, trustless alternative
Future & Roadmap Keywords
cross-chain, multi-chain, chain agnostic, bridge, interoperability, governance, community governance, decentralized governance, DAO, protocol upgrade, upgradeable contracts, UUPS, proxy contract, ERC1967Proxy, protocol evolution, standard finalization, EIP finalization, mainnet feedback, testnet feedback, security improvements, gas optimization, feature request, enhancement, proposal
Long-tail Keywords & Phrases
how to register AI agent on blockchain, how to create ERC-8004 agent, how to build trustless AI agent, how to verify agent reputation, how to give feedback to AI agent, how to monetize AI agent, how to accept crypto payments AI agent, how to discover AI agents, how to trust AI agents, how to validate AI agent output, decentralized AI agent marketplace, on-chain AI agent registry, blockchain-based AI reputation, verifiable AI agent identity, portable AI agent reputation, permissionless AI agent registration, trustless AI agent discovery, autonomous AI agent payments, agent-to-agent micropayments, AI agent service discovery, AI agent trust protocol, open source AI agent standard, Ethereum AI agent protocol, EVM AI agent standard, blockchain AI agent framework, decentralized AI agent infrastructure, Web3 AI agent ecosystem, crypto AI agent platform, DeFi AI agent integration, NFT-based agent identity, ERC-721 agent registration, on-chain agent metadata, off-chain agent data, IPFS agent storage, subgraph agent indexing, agent explorer blockchain, agent scanner Ethereum, agent leaderboard ranking, agent reputation scoring, agent feedback system, agent validation proof, zkML agent verification, TEE agent attestation, stake-secured agent validation, x402 agent payments, MCP agent endpoint, A2A agent protocol, ENS agent name, DID agent identity, agent wallet address, agent owner operator, transferable agent NFT, portable agent identity, censorship-resistant agent registry, credibly neutral agent infrastructure, public good agent data, open agent economy, agentic web infrastructure, trustless agentic commerce, autonomous agent economy, AI agent economic actors, accountable AI agents, verifiable AI behavior, auditable AI agents, transparent AI agents, decentralized AI governance, community-driven AI standards, open protocol AI agents, permissionless AI innovation
Brand & Product Keywords
8004, 8004.org, Trustless Agents, trustlessagents, trustless-agents, 8004scan, 8004scan.io, agentscan, agentscan.info, 8004agents, 8004agents.ai, Agent0, agent0, sdk.ag0.xyz, ChaosChain, chaoschain, docs.chaoscha.in, Lucid Agents, lucid-agents, daydreams.systems, create-8004-agent, erc-8004-contracts, best-practices, agent0lab, subgraph
Hashtags & Social Keywords
#ERC8004, #TrustlessAgents, #AIAgents, #DecentralizedAI, #OnChainAI, #AgenticWeb, #AgentEconomy, #Web3AI, #BlockchainAI, #EthereumAI, #CryptoAI, #AutonomousAgents, #AIAutonomy, #AgentDiscovery, #AgentTrust, #AgentReputation, #x402, #MCP, #A2A, #AgentProtocol, #OpenAgents, #PermissionlessAI, #VerifiableAI, #AccountableAI, #AIInfrastructure, #AgentInfrastructure, #BuildWithAgents, #AgentBuilders, #AgentDevelopers, #AgentEcosystem
Statistical Keywords
10000+ agents, 10300+ agents, 10000+ testnet registrations, 20000+ feedback, 5 months development, 80+ teams, 100+ partners, January 28 2026, January 29 2026, mainnet live, production ready, audited contracts, singleton deployment, per-chain singleton, ERC-721 token, NFT minting, gas fees, $5-20 mainnet gas
Binance MCP questions
What tools does Binance MCP provide?
It exposes 6 tools, including get_ticker_price, get_24h_stats, get_order_book, get_recent_trades, get_klines.
What can I do with the Binance MCP server?
You can execute trades, manage portfolios, analyze markets, and automate strategies through natural language, covering spot, margin, futures, and more.
Is my API data secure?
Yes, the server is designed so that your API credentials never leave your local machine.
Which AI clients are compatible with this server?
It works with Claude Desktop, Cursor, ChatGPT, and any other MCP-compatible client.
How many tools are available in this server?
The server provides over 478 tools that cover the entire Binance.com API.