binance-mcp

Binance Spot REST MCP server providing market data, account state, and guarded trading tools. Built with FastMCP so it can run over stdio (local agents) or HTTP (Glama inspection / Docker deployments).

Features

• Latest ticker price, klines, and exchangeInfo for any symbol.
• Account tools (balances, open orders) with recvWindow helper.
• Trading helpers (place/cancel) protected by BINANCE_TRADE_ENABLED toggle.
• Works with Glama thanks to HTTP transport + glama.yaml/Dockerfile metadata.

Getting started

1. Install dependencies (Node 20+ recommended):

   npm install
   

2. Copy the example env file and fill in your Binance key/secret (testnet keys work too):

   cp .env.example .env
   # BINANCE_TRADE_ENABLED=false keeps the server in read-only mode
   

3. Build + run (stdio transport by default):

   npm run build
   npm start
   

4. Development / watch mode:

   npm run dev
   

HTTP transport

Set MCP_TRANSPORT=http and optionally PORT to expose the tools over HTTP (required for Glama inspection):

MCP_TRANSPORT=http PORT=8080 npm run dev

The provided Dockerfile bakes this configuration automatically.

Tools

name	description
binance_market_price	Latest ticker price for a symbol.
binance_market_klines	Candles (symbol + interval, configurable limit).
binance_market_exchangeInfo	Full exchange metadata + filters.
binance_account_balances	Account snapshot (requires API key/secret).
binance_account_openOrders	Open orders for a symbol.
binance_trade_placeOrder	Places MARKET/LIMIT orders with guardrails.
binance_trade_cancelOrder	Cancels an order by symbol + orderId.

All tools return JSON payloads stringified for LLM consumption.

Environment variables

key	description
BINANCE_API_KEY	Required for account/trade tools (public tools work without).
BINANCE_API_SECRET	Required for account/trade tools.
BINANCE_BASE_URL	Defaults to https://api.binance.com (override for testnet).
BINANCE_RECV_WINDOW	RecvWindow in ms (default 5000).
BINANCE_TRADE_ENABLED	Set to false to disable trade tools entirely.
MCP_TRANSPORT	stdio (default) or http.
PORT	HTTP port when using MCP_TRANSPORT=http (default 8080).

Glama & Docker

• glama.yaml / glama.json define build/start commands and required env vars.
• Dockerfile builds a production image, exposes port 8080, and defaults to HTTP transport for inspection support.

License

Released under the MIT License (see LICENSE).