bitcoindatalabs-mcp
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)
| Repository | MCP Tool | Empirical Coverage |
|---|---|---|
| Meta / Papers | list_datasets, get_research_papers |
Full catalog + summaries, arXiv DOIs & BibTeX for the 3 Lightning security papers |
ln-client-diversity |
get_ln_client_diversity |
857 gossip snapshots, 132,360 closes, 2026 CLN shutdown metrics (arXiv:2610.20952) |
ln-upgrade-dynamics |
get_ln_upgrade_dynamics |
814 usable daily snapshots, 12 disclosures, release-line patch lag (arXiv:2610.30350) |
ln-force-close-costs |
get_ln_force_close_costs |
973,581 channel closes (523,815 force closes) through block 974,041 (arXiv:2611.16311) |
lightning-data |
get_ln_network_snapshot |
Weekly network snapshot + DuckDB PlebRank top-node leaderboard (node_rank.parquet) |
orange-dev-tracker |
get_core_dev_health |
Monthly State of Bitcoin Core engineering KPIs, review health & maintainer footprints |
orange-dev-data |
get_core_dev_health, get_bip_status |
Maintainer footprints + DuckDB search over 218 BIPs (Deployed, Draft, Closed, Complete) |
orange-funding-data |
get_ecosystem_funding |
20 funding organizations & 277 sponsored open-source developers |
oss-app-stats |
get_oss_app_stats |
Release cadence, GitHub stars & download counts across 29 core OSS projects |
orange-eco-data |
get_oss_ecosystem_health |
1,009 ecosystem repos & 109 curated projects across 14 layers: security maturity tiers, SECURITY.md coverage, and issue health |
coldcard-rng-tracker |
get_coldcard_forensics_summary |
Aggregate Coldcard weak-RNG sweep metrics, 10 attack waves & timeline (aggregates only) |
mining-pools-data |
get_mining_pool_concentration |
167 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)— ORCID0009-0004-7944-3492.
Metadata
Release files for bitcoindatalabs-mcp 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| bitcoindatalabs_mcp-0.1.1.tar.gz | 20.5 kB | With provenance | Details for bitcoindatalabs_mcp-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| bitcoindatalabs_mcp-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for bitcoindatalabs_mcp-0.1.1-py3-none-any.whl |
Total release size: 38.3 kB
Release files / bitcoindatalabs_mcp-0.1.1.tar.gz
| Download URL | bitcoindatalabs_mcp-0.1.1.tar.gz |
|---|---|
| Size | 20.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
33426ed742a563592b3c766acfcf02972611b996dddcb7c15e7605594f278ce4
|
|
BLAKE2b-256 checksum How to use checksums |
1ef5ecc7f588a091ab6ad06ce09cee455b573a1be169fb99d125420146b3a178
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.
Transparency logRelease files / bitcoindatalabs_mcp-0.1.1-py3-none-any.whl
| Download URL | bitcoindatalabs_mcp-0.1.1-py3-none-any.whl |
|---|---|
| Size | 17.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5de334cb900963f91c8ebe8dd206d5c48fe866c04a92cf8d4097ff5d86ddaaf0
|
|
BLAKE2b-256 checksum How to use checksums |
12fb9161f57fc196e77ea81b515a50cb02f782b7ab55dd3c28de6e9e88fa9463
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.
Transparency logSecurity for bitcoindatalabs-mcp 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for bitcoindatalabs_mcp-0.1.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.