Hosted MCP access

Connect BitcoinCounterFlow to your AI tools in minutes.

Use one hosted MCP endpoint to expose liquidation heatmaps, derivatives, on-chain metrics, macro context and market snapshots inside Claude, Codex, VS Code, and other MCP-compatible clients.

Hosted endpoint
https://api.bitcoincounterflow.com/api/mcp
Authentication
Pass your key in the X-API-Key header

How access works

You can start anonymously for quick testing, then unlock deeper access with the same account area used for API keys.

Anonymous demo

Good for first contact. No signup or key required. Limited daily usage and free tools only.

Personal access

Best for builders and individual operators. Your API key unlocks MCP and REST together.

Production access

Business and higher tiers are for higher throughput, commercial use, and deeper operational needs.

Setup flow
1

Get or create your API key

Use your account area to generate and rotate the same key used for REST and MCP access.

2

Paste the hosted endpoint into your MCP client

Point your client to the BitcoinCounterFlow endpoint and attach the X-API-Key header.

3

Start calling tools

Once connected, your client can request snapshots, derivatives, on-chain metrics, heatmaps and documentation search.

Supported client pattern
  • Claude Code: run the one-line command below. Claude Desktop: paste the JSON snippet.
  • Codex and VS Code MCP clients: use the same hosted URL and X-API-Key header in the client configuration.
  • Custom MCP clients: point them to the HTTPS endpoint and forward your API key securely.
10 tools your agent can call

The MCP server mirrors the data catalog behind the API, so one key can support both programmatic and agent-based workflows. Seven of these tools take a metric parameter, 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.

Connect in one command

Claude Code sets up with a single line. Other MCP-compatible clients can use the same URL and header model.

Claude Code
claude mcp add --transport http bitcoincounterflow https://api.bitcoincounterflow.com/api/mcp --header "X-API-Key: YOUR_API_KEY"

Or paste this into any client that takes a config file

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

Need a key or a bigger tier?

Use the pricing page to compare access levels, or open your account settings if you already have a plan and just need to configure the integration.