Bitcoin SV MCP Server

MIT License
996
10
  • Apple
  • Linux

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
DISABLE_TOOLSNoSet to true to disable all toolsfalse
DISABLE_PROMPTSNoSet to true to disable all educational promptsfalse
PRIVATE_KEY_WIFNoYour private key in WIF format for Bitcoin wallet operations
IDENTITY_KEY_WIFNoOptional WIF for identity key; if set, ordinals inscriptions will be signed with sigma-protocol for authentication, curation, and web-of-trust
DISABLE_BSV_TOOLSNoSet to true to disable BSV blockchain toolsfalse
DISABLE_RESOURCESNoSet to true to disable all resources (BRCs, changelog)false
DISABLE_MNEE_TOOLSNoSet to true to disable MNEE token toolsfalse
DISABLE_UTILS_TOOLSNoSet to true to disable utility toolsfalse
DISABLE_BROADCASTINGNoSet to true to disable transaction broadcasting; returns raw transaction hex instead - useful for testing and transaction review before broadcastingfalse
DISABLE_WALLET_TOOLSNoSet to true to disable Bitcoin wallet toolsfalse
DISABLE_ORDINALS_TOOLSNoSet to true to disable Ordinals/NFT toolsfalse

Schema

Prompts

Interactive templates invoked by user choice

NameDescription
bitcoin_sv_ordinalsComprehensive information about Bitcoin SV ordinals, including what they are, how they work, and how to use them.
bitcoin_sv_sdk_overviewGeneral overview of the Bitcoin SV SDK, including its purpose and main components.
bitcoin_sv_sdk_walletDetailed information about the wallet functionality in the BSV SDK, including key management, address handling, and UTXO management.
bitcoin_sv_sdk_transactionDetailed information about transaction building and management in the BSV SDK, including input/output handling, script integration, and transaction signing.
bitcoin_sv_sdk_authDetailed information about the authentication functionality in the BSV SDK, including identity protocols, certificates, and session management.
bitcoin_sv_sdk_cryptographyDetailed information about the cryptographic functionality in the BSV SDK, including key generation, signing, encryption, and hashing.
bitcoin_sv_sdk_scriptDetailed information about the script functionality in the BSV SDK, including Bitcoin Script operations, locking and unlocking scripts, and OP_CODES.
bitcoin_sv_sdk_primitivesDetailed information about the primitive data types and structures in the BSV SDK, including Binary, Hex, Points, and other fundamental types.

Resources

Contextual data attached and managed by the client

