# mcp

Gives an agent access to BlackForge market data, from historical metrics to live order books. Use it to inspect trading pairs or track a formula against live data.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: blackforge-so
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/blackforge-so/mcp
- Updated: 2026-10-19
- HTML: https://affpapa.org/en/nevibecode/mcp/blackforge-so-mcp

## What it does

The server exposes tools for browsing venues and metric definitions, finding listed pairs, reading the latest completed interval, and fetching time series. An agent can also check recent request counts and remaining monthly row quota. The catalog works without a key; other market-data access uses `BLACKFORGE_API_KEY`.

Custom formulas and threshold alerts are available on Ultra. Live order-book and market-order pricing tools are offered on Max and Ultra. Streaming a formula with `blackforge_formula_watch` requires Node 22 or later; the other tools run on Node 20. That runtime requirement matters if you plan to monitor a formula live.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `BLACKFORGE_API_KEY`, `BLACKFORGE_BASE_URL`, `BLACKFORGE_REALTIME_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env BLACKFORGE_API_KEY=<BLACKFORGE_API_KEY> --env BLACKFORGE_BASE_URL=<BLACKFORGE_BASE_URL> --env BLACKFORGE_REALTIME_URL=<BLACKFORGE_REALTIME_URL> --transport stdio blackforge-so-mcp -- npx -y @blackforge-so/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add blackforge-so-mcp --env BLACKFORGE_API_KEY=<BLACKFORGE_API_KEY> --env BLACKFORGE_BASE_URL=<BLACKFORGE_BASE_URL> --env BLACKFORGE_REALTIME_URL=<BLACKFORGE_REALTIME_URL> -- npx -y @blackforge-so/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "blackforge-so-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@blackforge-so/mcp"
            ],
            "env": {
                "BLACKFORGE_API_KEY": "<BLACKFORGE_API_KEY>",
                "BLACKFORGE_BASE_URL": "<BLACKFORGE_BASE_URL>",
                "BLACKFORGE_REALTIME_URL": "<BLACKFORGE_REALTIME_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "blackforge-so-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@blackforge-so/mcp"
            ],
            "env": {
                "BLACKFORGE_API_KEY": "<BLACKFORGE_API_KEY>",
                "BLACKFORGE_BASE_URL": "<BLACKFORGE_BASE_URL>",
                "BLACKFORGE_REALTIME_URL": "<BLACKFORGE_REALTIME_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e BLACKFORGE_API_KEY=<BLACKFORGE_API_KEY> -e BLACKFORGE_BASE_URL=<BLACKFORGE_BASE_URL> -e BLACKFORGE_REALTIME_URL=<BLACKFORGE_REALTIME_URL> blackforge-so-mcp npx -y @blackforge-so/mcp
```
Replace <…> with your own values

## When to use it
- check which metrics a venue provides
- find trading pairs listed by an exchange
- retrieve a metric's history over a chosen range
- compare best bids and asks across venues
- watch a formula and receive an alert when it crosses a threshold

## Example prompts
- Use `blackforge_catalog` to show the available venues and metric definitions.
- Find the pairs listed on `binance` and retrieve the latest data for `BTCUSDT`.
- Create a formula comparing the mid prices for `BTCUSDT` on `binance` and `okx`, then watch it.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74569
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899

## Other versions with the same name
- [mcp · kubeshark](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — ★ 12110
- [mcp · butterbase-ai](https://affpapa.org/en/nevibecode/mcp/butterbase-ai-mcp.md) — ★ 3031
- [mcp · medplum](https://affpapa.org/en/nevibecode/mcp/mcp.md) — ★ 2766
- [mcp · sceneview](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — ★ 1349
- [mcp · buoy-gg](https://affpapa.org/en/nevibecode/mcp/buoy-gg-mcp.md) — ★ 691

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md