Provides tools for accessing Binance Spot REST API, including market data (ticker prices, klines, exchange info), account management (balances, open orders), and trading operations (place and cancel orders) with configurable safety controls.
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
exchangeInfofor any symbol.Account tools (balances, open orders) with recvWindow helper.
Trading helpers (place/cancel) protected by
BINANCE_TRADE_ENABLEDtoggle.Works with Glama thanks to HTTP transport +
glama.yaml/Dockerfilemetadata.
Getting started
Install dependencies (Node 20+ recommended):
npm installCopy 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 modeBuild + run (stdio transport by default):
npm run build npm startDevelopment / watch mode:
npm run dev
HTTP transport
Set MCP_TRANSPORT=http and optionally PORT to expose the tools over HTTP (required for Glama inspection):
The provided Dockerfile bakes this configuration automatically.
Tools
name | description |
| Latest ticker price for a symbol. |
| Candles (symbol + interval, configurable limit). |
| Full exchange metadata + filters. |
| Account snapshot (requires API key/secret). |
| Open orders for a symbol. |
| Places MARKET/LIMIT orders with guardrails. |
| Cancels an order by symbol + orderId. |
All tools return JSON payloads stringified for LLM consumption.
Environment variables
key | description |
| Required for account/trade tools (public tools work without). |
| Required for account/trade tools. |
| Defaults to
(override for testnet). |
| RecvWindow in ms (default
). |
| Set to
to disable trade tools entirely. |
|
(default) or
. |
| HTTP port when using
(default
). |
Glama & Docker
glama.yaml/glama.jsondefine build/start commands and required env vars.Dockerfilebuilds a production image, exposes port8080, and defaults to HTTP transport for inspection support.
License
Released under the MIT License (see LICENSE).