BlackForge
Normalised order-book, trade-flow and futures data for 14,000+ crypto pairs
BlackForge is a freemium MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
- Pricing
- Freemium
- Platforms
- API, CLI
- Runs
- Locally
- Version
- 0.5.0
- Listing updated
Similar MCP servers
Install
Run in a terminal
claude mcp add mcp --env BLACKFORGE_API_KEY='<BLACKFORGE_API_KEY>' -- npx -y @blackforge-so/mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@blackforge-so/mcp"
],
"env": {
"BLACKFORGE_API_KEY": "<BLACKFORGE_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@blackforge-so/mcp"
],
"env": {
"BLACKFORGE_API_KEY": "<BLACKFORGE_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@blackforge-so/mcp"
],
"env": {
"BLACKFORGE_API_KEY": "<BLACKFORGE_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@blackforge-so/mcp"
],
"env": {
"BLACKFORGE_API_KEY": "<BLACKFORGE_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@blackforge-so/mcp"
],
"env": {
"BLACKFORGE_API_KEY": "<BLACKFORGE_API_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
BLACKFORGE_API_KEYBlackForge API key. Every tool except blackforge_catalog requires one.BLACKFORGE_BASE_URLAPI base URL. Defaults to https://api.blackforge.so.BLACKFORGE_REALTIME_URLRealtime host for live formulas and live order book reads. Defaults to https://realtime.blackforge.so.
About BlackForge
BlackForge turns raw order books and trade feeds from nine spot exchanges into one row per pair per closed minute, with more than 150 measurement columns. The columns cover depth bands, order ladders, book churn, trade flow, outsized trades, spreads and market context. They are measurements only, never scores. This npm server is a thin stdio client over the public API and stores nothing.
Futures are included too: mark, index and last price, funding, open interest, taker flow and liquidations on linear contracts, with the liquidation columns on higher plans. Only the catalogue tool works without a key; the rest need BLACKFORGE_API_KEY, and the API enforces plan limits and reports omitted columns.
An alternative route exists for software without an account: the API can answer a request with HTTP 402 and accept a $0.005 USDC payment over x402.
Tools this server provides (7)
Taken from the project documentation; the running server may differ.
- blackforge_catalog
- List venues and column definitions, keyless
- blackforge_symbols
- List trading pairs on a venue
- blackforge_latest
- Latest bucket for an exchange and symbol
- blackforge_series
- Time series for one column over a range
- blackforge_usage
- Recent request counts and remaining quota
- blackforge_futures_symbols
- List futures contracts on a venue
- blackforge_futures_latest
- Latest bucket for a futures contract
What it does
- Catalogue tool
- blackforge_catalog lists every venue and column definition and works without a key.
- Latest and series
- Fetch the latest bucket or a time series for one column.
- Futures coverage
- Funding, open interest, prices, taker flow and liquidations for linear contracts.
- Plan-aware errors
- Omitted columns and plan limits are reported in the result.
- Usage check
- blackforge_usage shows request counts and remaining row quota.
- x402 access
- Pay per request in USDC without an account.
Good for
- Check whether an order book is deep or only looks deep
- Compare liquidity across exchanges for a pair
- Track funding and open interest on a perpetual
- Let an agent read liquidation data
Pricing
Freemium
Free plan and paid tiers exist; x402 requests $0.005 USDC; tier prices not listed
Prices change. Check blackforge.so before you buy.
BlackForge FAQ
Do I need a key?
Every tool except blackforge_catalog needs BLACKFORGE_API_KEY.
Which exchanges are covered?
Binance, Bitget, Bybit, Coinbase, Gate, Kraken, KuCoin, MEXC and OKX for spot.
What interval do I get?
1-minute rows on Ultra and pay-as-you-go; 5m, 1h and 1d rollups on every plan.
Does BlackForge give trade signals?
The README describes the columns as measurements with definitions, not scores.
Is BlackForge free?
BlackForge has a free plan, with paid plans for more usage or features.
How do I add BlackForge to Claude Code?
Run this command in your terminal: claude mcp add mcp --env BLACKFORGE_API_KEY='<BLACKFORGE_API_KEY>' -- npx -y @blackforge-so/mcp
What are the best alternatives to BlackForge?
The closest alternatives to BlackForge are ByKaranteli, Blockmetric, Crypto Derivatives Data API, AfterFees and BitCLI.
Where this comes from
- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.
