MCP Server for AI Agents

Bitcoin market data for Claude, Codex, VS Code and custom agents

One hosted MCP endpoint for liquidation heatmaps, derivatives, on-chain metrics, macro context and workflow-ready Bitcoin tools. The same API key can unlock REST and MCP together.

Open MCP Access Prefer REST? See API Pricing

Already on Nakamoto Pro or Pro Desk? Personal MCP access is handled as part of your workspace plan. Use API Settings to manage your key, or compare data-only tiers below if you need a separate builder or commercial plan.

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.

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 is Enterprise only.

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.

10 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.

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 --header "X-API-Key: YOUR_API_KEY"

claude_desktop_config.json

{
  "mcpServers": {
    "bitcoincounterflow": {
      "url": "https://api.bitcoincounterflow.com/api/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

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