NameDescription
brcs_readmeOverview of all Bitcoin SV protocol specifications in the BRCs repository
brcs_summaryTable of contents for all Bitcoin SV BRCs
brc_0000_bananapoweredBitcoin SV BRC-0: Banana-Powered Bitcoin Wallet Control Protocol
brc_0001_transactionBitcoin SV BRC-1: Transaction Creation
brc_0002_dataBitcoin SV BRC-2: Data Encryption and Decryption
brc_0003_digitalBitcoin SV BRC-3: Digital Signature Creation and Verification
brc_0004_inputBitcoin SV BRC-4: Input Redemption
brc_0005_httpBitcoin SV BRC-5: HTTP Wallet Communications Substrate
brc_0006_walletBitcoin SV BRC-6: XDM Wallet Communications Substrate
brc_0007_windowBitcoin SV BRC-7: Window Wallet Communication Substrate
brc_0008_everettstyleBitcoin SV BRC-8: Everett-style Transaction Envelopes
brc_0009_simplifiedBitcoin SV BRC-9: Simplified Payment Verification
brc_0010_merkleBitcoin SV BRC-10: Merkle proof standardised format
brc_0011_proofBitcoin SV BRC-11: TSC Proof Format with Heights
brc_0012_transactionBitcoin SV BRC-12: Raw Transaction Format
brc_0013_transactionBitcoin SV BRC-13: TXO Transaction Object Format
brc_0014_scriptBitcoin SV BRC-14: Bitcoin Script Binary, Hex and ASM Formats
brc_0015_scriptBitcoin SV BRC-15: Bitcoin Script Assembly Language
brc_0016_publicBitcoin SV BRC-16: Pay to Public Key Hash
brc_0017_puzzleBitcoin SV BRC-17: Pay to R Puzzle Hash
brc_0018_falseBitcoin SV BRC-18: Pay to False Return
brc_0019_trueBitcoin SV BRC-19: Pay to True Return
brc_0020_thereBitcoin SV BRC-20: There is no BRC-20
brc_0021_pushBitcoin SV BRC-21: Push TX
brc_0022_overlayBitcoin SV BRC-22: Overlay Network Data Synchronization
brc_0023_confederacyBitcoin SV BRC-23: Confederacy Host Interconnect Protocol (CHIP)
brc_0024_overlayBitcoin SV BRC-24: Overlay Network Lookup Services
brc_0025_confederacyBitcoin SV BRC-25: Confederacy Lookup Availability Protocol (CLAP)
brc_0026_universalBitcoin SV BRC-26: Universal Hash Resolution Protocol
brc_0027_directBitcoin SV BRC-27: Direct Payment Protocol (DPP)
brc_0028_paymailBitcoin SV BRC-28: Paymail Payment Destinations
brc_0029_simpleBitcoin SV BRC-29: Simple Authenticated BSV P2PKH Payment Protocol
brc_0030_transactionBitcoin SV BRC-30: Transaction Extended Format (EF)
brc_0031_authriteBitcoin SV BRC-31: Authrite Mutual Authentication
brc_0032_bip32Bitcoin SV BRC-32: BIP32 Key Derivation Scheme
brc_0033_peerservBitcoin SV BRC-33: PeerServ Message Relay Interface
brc_0034_peerservBitcoin SV BRC-34: PeerServ Host Interconnect Protocol
brc_0036_formatBitcoin SV BRC-36: Format for Bitcoin Outpoints
brc_0037_spendingBitcoin SV BRC-37: Spending Instructions Extension for UTXO Storage Format
brc_0041_packetpayBitcoin SV BRC-41: PacketPay HTTP Payment Mechanism
brc_0042_derivationBitcoin SV BRC-42: BSV Key Derivation Scheme (BKDS)
brc_0043_securityBitcoin SV BRC-43: Security Levels, Protocol IDs, Key IDs and Counterparties
brc_0044_adminreservedBitcoin SV BRC-44: Admin-reserved and Prohibited Key Derivation Protocols
brc_0045_definitionBitcoin SV BRC-45: Definition of UTXOs as Bitcoin Tokens
brc_0046_walletBitcoin SV BRC-46: Wallet Transaction Output Tracking (Output Baskets)
brc_0047_bareBitcoin SV BRC-47: Bare Multi-Signature
brc_0048_pushBitcoin SV BRC-48: Pay to Push Drop
brc_0049_usersBitcoin SV BRC-49: Users should never see an address
brc_0050_submittingBitcoin SV BRC-50: Submitting Received Payments to a Wallet
brc_0051_listBitcoin SV BRC-51: List of user experiences
brc_0052_identityBitcoin SV BRC-52: Identity Certificates
brc_0053_certificateBitcoin SV BRC-53: Certificate Creation and Revelation
brc_0054_hybridBitcoin SV BRC-54: Hybrid Payment Mode for DPP
brc_0055_httpsBitcoin SV BRC-55: HTTPS Transport Mechanism for DPP
brc_0056_unifiedBitcoin SV BRC-56: Unified Abstract Wallet-to-Application Messaging Layer
brc_0057_legitimateBitcoin SV BRC-57: Legitimate Uses for mAPI
brc_0058_merkleBitcoin SV BRC-58: Merkle Path JSON format
brc_0059_securityBitcoin SV BRC-59: Security and Scalability Benefits of UTXO-based Overlay Networks
brc_0060_simplifyingBitcoin SV BRC-60: Simplifying State Machine Event Chains in Bitcoin
brc_0061_compoundBitcoin SV BRC-61: Compound Merkle Path Format
brc_0062_backgroundBitcoin SV BRC-62: Background Evaluation Extended Format (BEEF) Transactions
brc_0063_genealogicalBitcoin SV BRC-63: Genealogical Identity Protocol
brc_0064_overlayBitcoin SV BRC-64: Overlay Network Transaction History Tracking
brc_0065_transactionBitcoin SV BRC-65: Transaction Labels and List Actions
brc_0066_outputBitcoin SV BRC-66: Output Basket Removal and Certificate Deletion
brc_0067_simplifiedBitcoin SV BRC-67: Simplified Payment Verification
brc_0068_publishingBitcoin SV BRC-68: Publishing Trust Anchor Details at an Internet Domain
brc_0069_revealingBitcoin SV BRC-69: Revealing Key Linkages
brc_0070_paymailBitcoin SV BRC-70: Paymail BEEF Transaction
brc_0071_merkleBitcoin SV BRC-71: Merkle Path Binary Format
brc_0072_protectingBitcoin SV BRC-72: Protecting BRC-69 Key Linkage Information in Transit
brc_0073_groupBitcoin SV BRC-73: Group Permissions for App Access
brc_0074_unifiedBitcoin SV BRC-74: BSV Unified Merkle Path (BUMP) Format
brc_0075_mnemonicBitcoin SV BRC-75: Mnemonic For Master Private Key
brc_0076_graphBitcoin SV BRC-76: Graph Aware Sync Protocol
brc_0077_messageBitcoin SV BRC-77: Message Signature Creation and Verification
brc_0078_serializationBitcoin SV BRC-78: Serialization Format for Portable Encrypted Messages
brc_0079_tokenBitcoin SV BRC-79: Token Exchange Protocol for UTXO-based Overlay Networks
brc_0080_improvingBitcoin SV BRC-80: Improving on MLD for BSV Multicast Services
brc_0081_privateBitcoin SV BRC-81: Private Overlays with P2PKH Transactions
brc_0082_definingBitcoin SV BRC-82: Defining a Scalable IPv6 Multicast Protocol for Blockchain Transaction Broadcast
brc_0083_scalableBitcoin SV BRC-83: Scalable Transaction Processing in the BSV Network
brc_0084_linkedBitcoin SV BRC-84: Linked Key Derivation Scheme
brc_0085_provenBitcoin SV BRC-85: Proven Identity Key Exchange (PIKE)
brc_0086_bidirectionallyBitcoin SV BRC-86: Bidirectionally Authenticated Derivation of Privacy Restricted Type 42 Keys
brc_0087_standardizedBitcoin SV BRC-87: Standardized Naming Conventions for BRC-22 Topic Managers and BRC-24 Lookup Services
brc_0088_overlayBitcoin SV BRC-88: Overlay Services Synchronization Architecture
brc_0089_standardBitcoin SV BRC-89: Web 3.0 Standard (at a high level)
brc_0090_thoughtsBitcoin SV BRC-90: Thoughts on the Mandala Network
brc_0091_outputsBitcoin SV BRC-91: Outputs, Overlays, and Scripts in the Mandala Network
brc_0092_mandalaBitcoin SV BRC-92: Mandala Token Protocol
brc_0093_limitationsBitcoin SV BRC-93: Limitations of BRC-69 Key Linkage Revelation
brc_0094_verifiableBitcoin SV BRC-94: Verifiable Revelation of Shared Secrets Using Schnorr Protocol
brc_0095_atomicBitcoin SV BRC-95: Atomic BEEF Transactions
brc_0096_beefBitcoin SV BRC-96: BEEF V2 Txid Only Extension
brc_0097_extensibleBitcoin SV BRC-97: Extensible Proof-Type Format for Specific Key Linkage Claims
brc_0098_protocolsBitcoin SV BRC-98: P Protocols: Allowing future wallet protocol permission schemes
brc_0099_basketsBitcoin SV BRC-99: P Baskets: Allowing Future Wallet Basket and Digital Asset Permission Schemes
brc_0100_unifiedBitcoin SV BRC-100: Unified, Vendor-Neutral, Unchanging, and Open BSV Blockchain Standard Wallet-to-Application Interface
brc_0101_diverseBitcoin SV BRC-101: Diverse Facilitators and URL Protocols for SHIP and SLAP Overlay Advertisements
brc_0102_deploymentinfojsonBitcoin SV BRC-102: The deployment-info.json Specification
brc_0103_peertopeerBitcoin SV BRC-103: Peer-to-Peer Mutual Authentication and Certificate Exchange Protocol
brc_0104_httpBitcoin SV BRC-104: HTTP Transport for BRC-103 Mutual Authentication
brc_0105_httpBitcoin SV BRC-105: HTTP Service Monetization Framework
bsv-mcp-changelogVersion history and changelog for the BSV MCP server
junglebus-api-docsAPI documentation for JungleBus, a transaction monitoring service for Bitcoin SV

