Repository avatar
Other Tools
v0.1.1
active

bitcoindatalabs-mcp

io.github.bitcoindatalabs/bitcoindatalabs-mcp

Zero-clone Bitcoin, Lightning & 1,009-repo OSS telemetry: Core health, BIPs & mining HHI.

Documentation

bitcoindatalabs-mcp

PyPI bitcoindatalabs/bitcoindatalabs-mcp MCP server License: MIT Python 3.11+ Organization: Bitcoin Data Labs

Zero-clone Model Context Protocol (MCP) server for Bitcoin Data Labs open telemetry, open-source ecosystem security metrics, and reproducible empirical research.

Query 1,009 ecosystem OSS repositories, Bitcoin Core governance & BIPs, developer funding, three peer-cited Lightning Network security studies (arXiv:2610.20952, 2610.30350, 2611.16311), mining pool HHI concentration, and aggregate on-chain forensics inside Claude, Cursor, Antigravity, or VS Code — without cloning any data repositories.


Quick Start (Zero Clone)

bitcoindatalabs-mcp lazily fetches only the JSON and Parquet files your query needs from github.com/bitcoindatalabs/* and caches them in ~/.cache/bitcoindatalabs-mcp/ (DuckDB queries Parquet slices in memory).

Claude Desktop / Cursor / Antigravity (mcpServers)

{
  "mcpServers": {
    "bitcoindatalabs-mcp": {
      "command": "uvx",
      "args": ["bitcoindatalabs-mcp"]
    }
  }
}

Local Python Install (also installs the bdl-mcp CLI alias)

pip install bitcoindatalabs-mcp
bitcoindatalabs-mcp   # or CLI alias: bdl-mcp

For local development against cloned bitcoindatalabs/* repositories, set BDL_GITHUB_ROOT to avoid HTTPS requests:

export BDL_GITHUB_ROOT=/path/to/github/checkouts
pip install -e ".[dev]"
pytest -v

Datasets, Tools & Resources (11 Repositories, 13 Tools, 7 Resources)

RepositoryMCP ToolEmpirical Coverage
Meta / Paperslist_datasets, get_research_papersFull catalog + summaries, arXiv DOIs & BibTeX for the 3 Lightning security papers
ln-client-diversityget_ln_client_diversity857 gossip snapshots, 132,360 closes, 2026 CLN shutdown metrics (arXiv:2610.20952)
ln-upgrade-dynamicsget_ln_upgrade_dynamics814 usable daily snapshots, 12 disclosures, release-line patch lag (arXiv:2610.30350)
ln-force-close-costsget_ln_force_close_costs973,581 channel closes (523,815 force closes) through block 974,041 (arXiv:2611.16311)
lightning-dataget_ln_network_snapshotWeekly network snapshot + DuckDB PlebRank top-node leaderboard (node_rank.parquet)
orange-dev-trackerget_core_dev_healthMonthly State of Bitcoin Core engineering KPIs, review health & maintainer footprints
orange-dev-dataget_core_dev_health, get_bip_statusMaintainer footprints + DuckDB search over 218 BIPs (Deployed, Draft, Closed, Complete)
orange-funding-dataget_ecosystem_funding20 funding organizations & 277 sponsored open-source developers
oss-app-statsget_oss_app_statsRelease cadence, GitHub stars & download counts across 29 core OSS projects
orange-eco-dataget_oss_ecosystem_health1,009 ecosystem repos & 109 curated projects across 14 layers: security maturity tiers, SECURITY.md coverage, and issue health
coldcard-rng-trackerget_coldcard_forensics_summaryAggregate Coldcard weak-RNG sweep metrics, 10 attack waves & timeline (aggregates only)
mining-pools-dataget_mining_pool_concentration167 mining pools tracked with per-year HHI and top-3 share across 2009–2026

Read-Only MCP Resources & Prompts

  • Resources: bdl://attribution, bdl://overview, bdl://papers, bdl://lightning/snapshot, bdl://core-dev/latest, bdl://ecosystem, bdl://coldcard/summary
  • Prompts: lightning_security_brief, core_governance_brief, regulatory_data_brief

Data Ethics & Attribution

  • Security outputs are aggregates only (no per-node vulnerability rankings or victim PII).
  • Server code is MIT-licensed; underlying Bitcoin Data Labs datasets are published under CC BY 4.0.
  • Attribution: Source: Bitcoin Data Labs (bitcoindatalabs.org) — ORCID 0009-0004-7944-3492.
PYPI
bitcoindatalabs-mcp
Install Command
pip install bitcoindatalabs-mcp