BitcoinCounterFlow
MCP / BITCOINCOUNTERFLOW

Market context.
For your agents.

Connect Claude, Codex, VS Code and your own agents to Bitcoin data. Liquidation heatmaps, derivatives and on-chain metrics through one hosted MCP endpoint.

Connect to MCPPrefer REST? Explore API
One key for REST and MCP. Access follows your plan.
Your agent chooses the tool. Requests go out; market data returns.

FREE

Anonymous hosted access for first contact with the MCP server. No signup or API key required.

$0/ month
Rate limit20 calls/day per IP
HistorySnapshot values only
Access scopeSearch docs + market snapshot + 12h heatmap
Commercial useNot included
  • No signup, no API key
  • search_docs returns documentation matches
  • get_market_snapshot returns current values (no series)
  • get_liquidation_heatmap is clamped to 12h, coarse rangeStep
  • Fast path to connect an MCP client
Open MCP guide

DEVELOPER

For individual builders who want core REST and MCP access for personal workflows, prototypes, and private tooling.

$29/ month
Rate limit20 req/min
History365 days
Access scopeCore + funding, OI, liq map
Commercial useNot included
  • Core MCP tools for personal use
  • Market snapshot, docs search and essential data access
  • Same key works for REST and MCP
Choose Developer
Recommended

BUILDER

For serious individual operators who need the full MCP and REST catalog with deeper history, but not a commercial license.

$79/ month
Rate limit60 req/min
History720 days
Access scopeAdvanced REST & MCP
Commercial useNot included
  • Full MCP tool catalog unlocked
  • Includes CounterFlow signal, Daily Brief and run_backtest
  • Best fit for solo builders and power users
Choose Builder

BUSINESS

For teams, bots, research desks and products using BitcoinCounterFlow data in production under a commercial license.

$299/ month
Rate limit120 req/min
History1460 days
Access scopeAdvanced REST & MCP
Commercial useIncluded
  • Commercial and production use
  • Full REST and MCP access for internal or customer-facing systems
  • Best fit for teams before true scale needs appear
Choose Business

SCALE

For products with paying users and heavier automation needs that depend on higher throughput and the deepest operational headroom.

$999/ month
Rate limit600 req/min
HistoryUnlimited
Access scopeAll endpoints
Commercial useIncluded
  • High-throughput commercial access tier
  • Built for multi-user automation and sustained load
  • Operational headroom before enterprise contracting
Request Scale

INSTITUTIONAL

For funds and desks that need negotiated limits, contracting, invoicing and a more customized operating model.

from$2,500/month

Annual contract, billed by invoice

Rate limitNegotiated
HistoryUnlimited
Access scopeCustom contract
Commercial useContract-based
  • Custom contract and invoice billing
  • Negotiated limits and deployment model
  • Best fit for larger desks with governance needs
Talk to sales

MCP and REST reuse the same data-plan ladder. One key can unlock both surfaces.

No public free trial is live right now. Scale and Institutional onboarding can still be handled directly.

Compare MCP plans

Limits, history and tools side by side. The same key for MCP and REST.