Tools

Functions exposed to the LLM to take actions

NameDescription
bsv_getPrice

Retrieves the current price of Bitcoin SV (BSV) in USD from a reliable exchange API. This tool provides real-time market data that can be used for calculating transaction values, monitoring market conditions, or converting between BSV and fiat currencies.

bsv_decodeTransaction

Decodes and analyzes Bitcoin SV transactions to provide detailed insights. This powerful tool accepts either a transaction ID or raw transaction data and returns comprehensive information including inputs, outputs, fee calculations, script details, and blockchain context. Supports both hex and base64 encoded transactions and automatically fetches additional on-chain data when available.

bsv_explore

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.

ordinals_getInscription

Retrieves detailed information about a specific ordinal inscription by its outpoint. Returns complete inscription data including content type, file information, inscription origin, and current status. Useful for verifying NFT authenticity or retrieving metadata about digital artifacts.

ordinals_searchInscriptions

Searches for Bitcoin SV ordinal inscriptions using flexible criteria. This powerful search tool supports filtering by address, inscription content, MIME type, MAP fields, and other parameters. Results include detailed information about each matched inscription. Ideal for discovering NFTs and exploring the ordinals ecosystem.

ordinals_marketListings

Retrieves current marketplace listings for Bitcoin SV ordinals with flexible filtering. Supports multiple asset types (NFTs, BSV-20 tokens, BSV-21 tokens) through a unified interface. Results include listing prices, details about the assets, and seller information.

