Bitcoin Risk Brief

io.github.akarazhevPublished by GitHub account akarazhevv0.1.1Updated Oct 24, 2026

Daily Bitcoin risk with freshness state on every response. Research context, not advice.

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

Local MCP server that gives an assistant daily Bitcoin risk scores, freshness state and scenario price ladders from the Bitcoin Risk Brief API.

What you can do
Retrieve daily Bitcoin risk data: a 0.0–1.0 risk metric, latest low/neutral/high state and two-year risk history from the Bitcoin Risk Brief API, with a freshness state on every response. Check readiness and validation status before relying on any current value. Read completed-candle HLC3 model price context and a risk-level scenario ladder in 0.025 increments. Present the daily brief and analytics as research context, not advice.
When to use it
Use it when an assistant needs a transparent, reproducible daily read on Bitcoin risk, or wants to show how hypothetical prices map to risk levels. It suits research and explanation rather than trading decisions.
Requirements
Runs as a local npm package over stdio, so Node.js is needed. It calls the Bitcoin Risk Brief API; the BRB_API_BASE_URL variable sets the base URL and defaults to the public instance. No account or API key is declared. Network access to the API is required.
Before you install
The data is research context, not financial advice, and the scenario ladder is not a forecast or trading instruction. Values are only meaningful when the readiness check passes; the README says agents must call the readiness endpoint first and bind values to its dates and freshness state. The README also notes the OpenAPI endpoint deployment is still pending.

Installation

In SourceWeft

  1. Open Bitcoin Risk Brief in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Bitcoin Risk Brief

Bitcoin Risk Brief is a free, open-source product that turns canonical daily BTC/USD data into a transparent risk score, freshness state, and scenario price ladder. It is free permanently: no paid tier, no accounts, no SLA. The owned source code, documentation, and configuration are Apache-2.0; bundled third-party BTC/USD market data is not.

[CI] [License: Apache-2.0] [Live site]

[Bitcoin Risk Brief first viewport with current risk and readiness]

First viewport captured on 2026-08-09; the values shown are a point-in-time example.

Live product: bitcoinriskbrief.minihub.app

Check readiness before using any current value:

bash
curl --fail --silent --show-error https://bitcoinriskbrief.minihub.app/api/readiness

Response captured on 2026-08-09:

json
{  "status": "ready",  "checks": {    "risk_data_available": true,    "validation_available": true,    "risk_range_ok": true,    "validation_has_rows": true,    "latest_matches_validation_end": true,    "source_is_canonical": true,    "data_fresh": true  },  "data": {    "latest_date": "2026-08-08",    "covered_end": "2026-08-08",    "data_age_days": 1,    "max_age_days": 2,    "source": "coinmarketcap_csv",    "row_count": 5871,    "methodology_version": "crypto-scout-canonical-v1.1"  }}

What it does

  • Computes a daily 0.0–1.0 Bitcoin risk metric from the canonical collector/btc-csv/btc_usd_daily.csv history.
  • Shows the latest low, neutral, or high state alongside a two-year risk history chart.
  • Displays completed-candle HLC3 model price context and a risk-level scenario ladder in 0.025 increments.
  • Publishes a daily brief in English, Russian, Simplified Chinese, German, French, Spanish, and Arabic.
  • Exposes read-only analytics endpoints and accepts email waitlist contacts server-side, never in browser storage; users should not submit sensitive information.

What makes it different

  • Visible freshness and readiness. The UI shows the latest completed day and validation state; /api/readiness returns HTTP 503 when freshness or validation checks fail.
  • Deterministic and reproducible. A versioned methodology recomputes the metric from the same canonical daily history, with validation metadata recording each import.
  • Scenarios, not forecasts. The price ladder runs hypothetical prices through the same model to show where risk levels would change; it is not a prediction or trading instruction.

Current Status

Current operational status, evidence, and accepted limitations: Production Readiness.

For AI agents

Start with the repository llms.txt. This branch defines the machine-readable /api/openapi.json endpoint; deployment remains pending operator work. Use the Agent Access Pack for endpoint examples, cache semantics, and interpretation boundaries.

Agents must call /api/readiness first, bind reported values to its dates and freshness state, and preserve the analytics-not-advice framing.

Architecture

ServiceStackPurpose
timescaledbTimescaleDB/PostgreSQLBTC OHLCV, risk rows, validation state, brief snapshots, waitlist leads
data-collectorPython, asyncpg, APScheduler, httpxDaily CSV refresh, full CSV import, risk recomputation
backendFastAPI, asyncpgAPI, readiness, waitlist storage, risk and brief reads
frontendReact, Vite, ECharts, nginxPublic seven-locale interface and API proxy
mermaid
flowchart LR    Source[CoinMarketCap public download<br/>or optional API] --> CSV[Canonical BTC daily CSV]    Schedule[Daily collector schedule] --> Collector[data-collector]    CSV --> Collector    Collector --> DB[(TimescaleDB)]    DB --> API[FastAPI backend]    API --> UI[React frontend]    API --> Agents[AI agents and API clients]

The canonical CSV remains the durable source of truth; the collector refreshes and validates it, recomputes risk, and writes the daily snapshot consumed by the API.

Quick Start

bash
cp .env.example .env./scripts/manage.sh validate./scripts/manage.sh start./scripts/manage.sh migrate./scripts/manage.sh backfill

Open: http://localhost:3001

Documentation

Disclaimer and licence

Bitcoin Risk Brief provides analytics and research context only. It is not financial advice, investment advice, a price forecast, or a trading recommendation.

Owned source code, documentation, and configuration are licensed under Apache-2.0. Bundled third-party BTC/USD market data remains subject to source-provider terms; see NOTICE.

Source: README.md at commit 517a28d

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts