Skip to main content

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)

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) — ORCID 0009-0004-7944-3492.

Metadata

Release files for bitcoindatalabs-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bitcoindatalabs-mcp 0.1.0
File Size Uploaded Provenance Actions
bitcoindatalabs_mcp-0.1.0.tar.gz 20.3 kB With provenance Details for bitcoindatalabs_mcp-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for bitcoindatalabs-mcp 0.1.0
File Interpreter ABI Platform Actions
bitcoindatalabs_mcp-0.1.0-py3-none-any.whl Python 3 none any Details for bitcoindatalabs_mcp-0.1.0-py3-none-any.whl

Total release size: 38.1 kB

Release files / bitcoindatalabs_mcp-0.1.0.tar.gz

Download URL bitcoindatalabs_mcp-0.1.0.tar.gz
Size 20.3 kB
Tags Source
SHA-256 checksum
How to use checksums
cee391483889194f6aefafd05e7c2b5df1043f9dae98dd07cb3fb579aa1a3682
BLAKE2b-256 checksum
How to use checksums
005e6c3bcfa92b43d5171f1c245769f161e98b184c49a99a4a4a16dd1d983aa7
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 log

Release files / bitcoindatalabs_mcp-0.1.0-py3-none-any.whl

Download URL bitcoindatalabs_mcp-0.1.0-py3-none-any.whl
Size 17.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3fd859a291202fd80cf257f544a96a69aa3928c9a7392ee741fb3ca1fc1e6970
BLAKE2b-256 checksum
How to use checksums
3b21805039c60757f1a221918ea48b58bdf704d334336e81b915a156cbfde93a
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 log

Security for bitcoindatalabs-mcp 0.1.0

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.

Select from 2 files

Attestation for bitcoindatalabs_mcp-0.1.0.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 log

A 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.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page