About Binance Mcp
Binance Mcp is an MCP server that lets AI assistants query Binance cryptocurrency market data, including prices, candlesticks, order books and trade history. It suits users who want market questions answered in natural language. It works with Claude and Cursor and runs through npx.
Key features
- 01Real-time price and 24-hour change statistics
- 02Order book depth data
- 03Recent and historical trade records
- 04Candlestick data for multiple time periods
- 05Average price and rolling window statistics
Use cases
- 01Asking an AI assistant for the current price of Bitcoin
- 02Reviewing Ethereum's price movement over the past 24 hours
- 03Retrieving daily candlestick data for BNB over several days
MCP support
This project is an MCP server that exposes 12 Binance market data tools, such as get_price, get_klines and get_order_book, to MCP clients.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
12Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | number | No | Order book depth, default 100, max 5000 |
| symbol | string | Yes | Trading pair symbol, e.g. BTCUSDT |
Details
From the project READMEBinance Cryptocurrency MCP
Model Context Protocol service for accessing Binance cryptocurrency market data.
Overview
This MCP service allows AI agents (such as Claude, Cursor, Windsurf, etc.) to execute Binance API calls and obtain real-time data from the cryptocurrency market, including prices, candlestick charts, order books, and more.
Purpose You can directly ask AI about the latest cryptocurrency prices, trading volume, price trends, and other information, without having to check the Binance website or use other tools.
Available Information
Through this MCP service, you can obtain the following information:
- Current price information - Get real-time prices for specified cryptocurrencies
- Order book data - View buy and sell order depth
- Candlestick chart data - Obtain candlestick data for different time periods
- 24-hour price changes - View price changes within 24 hours
- Trading history - View recent trading records
- Price statistics - Get price statistics for various time windows
Available Tools
| Tool | Description |
|---|---|
get_price | Get current price for specified cryptocurrency |
get_order_book | Get order book data |
get_recent_trades | Get list of recent trades |
get_historical_trades | Get historical trade data |
get_aggregate_trades | Get list of aggregate trades |
get_klines | Get K-line/candlestick data |
get_ui_klines | Get UI-optimized K-line data |
get_avg_price | Get current average price |
get_24hr_ticker | Get 24-hour price change statistics |
get_trading_day_ticker | Get trading day market information |
get_book_ticker | Get order book ticker |
get_rolling_window_ticker | Get rolling window price change statistics |
Using in Cursor
Global Installation
Use npx to run the MCP service:
npx -y @snjyor/binance-mcp@latest
In Cursor IDE:
- Go to
Cursor Settings>MCP - Click
+ Add New MCP Service - Fill in the form:
- Name:
binance - Type:
command - Command:
npx -y @snjyor/binance-mcp@latest
- Name:
Project Installation
Add a .cursor/mcp.json file to your project:
{
"mcpServers": {
"binance": {
"command": "npx",
"args": [
"-y",
"@snjyor/binance-mcp@latest"
]
}
}
}
Usage
After configuration, the Binance market data tools will be automatically available to Cursor AI agents:
- The tool will be listed under
Available Toolsin the MCP settings - Agents will automatically use it when relevant
- You can explicitly ask agents to use these tools
Using in Other MCP-Compatible Environments
{
"mcpServers": {
"binance": {
"command": "npx",
"args": [
"-y",
"@snjyor/binance-mcp@latest"
]
}
}
}
Usage Examples
Here are some usage examples:
Query Bitcoin Price
Please tell me the current price of Bitcoin
View Ethereum's 24-hour Price Movement
How has Ethereum's price changed in the past 24 hours?
Get BNB's K-line Data
Show me the daily K-line data for BNB over the last 5 days
Development
# Install dependencies
npm install
# Build
npm run build
# Local testing
npm run start
Debugging Server
To debug your server, you can use MCP Inspector.
First build the server
npm run build
Run the following command in terminal:
# Start MCP Inspector and server
npx @modelcontextprotocol/inspector node dist/index.js
License
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.