# btc-public-data

Local MCP server plus CLI wrapping public Bitcoin APIs. No keys. No private data.

Eight tools, same interface for the CLI and MCP `tools/list` / `tools/call`:

- `get_fees` — mempool.space recommended sat/vB
- `get_mempool` — backlog count, vsize, total fees
- `get_hashrate` — network hashrate and difficulty
- `get_network` — tip height from mempool.space and Blockstream, difficulty, prices
- `get_tx` — Blockstream public tx summary
- `get_address` — Blockstream watch-only address stats
- `get_lightning` — Lightning nodes, channels, capacity, typical fees
- `snapshot` — one-call dashboard

Second source is Blockstream Esplora so tip / tx / address can be checked independently. HTTP GETs use a 15s TTL cache and retry 429 / 5xx.

## Run

```bash
bun src/cli.ts list
bun src/cli.ts snapshot
bun src/cli.ts get_fees
bun src/server.ts
```

```bash
bun test
```

## Optional Lightning support

The tool is MIT and free. An optional 5,000-sat Lightning add-on is on [SUPPORT.md](SUPPORT.md).

## License

[MIT](LICENSE) © 2026 Matthew Ball