# BlackForge

> BlackForge is a freemium MCP server for finance and payments. Normalised order-book, trade-flow and futures data for 14,000+ crypto pairs. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://blackforge.so
- **Repository:** https://github.com/blackforge-so/mcp
- **MCP Registry name:** so.blackforge/mcp
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [analytics and data](https://ai-powered.com/categories/analytics-and-data)
- **Listing updated:** 2026-11-21

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env BLACKFORGE_API_KEY='<BLACKFORGE_API_KEY>' -- npx -y @blackforge-so/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@blackforge-so/mcp"
      ],
      "env": {
        "BLACKFORGE_API_KEY": "<BLACKFORGE_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@blackforge-so/mcp"
      ],
      "env": {
        "BLACKFORGE_API_KEY": "<BLACKFORGE_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@blackforge-so/mcp"
      ],
      "env": {
        "BLACKFORGE_API_KEY": "<BLACKFORGE_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@blackforge-so/mcp"
      ],
      "env": {
        "BLACKFORGE_API_KEY": "<BLACKFORGE_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@blackforge-so/mcp"
      ],
      "env": {
        "BLACKFORGE_API_KEY": "<BLACKFORGE_API_KEY>"
      }
    }
  }
}
```

## Tools

- `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

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

## Alternatives

- [ByKaranteli](https://ai-powered.com/mcp/bykaranteli): ByKaranteli is a freemium MCP server for finance and payments.
- [Blockmetric](https://ai-powered.com/mcp/blockmetric): Blockmetric is a freemium MCP server for finance and payments.
- [Crypto Derivatives Data API](https://ai-powered.com/mcp/crypto-derivatives-data-api): Crypto Derivatives Data API is a paid MCP server for finance and payments.
- [AfterFees](https://ai-powered.com/mcp/afterfees): AfterFees is a freemium MCP server for finance and payments.
- [BitCLI](https://ai-powered.com/mcp/bitcli): BitCLI is a paid MCP server for finance and payments.
- [Swiftedge order flow](https://ai-powered.com/mcp/swiftedge-order-flow): Swiftedge order flow is a free MCP server for finance and payments.
- [CandleFeed](https://ai-powered.com/mcp/candlefeed): CandleFeed is a freemium MCP server for finance and payments.
- [Bitcompare](https://ai-powered.com/mcp/bitcompare): Bitcompare is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/blackforge