ordinals_marketSales

Retrieves recent sales data for BSV-20 and BSV-21 tokens on the ordinals marketplace. This tool provides insights into market activity, including sale prices, transaction details, and token information. Supports filtering by token ID, ticker symbol, or seller address to help analyze market trends and track specific token sales.

ordinals_getTokenByIdOrTicker

Retrieves detailed information about a specific BSV-20 token by its ID or ticker symbol. Returns complete token data including ticker symbol, supply information, decimals, and current status. This tool is useful for verifying token authenticity or checking supply metrics.

utils_convertData

Converts data between different encodings (utf8, hex, base64, binary). Useful for transforming data formats when working with blockchain data, encryption, or file processing.

Parameters:

  • data (required): The string to convert
  • from (required): Source encoding format (utf8, hex, base64, or binary)
  • to (required): Target encoding format (utf8, hex, base64, or binary)

Example usage:

  • UTF-8 to hex: {"data": "hello world", "from": "utf8", "to": "hex"} → 68656c6c6f20776f726c64
  • UTF-8 to base64: {"data": "Hello World", "from": "utf8", "to": "base64"} → SGVsbG8gV29ybGQ=
  • base64 to UTF-8: {"data": "SGVsbG8gV29ybGQ=", "from": "base64", "to": "utf8"} → Hello World
  • hex to base64: {"data": "68656c6c6f20776f726c64", "from": "hex", "to": "base64"} → aGVsbG8gd29ybGQ=

Notes:

  • All parameters are required
  • The tool returns the converted data as a string
  • For binary conversion, data is represented as an array of byte values
ID: 2tjvjasfmo