FREE
$0
USD / month
Rate limit
20 calls/day per IP
History
Snapshot values only
Access scope
Search docs + market snapshot + 12h heatmap
Commercial use
Not included
get_liquidation_heatmapWhere leveraged positions are stacked on the order book.Sample
get_liquidation_mapProjected liquidation levels by leverage bracket.—
get_derivativesFunding rate, open interest and long-short ratio.—
get_onchain_metricsMVRV, NUPL, SOPR, Puell Multiple and more.—
get_market_snapshotPrice, dominance, Fear and Greed and more in one call.Sample
get_macro_correlationBitcoin against S&P 500, gold, Ibovespa, DXY and M2.—
get_etf_flowsSpot ETF flows and corporate treasury holdings.—
get_counterflow_signalThe contrarian positioning signal.—
get_daily_briefA consolidated daily market brief in a single call.Included
search_docsSearch the indicator glossary and documentation.Included
run_backtestRun a rule-based strategy backtest and get stats, trades and an equity curve. Rules using derivatives (funding, open interest, liquidations) need Builder or above.—
DEVELOPER
$29
USD / month
Rate limit
20 req/min
History
365 days
Access scope
Core + funding, OI, liq map
Commercial use
Not included
get_liquidation_heatmapWhere leveraged positions are stacked on the order book.—
get_liquidation_mapProjected liquidation levels by leverage bracket.Included
get_derivativesFunding rate, open interest and long-short ratio.Included
get_onchain_metricsMVRV, NUPL, SOPR, Puell Multiple and more.—
get_market_snapshotPrice, dominance, Fear and Greed and more in one call.Included
get_macro_correlationBitcoin against S&P 500, gold, Ibovespa, DXY and M2.Included
get_etf_flowsSpot ETF flows and corporate treasury holdings.Included
get_counterflow_signalThe contrarian positioning signal.—
get_daily_briefA consolidated daily market brief in a single call.Included
search_docsSearch the indicator glossary and documentation.Included
run_backtestRun a rule-based strategy backtest and get stats, trades and an equity curve. Rules using derivatives (funding, open interest, liquidations) need Builder or above.Included
BUILDER
$79
USD / month
Recommended
Rate limit
60 req/min
History
720 days
Access scope
Advanced REST & MCP
Commercial use
Not included
get_liquidation_heatmapWhere leveraged positions are stacked on the order book.Included
get_liquidation_mapProjected liquidation levels by leverage bracket.Included
get_derivativesFunding rate, open interest and long-short ratio.Included
get_onchain_metricsMVRV, NUPL, SOPR, Puell Multiple and more.Included
get_market_snapshotPrice, dominance, Fear and Greed and more in one call.Included
get_macro_correlationBitcoin against S&P 500, gold, Ibovespa, DXY and M2.Included
get_etf_flowsSpot ETF flows and corporate treasury holdings.Included
get_counterflow_signalThe contrarian positioning signal.—
get_daily_briefA consolidated daily market brief in a single call.Included
search_docsSearch the indicator glossary and documentation.Included
run_backtestRun a rule-based strategy backtest and get stats, trades and an equity curve. Rules using derivatives (funding, open interest, liquidations) need Builder or above.Included
BUSINESS
$299
USD / month
Rate limit
120 req/min
History
1460 days
Access scope
Advanced REST & MCP
Commercial use
Included
get_liquidation_heatmapWhere leveraged positions are stacked on the order book.Included
get_liquidation_mapProjected liquidation levels by leverage bracket.Included
get_derivativesFunding rate, open interest and long-short ratio.Included
get_onchain_metricsMVRV, NUPL, SOPR, Puell Multiple and more.Included
get_market_snapshotPrice, dominance, Fear and Greed and more in one call.Included
get_macro_correlationBitcoin against S&P 500, gold, Ibovespa, DXY and M2.Included
get_etf_flowsSpot ETF flows and corporate treasury holdings.Included
get_counterflow_signalThe contrarian positioning signal.—
get_daily_briefA consolidated daily market brief in a single call.Included
search_docsSearch the indicator glossary and documentation.Included
run_backtestRun a rule-based strategy backtest and get stats, trades and an equity curve. Rules using derivatives (funding, open interest, liquidations) need Builder or above.Included
SCALE
$999
USD / month
Rate limit
600 req/min
History
Unlimited
Access scope
All endpoints
Commercial use
Included
get_liquidation_heatmapWhere leveraged positions are stacked on the order book.Included
get_liquidation_mapProjected liquidation levels by leverage bracket.Included
get_derivativesFunding rate, open interest and long-short ratio.Included
get_onchain_metricsMVRV, NUPL, SOPR, Puell Multiple and more.Included
get_market_snapshotPrice, dominance, Fear and Greed and more in one call.Included
get_macro_correlationBitcoin against S&P 500, gold, Ibovespa, DXY and M2.Included
get_etf_flowsSpot ETF flows and corporate treasury holdings.Included
get_counterflow_signalThe contrarian positioning signal.Included
get_daily_briefA consolidated daily market brief in a single call.Included
search_docsSearch the indicator glossary and documentation.Included
run_backtestRun a rule-based strategy backtest and get stats, trades and an equity curve. Rules using derivatives (funding, open interest, liquidations) need Builder or above.Included
INSTITUTIONAL
Custom
Annual contract
Rate limit
Negotiated
History
Unlimited
Access scope
Custom contract
Commercial use
Contract-based
get_liquidation_heatmapWhere leveraged positions are stacked on the order book.Included
get_liquidation_mapProjected liquidation levels by leverage bracket.Included
get_derivativesFunding rate, open interest and long-short ratio.Included
get_onchain_metricsMVRV, NUPL, SOPR, Puell Multiple and more.Included
get_market_snapshotPrice, dominance, Fear and Greed and more in one call.Included
get_macro_correlationBitcoin against S&P 500, gold, Ibovespa, DXY and M2.Included
get_etf_flowsSpot ETF flows and corporate treasury holdings.Included
get_counterflow_signalThe contrarian positioning signal.Included
get_daily_briefA consolidated daily market brief in a single call.Included
search_docsSearch the indicator glossary and documentation.Included
run_backtestRun a rule-based strategy backtest and get stats, trades and an equity curve. Rules using derivatives (funding, open interest, liquidations) need Builder or above.Included

