Bitcoin SV MCP Server

MIT License
996
10
  • Apple
  • Linux

bsv_explore

Access and analyze Bitcoin SV blockchain data such as chain stats, blocks, transactions, and addresses using the WhatsOnChain API. Specify the network (main or test) and required parameters for precise results.

Instructions

Explore Bitcoin SV blockchain data using the WhatsOnChain 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.

Input Schema

NameRequiredDescriptionDefault
argsYes

Input Schema (JSON Schema)

{ "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "args": { "additionalProperties": false, "properties": { "address": { "description": "Bitcoin address (required for address_history and address_utxos endpoints)", "type": "string" }, "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" }, "days": { "description": "Number of days for miner stats endpoints (defaults to 7)", "type": "number" }, "endpoint": { "description": "WhatsOnChain API endpoint to call", "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" ], "type": "string" }, "limit": { "description": "Limit for paginated results (optional for address_history)", "type": "number" }, "network": { "default": "main", "description": "Network to use (main or test)", "enum": [ "main", "test" ], "type": "string" }, "pageNumber": { "description": "Page number for block_pages endpoint (defaults to 1)", "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", "items": { "type": "string" }, "type": "array" } }, "required": [ "endpoint" ], "type": "object" } }, "required": [ "args" ], "type": "object" }
ID: 2tjvjasfmo