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
No login required for the free test. Paid tools request your API key when needed.

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.

Live connection check

Test the MCP before opening your AI client.

This runs a real handshake, reads the available tools, and performs one free documentation search against the production endpoint.

https://api.bitcoincounterflow.com/api/mcp

The final step uses one anonymous search_docs call from the daily free allowance.

Ready to test
production

Connect to the endpoint

Read the tool catalog

Run a documentation search

Claude Desktop setup

Four steps from URL to your first answer.

The screens may vary slightly by Claude version, but the connection flow stays the same.

1
Production endpoint
https://api.bitcoincounterflow.com/api/mcp

Copy the hosted URL

Use the official production endpoint. There is nothing to install locally.

2
Connectors

Custom connector

Add connector

Add a custom connector

In Claude settings, open Connectors and choose the option to add a custom MCP server.

3

MCP server URL

https://api.bitcoincounterflow.com/api/mcp

Authentication

No authentication

Connect without login

Paste the URL and select no authentication for the anonymous test. A key is only needed inside paid tool calls.

4
Search the BitcoinCounterFlow documentation for MVRV
BitcoinCounterFlow connected

Ask your first question

Try “Search the BitcoinCounterFlow documentation for MVRV” to verify the complete flow.

Supported client pattern
  • Claude Desktop: add the hosted URL as a custom connector and choose no authentication for the free test.
  • Claude Code, Codex and VS Code MCP clients: use the same hosted URL with no local server required.
  • Paid tools ask for your BitcoinCounterFlow API key inside the tool call when access is required.
11 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.

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

Connect in one command

Claude Code sets up anonymously with a single line. Paid tools request an API key only when the call needs one.

Claude Code
claude mcp add --transport http bitcoincounterflow https://api.bitcoincounterflow.com/api/mcp

Or paste this into any client that takes a config file

claude_desktop_config.json
{
  "mcpServers": {
    "bitcoincounterflow": {
      "url": "https://api.bitcoincounterflow.com/api/mcp"
    }
  }
}

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.