mcpField
M
mempool-watch

mempool-watch

github.com/aibtcdevOther11140 installsUpdated 1d ago
Repository

About mempool-watch

mempool-watch is a command-line skill for checking Bitcoin transactions, address history, and live mempool statistics through the public mempool.space API. It is for users tracking on-chain activity on mainnet or testnet without authentication or a wallet.

Key features

  1. 01Check transaction confirmation status
  2. 02Retrieve address transaction history
  3. 03View pending mempool and fee statistics
  4. 04Use mainnet or testnet

Use cases

  1. 01Verify whether a transaction is confirmed
  2. 02Review recent transactions for an address
  3. 03Check mempool backlog and suggested fees

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/aibtcdev/skills --skill mempool-watch

After installing, type/mempool-watchin Claude Code to confirm it loaded.

Bundled filesAGENT.mdmempool-watch.ts

Details

From the project README

Mempool Watch Skill

Monitor the Bitcoin mempool and track on-chain activity using the mempool.space public API (no authentication required). Works on both mainnet and testnet.

Usage

bun run mempool-watch/mempool-watch.ts <subcommand> [options]

Subcommands

tx-status

Check the confirmation status of a Bitcoin transaction.

bun run mempool-watch/mempool-watch.ts tx-status --txid <txid>

Options:

  • --txid (required) — Bitcoin transaction ID to look up

Output:

{
  "txid": "abc123...",
  "network": "mainnet",
  "confirmed": true,
  "blockHeight": 880000,
  "blockHash": "000000...",
  "blockTime": "2026-01-01T00:00:00.000Z",
  "confirmations": 42,
  "explorerUrl": "https://mempool.space/tx/abc123..."
}

If unconfirmed:

{
  "txid": "abc123...",
  "network": "mainnet",
  "confirmed": false,
  "blockHeight": null,
  "blockHash": null,
  "blockTime": null,
  "confirmations": 0,
  "explorerUrl": "https://mempool.space/tx/abc123..."
}
address-history

Retrieve the transaction history for a Bitcoin address.

bun run mempool-watch/mempool-watch.ts address-history --address <addr> [--limit <n>]

Options:

  • --address (required) — Bitcoin address to look up
  • --limit (optional) — Maximum number of transactions to return (default: 10, max: 25)

Output:

{
  "address": "bc1q...",
  "network": "mainnet",
  "count": 3,
  "transactions": [
    {
      "txid": "abc123...",
      "confirmed": true,
      "blockHeight": 880000,
      "blockTime": "2026-01-01T00:00:00.000Z",
      "fee": 1200,
      "valueIn": 500000,
      "valueOut": 498800,
      "explorerUrl": "https://mempool.space/tx/abc123..."
    }
  ],
  "explorerUrl": "https://mempool.space/address/bc1q..."
}
mempool-stats

Get current Bitcoin mempool statistics including pending transaction count, backlog size, and fee histogram.

bun run mempool-watch/mempool-watch.ts mempool-stats

Output:

{
  "network": "mainnet",
  "pendingTransactions": 12400,
  "pendingVsize": 8500000,
  "totalFees": 120000000,
  "recommendedFees": {
    "fast": { "satPerVb": 15, "target": "~10 minutes (next block)" },
    "medium": { "satPerVb": 8, "target": "~30 minutes" },
    "slow": { "satPerVb": 3, "target": "~1 hour" },
    "economy": { "satPerVb": 1, "target": "~24 hours" }
  },
  "feeHistogram": [[15, 200000], [8, 500000], [3, 1000000]]
}

Notes

  • All subcommands use the public mempool.space API — no authentication or wallet required
  • Defaults to testnet unless NETWORK=mainnet is set
  • confirmations in tx-status is estimated from current block height minus the transaction's block height
  • address-history returns the most recent transactions first; mempool.space paginates via after_txid which is not exposed here — use --limit to control result size

Comments

Markdown supported