Availability also depends on the requested metric. Free samples have limited scope; premium metrics may require a higher plan.

What you get in the free demo

The anonymous tier returns current values, one coarse heatmap frame, and a documentation index. No historical series. To unlock history, funding, open interest, on-chain and the CounterFlow signal, add an API key.

search_docs

Free-form search over the documentation and indicator glossary. Returns matching sections.

Full access in the free demo

get_market_snapshot

Returns superchart-context and current values of bitcoin-stats, bitcoin-dominance, fear-greed and the spot pairs. Historical series (kline, dominance-history, performance, indicators) are blocked.

Current values, no history

get_liquidation_heatmap

Returns a coarse single-frame heatmap clamped to the last 12 hours. The high-resolution liquidation-heatmap-pro requires Scale or Institutional API access.

12h frame, coarse resolution

Calls to any other tool return a 403 with the required plan label. The 20 calls per day budget is shared across all free tools and resets at 00:00 UTC.

11 tools, one MCP server

Every tool maps to the same BitcoinCounterFlow data stack behind the REST API, for 64 distinct datasets in total.

get_liquidation_heatmap2 metricsfree sample

from Builder

Where leveraged positions are stacked on the order book.

get_liquidation_map3 metrics

from Developer

Projected liquidation levels by leverage bracket.

get_derivatives14 metrics

from Developer

Funding rate, open interest and long-short ratio.

get_onchain_metrics8 metrics

from Builder

MVRV, NUPL, SOPR, Puell Multiple and more.

get_market_snapshot14 metricsfree sample

from Developer

Price, dominance, Fear and Greed and more in one call.

get_macro_correlation17 metrics

from Developer

Bitcoin against S&P 500, gold, Ibovespa, DXY and M2.

get_etf_flows6 metrics

from Developer

Spot ETF flows and corporate treasury holdings.

get_counterflow_signal

from Scale

The contrarian positioning signal.

get_daily_brieffree sample

from Free

A consolidated daily market brief in a single call.

search_docsfree sample

from Free

Search the indicator glossary and documentation.

run_backtest

from Developer

Run a rule-based strategy backtest and get stats, trades and an equity curve. Rules using derivatives (funding, open interest, liquidations) need Builder or above.

Setup

Add the hosted server in one step

Claude Code connects with a single line. Any other MCP-compatible client takes the same endpoint and header. Anonymous access is enough for a quick test. Authenticated access applies the limits and scope of your plan automatically.

Open MCP setup
Claude Code
claude mcp add --transport http bitcoincounterflow https://api.bitcoincounterflow.com/api/mcp
claude_desktop_config.json
{
  "mcpServers": {
    "bitcoincounterflow": {
      "url": "https://api.bitcoincounterflow.com/api/mcp"
    }
  }
}

Need setup help or a commercial path?

Start with the hosted access guide, or talk to us if you need Scale or Institutional onboarding mapped to a specific workflow.

View MCP Access Contact Sales