bitcoin-signals

CoinBucha MCP — Bitcoin signal intelligence for AI agents

Signal-first Bitcoin intelligence over MCP. Leading, non-price indicators — sovereign adoption, hiring velocity, network hashrate, ETF flows, corporate treasuries — each as a 0–100 strength, a direction, a one-line why, and primary sources.

Information, not financial advice. No tool returns a buy/sell/hold recommendation.

This is the public MCP interface for CoinBucha. The hosted server reads the same live signal data the dashboard renders, so the machine face and the human face never diverge.

Connect (hosted — recommended, no install)

The server is remote and speaks Streamable HTTP. Point any MCP client at:

https://coinbucha.com/api/mcp

Claude Desktop / Claude Code — add a custom connector with that URL, or in claude_desktop_config.json:

{
  "mcpServers": {
    "coinbucha": {
      "type": "streamable-http",
      "url": "https://coinbucha.com/api/mcp"
    }
  }
}

Cursor / other clients — add an MCP server with transport streamable-http and the URL above.

Free tier is open (IP rate-limited). Higher limits are available with an API key via the Authorization: Bearer <key> header — see coinbucha.com.

Connect (local stdio — offline/dev)

The bundled server.py exposes the same tools and fetches the live public snapshots from coinbucha.com, so it needs no local data pipeline.

pip install -r requirements.txt
python3 server.py            # stdio transport
# inspect: uv run mcp dev server.py

{
  "mcpServers": {
    "coinbucha": { "command": "python3", "args": ["server.py"] }
  }
}

Tools

Tool	Returns
scan_signals	Ranked composite signal feed (filter by min_strength, direction, signal_types) — the money tool
get_hiring_signal	Bitcoin/crypto-infra hiring velocity: open roles + 30/90-day deltas from live ATS boards
get_sovereign_reserves	Sovereign Bitcoin holdings, ranked (filter by country or tier)
get_treasury_holdings	Corporate Bitcoin treasury holdings: total BTC held by public companies + top holders
get_etf_flows	Spot Bitcoin ETF net flows (latest day + trailing 5/30-day)
get_network_signal	Bitcoin network hashrate level + 30/90-day trend
get_daily_brew	Today's machine-readable signal digest (the CoinBucha Daily Brew)

Resource coinbucha://methodology — how every signal is computed (see docs/methodology.md). Prompt morning_bitcoin_brief — one-shot template to render the Daily Brew from live signals.

Every response carries an as_of timestamp, a why, and a disclaimer.

Example

Call scan_signals with { "min_strength": 60, "direction": "tailwind" } → the strongest structural tailwinds right now, ranked, each with its rationale and sources. Or run the morning_bitcoin_brief prompt for a written digest.

Methodology & guardrail

Signals are leading, non-price indicators rendered as signal_strength (0–100), a direction, and a why. The full, versioned methodology is public — see docs/methodology.md — because an auditable method is the point.

CoinBucha's public and MCP surfaces are self-audited against MiCA / FCA / GDPR. No surface presents a signal as advice.

Links

• Dashboard: https://coinbucha.com
• MCP endpoint: https://coinbucha.com/api/mcp
• Discovery manifest: https://coinbucha.com/.well-known/mcp.json

License

MIT — see LICENSE. This repository is the public MCP interface and methodology; the signal-collection pipeline is maintained separately.