mcp · blackforge-so — Claude Code MCP server: crypto data and setup
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.
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/mcpWhat mcp 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.
What it helps with
- 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 for the agent
- Use
blackforge_catalogto show the available venues and metric definitions. - Find the pairs listed on
binanceand retrieve the latest data forBTCUSDT. - Create a formula comparing the mid prices for
BTCUSDTonbinanceandokx, then watch it.
How to install mcp
Platform CLI
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/mcpReplace <…> with your own values
Platform CLI
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/mcpReplace <…> with your own values
Config file
{
"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
Config file
{
"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
Platform CLI
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/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp
How do I install mcp in Claude Code?
Run claude mcp add mcp -e BLACKFORGE_API_KEY=<BLACKFORGE_API_KEY> -- npx -y @blackforge-so/mcp. Replace the placeholder with your API key.
What does mcp do?
It connects an agent to BlackForge market data. The tools cover metrics and time series, with live order-book access, formulas, and alerts available on eligible plans.
Can I use mcp without an API key?
The blackforge_catalog tool works without a key. Reading market data requires BLACKFORGE_API_KEY.
Similar MCP servers
MCP servers catalog →mcp by other authors comes first.
