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
Step 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
Step 2
ConnectorsMCP

Custom connector

api.bitcoincounterflow.com

Hosted
Add connector

Add a custom connector

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

3
Step 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
Step 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
  • 01
    Claude Desktop: add the hosted URL as a custom connector and choose no authentication for the free test.
  • 02
    Claude Code, Codex and VS Code MCP clients: use the same hosted URL with no local server required.
  • 03
    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 metrics

    Where leveraged positions are stacked on the order book.

    from Builderfree sample
  • get_liquidation_map3 metrics

    Projected liquidation levels by leverage bracket.

    from Developer
  • get_derivatives14 metrics

    Funding rate, open interest and long-short ratio.

    from Developer
  • get_onchain_metrics8 metrics

    MVRV, NUPL, SOPR, Puell Multiple and more.

    from Builder
  • get_market_snapshot14 metrics

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

    from Developerfree sample
  • get_macro_correlation17 metrics

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

    from Developer
  • get_etf_flows6 metrics

    Spot ETF flows and corporate treasury holdings.

    from Developer
  • get_counterflow_signal

    The contrarian positioning signal.

    from Scale
  • get_daily_brief

    A consolidated daily market brief in a single call.

    from Freefree sample
  • search_docs

    Search the indicator glossary and documentation.

    from Freefree sample
  • run_backtest

    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.

    from Developer
Choose your AI client

The right setup, ready to copy.

There is no reliable universal link that can configure every desktop AI app. Choose your client and copy the exact URL, command, or config it accepts.

URL + Connectors

Claude Desktop

Paste in Settings → Connectors → Add custom connector, then choose no authentication.

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

Claude Code

Run one command to register the hosted HTTP server anonymously.

claude mcp add --transport http bitcoincounterflow https://api.bitcoincounterflow.com/api/mcp
Terminal command

Codex

Register the remote server in Codex with its official MCP command.

codex mcp add bitcoincounterflow --url https://api.bitcoincounterflow.com/api/mcp
JSON config

Other MCP clients

Use this in clients that accept an mcpServers configuration object.

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

Prefer to ask the agent?

Copy a ready-made instruction and paste it into a terminal-capable agent. It includes the endpoint, anonymous authentication mode, and a first test.

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.