# bsv_explore

Explore Bitcoin SV blockchain data using the configured explorer API. Access multiple data types:

CHAIN DATA:
- chain_info: Network stats, difficulty, and chain work
- chain_tips: Current chain tips including heights and states
- circulating_supply: Current BSV circulating supply
- peer_info: Connected peer statistics

BLOCK DATA:
- block_by_hash: Complete block data via hash (requires blockHash parameter)
- block_by_height: Complete block data via height (requires blockHeight parameter)
- tag_count_by_height: Stats on tag count for a specific block via height (requires blockHeight parameter)
- block_headers: Retrieves the last 10 block headers
- block_pages: Retrieves pages of transaction IDs for large blocks (requires blockHash and optional pageNumber)

STATS DATA:
- block_stats_by_height: Block statistics for a specific height (requires blockHeight parameter)
- block_miner_stats: Block mining statistics for a time period (optional days parameter, default 7)
- miner_summary_stats: Summary of mining statistics (optional days parameter, default 7)

TRANSACTION DATA:
- tx_by_hash: Detailed transaction data (requires txHash parameter)
- tx_raw: Raw transaction hex data (requires txHash parameter)
- tx_receipt: Transaction receipt (requires txHash parameter)
- bulk_tx_details: Bulk transaction details (requires txids parameter as array of transaction hashes)

ADDRESS DATA:
- address_history: Transaction history for address (requires address parameter, optional limit)
- address_utxos: Unspent outputs for address (requires address parameter)

NETWORK:
- health: API health check

Use the appropriate parameters for each endpoint type and specify 'main' or 'test' network.

## Result

Explorer data for the selected address, block or transaction query.

## Permissions

No spending approval is requested by this handler. Public network lookups can still fail or require a compatible service.

## Definition 1 (full)

Registered in: Before wallet setup; Legacy local wallet; Legacy local identity; Local Vault · broadcasting disabled; Local Vault · all roles; Local Vault · payment role only; Project · payments scope; External BRC-100 wallet; Local Vault + sponsor; Droplit wallet.

Explore Bitcoin SV blockchain data using the configured explorer API. Access multiple data types:

CHAIN DATA:
- chain_info: Network stats, difficulty, and chain work
- chain_tips: Current chain tips including heights and states
- circulating_supply: Current BSV circulating supply
- peer_info: Connected peer statistics

BLOCK DATA:
- block_by_hash: Complete block data via hash (requires blockHash parameter)
- block_by_height: Complete block data via height (requires blockHeight parameter)
- tag_count_by_height: Stats on tag count for a specific block via height (requires blockHeight parameter)
- block_headers: Retrieves the last 10 block headers
- block_pages: Retrieves pages of transaction IDs for large blocks (requires blockHash and optional pageNumber)

STATS DATA:
- block_stats_by_height: Block statistics for a specific height (requires blockHeight parameter)
- block_miner_stats: Block mining statistics for a time period (optional days parameter, default 7)
- miner_summary_stats: Summary of mining statistics (optional days parameter, default 7)

TRANSACTION DATA:
- tx_by_hash: Detailed transaction data (requires txHash parameter)
- tx_raw: Raw transaction hex data (requires txHash parameter)
- tx_receipt: Transaction receipt (requires txHash parameter)
- bulk_tx_details: Bulk transaction details (requires txids parameter as array of transaction hashes)

ADDRESS DATA:
- address_history: Transaction history for address (requires address parameter, optional limit)
- address_utxos: Unspent outputs for address (requires address parameter)

NETWORK:
- health: API health check

Use the appropriate parameters for each endpoint type and specify 'main' or 'test' network.

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| endpoint | "chain_info" \| "chain_tips" \| "circulating_supply" \| "peer_info" \| "block_by_hash" \| "block_by_height" \| "block_headers" \| "block_pages" \| "tag_count_by_height" \| "block_stats_by_height" \| "block_miner_stats" \| "miner_summary_stats" \| "tx_by_hash" \| "tx_raw" \| "tx_receipt" \| "bulk_tx_details" \| "address_history" \| "address_utxos" \| "health" | Yes | configured explorer API endpoint to call |  |
| network | "main" \| "test" | No | Network to use (main or test) | default: "main" |
| blockHash | string | No | Block hash (required for block_by_hash endpoint) |  |
| blockHeight | number | No | Block height (required for block_by_height and block_stats_by_height endpoints) |  |
| txHash | string | No | Transaction hash (required for tx_by_hash, tx_raw, and tx_receipt endpoints) |  |
| txids | array of string | No | Array of transaction IDs for bulk_tx_details endpoint |  |
| address | string | No | Bitcoin address (required for address_history and address_utxos endpoints) |  |
| limit | number | No | Limit for paginated results (optional for address_history) |  |
| pageNumber | number | No | Page number for block_pages endpoint (defaults to 1) |  |
| days | number | No | Number of days for miner stats endpoints (defaults to 7) |  |

Nested requirements apply when their parent is supplied.

### Input schema

```json
{
  "type": "object",
  "properties": {
    "endpoint": {
      "type": "string",
      "enum": [
        "chain_info",
        "chain_tips",
        "circulating_supply",
        "peer_info",
        "block_by_hash",
        "block_by_height",
        "block_headers",
        "block_pages",
        "tag_count_by_height",
        "block_stats_by_height",
        "block_miner_stats",
        "miner_summary_stats",
        "tx_by_hash",
        "tx_raw",
        "tx_receipt",
        "bulk_tx_details",
        "address_history",
        "address_utxos",
        "health"
      ],
      "description": "configured explorer API endpoint to call"
    },
    "network": {
      "default": "main",
      "description": "Network to use (main or test)",
      "type": "string",
      "enum": [
        "main",
        "test"
      ]
    },
    "blockHash": {
      "description": "Block hash (required for block_by_hash endpoint)",
      "type": "string"
    },
    "blockHeight": {
      "description": "Block height (required for block_by_height and block_stats_by_height endpoints)",
      "type": "number"
    },
    "txHash": {
      "description": "Transaction hash (required for tx_by_hash, tx_raw, and tx_receipt endpoints)",
      "type": "string"
    },
    "txids": {
      "description": "Array of transaction IDs for bulk_tx_details endpoint",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "address": {
      "description": "Bitcoin address (required for address_history and address_utxos endpoints)",
      "type": "string"
    },
    "limit": {
      "description": "Limit for paginated results (optional for address_history)",
      "type": "number"
    },
    "pageNumber": {
      "description": "Page number for block_pages endpoint (defaults to 1)",
      "type": "number"
    },
    "days": {
      "description": "Number of days for miner stats endpoints (defaults to 7)",
      "type": "number"
    }
  },
  "required": [
    "endpoint"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

[All tools](https://bsvmcp.com/docs/tools)