# MCP

> MCP 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, analytics and data
- **Listing updated:** 2026-11-14

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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

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