binance-mcp

A Model Context Protocol (stdio) server that wraps tiagosiebler/binanceUSDMClient for USD-M futures (REST). Use it from Cursor, Claude, or any MCP host.

Prerequisites

• Node.js 20+
• pnpm

Install

cd binance-mcp
pnpm install
cp .env.example .env
# Edit .env if you need signed endpoints or trading
pnpm run build

Run (stdio)

pnpm start
# or
node dist/index.js

Cursor / IDE

Add a server entry that runs this package (similar to other stdio MCPs):

{
"mcpServers": {
"binance-usdm": {
"command": "node",
"args": ["/absolute/path/to/auto_trade/binance-mcp/dist/index.js"],
"env": {
"BINANCE_API_KEY": "...",
"BINANCE_SECRET_KEY": "...",
"BINANCE_TRADING_ENABLED": "false"
}
}
}
}

Use pnpm + tsx for dev without building:

"command": "pnpm",
"args": ["exec", "tsx", "src/index.ts"],
"cwd": "/absolute/path/to/auto_trade/binance-mcp"

Tools

Name	Auth	Notes
usdm_ping	Public	Connectivity
usdm_get_server_time	Public	Server time
usdm_get_exchange_info	Public	Optional symbol filter
usdm_get_mark_price	Public	One or all symbols
usdm_get_funding_rates	Public	Current funding
usdm_get_orderbook	Public	symbol, optional limit
usdm_get_24h_ticker	Public	One or all symbols
usdm_get_account_balance	Signed	Needs API keys
usdm_get_account_information	Signed	Full account state
usdm_get_positions	Signed	Optional symbol
usdm_get_open_orders	Signed	Optional symbol
usdm_get_open_algo_orders	Signed	Optional symbol
usdm_get_order	Signed	orderId or origClientOrderId
usdm_get_historical_orders	Signed	Past orders for a symbol (time / limit / orderId anchor)
usdm_get_account_trades	Signed	Fills / executions (use for trade-level questions)
usdm_get_income_history	Signed	PnL, funding, commission ledger
usdm_get_algo_order	Signed	One conditional order by algoId / clientAlgoId
usdm_get_historical_algo_orders	Signed	Past algo/TP/SL orders for a symbol
usdm_submit_order	Signed + trading	BINANCE_TRADING_ENABLED=true
usdm_cancel_order	Signed + trading
usdm_cancel_all_open_orders	Signed + trading	Per symbol
usdm_cancel_algo_order	Signed + trading	algoId or clientAlgoId

Without API keys, only public tools are registered (plus a small usdm_private_tools_disabled hint). With keys but BINANCE_TRADING_ENABLED unset/false, read-only account tools work; a usdm_trading_disabled tool explains how to enable order placement.

Safety

• Default: trading tools are off until BINANCE_TRADING_ENABLED=true.
• Prefer testnet (BINANCE_TESTNET=true) or demo trading (BINANCE_DEMO_TRADING=true) while integrating — but not both: the binance SDK has no demo-trading URL for USDM testnet, so if both env vars are true the server drops demo trading and uses testnet only (you’ll see a stderr warning).
• This server exposes real trading capability when enabled and on mainnet — treat API keys like root passwords.

License

MIT (same spirit as the upstream binance SDK; confirm your own compliance with Binance ToS).