Skip to main content
Glama

Bitcoin SV MCP Server

by b-open-io

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

No resources

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

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/b-open-io/bsv-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server