Skip to content
MCP server

MCP

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

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
API, CLI
Runs
Locally
Version
0.5.0
Listing updated
3 days ago

About MCP

MCP is a freemium MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

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.

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>"
      }
    }
  }
}

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.

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.

MCP 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 it give trade signals?

The README describes the columns as measurements with definitions, not scores.

Is MCP free?

MCP has a free plan, with paid plans for more usage or features.

How do I add MCP 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 MCP?

The closest alternatives to MCP are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

Alternatives to MCP

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments