CandleFeed MCP
OfficialRegionGlobal
/About CandleFeed MCP
candlefeed-mcp is an MCP server that exposes CandleFeed order book files as tools for Claude Code, Claude Desktop, Cursor or any MCP client. It lets you find a published order book day, download it with SHA-256 checks, rebuild the Binance USD-M book locally, and query the book, spread or depth at any moment.
It also wraps four REST datasets: candles, funding rates, open interest and liquidations. The server runs locally over stdio, and order book files are rebuilt on your machine rather than on CandleFeed's servers.
The data is historical: order book days are published the morning after each UTC day ends, and known gaps are listed in a public gap log. Most days require the Pro plan ($149/mo), while a free sample day is available on the 1st of every month and REST tools follow plan limits.
AI-generated listing based on the project's public information. It may contain errors: check the original source.
/How to use CandleFeed MCP
/CandleFeed MCP tools
What your assistant can call once connected.
| Tool | What it does |
|---|---|
| l2 coverage | Published book and trade days per symbol, with unpublished days and the reason. No key needed. |
| l2 gaps | The public gap log: every stretch no capture node recorded, with times, size and reason. |
| l2 download day | Downloads one UTC day (book or trades) into the cache, size and SHA-256 checked; cached files are skipped. |
| l2 book at | Top N bids and asks at a moment, best bid/ask, mid, spread in bps, and the snapshot it was anchored on. |
| l2 spread summary | Spread statistics for a day or window, sampled every 100ms to 5min, plus the biggest 1-minute mid move. |
| l2 depth summary | Resting size within each bps band of the mid at a moment, in base asset and USDT, optionally averaged over a window. |
| candles | OHLCV data, intervals 1m to 1d. Requires an API key. |
| funding rates | Funding settlements per exchange. Requires an API key. |
| open interest | Open interest in contracts and USD. Requires a Builder key. |
| liquidations | Bucketed or tick liquidations. Requires a Builder key. |
/Before you connect CandleFeed MCP
Do I need a key or an account?
Yes: an API key from CandleFeed. Never share your password.
Which countries does it work in?
Any country.
