Skip to content
MCP server

BlackForge

Normalised order-book, trade-flow and futures data for 14,000+ crypto pairs

Runs locally
Install

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/mcp

Add 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.

How AIPoweredBot checks servers