# BSV MCP tool reference

This catalog combines supported wallet configurations. Your server lists only enabled tools.

## Wallet

- [app_sweep_complete](https://bsvmcp.com/docs/tools/app_sweep_complete): App-only: verify browser signatures and submit the exact previously prepared sweep once.
- [app_sweep_prepare](https://bsvmcp.com/docs/tools/app_sweep_prepare): App-only: verify source transactions and prepare a sweep that preserves ordinals and token amounts. Source private keys remain in the browser.
- [app_sweep_scan](https://bsvmcp.com/docs/tools/app_sweep_scan): App-only: scans a Bitcoin address for categorized UTXOs — funding, ordinals, and BSV-21 tokens.
- [app_wallet_data](https://bsvmcp.com/docs/tools/app_wallet_data): App-only: fetches wallet balance, UTXOs, and address.
- [wallet_abortAction](https://bsvmcp.com/docs/tools/wallet_abortAction): Aborts a pending (nosend or unsigned) transaction, releasing consumed inputs back to spendable state.
- [wallet_acquireCertificate](https://bsvmcp.com/docs/tools/wallet_acquireCertificate): Acquires an identity certificate from a certifier.
- [wallet_cancelListing](https://bsvmcp.com/docs/tools/wallet_cancelListing): Cancel an ordinal marketplace listing
- [wallet_checkDroplitFaucetStatus](https://bsvmcp.com/docs/tools/wallet_checkDroplitFaucetStatus): Reads public faucet balance and payout settings. This is not proof of caller authorization; use droplit_getAccess for that.
- [wallet_createAction](https://bsvmcp.com/docs/tools/wallet_createAction): Creates a new Bitcoin transaction. Handles funding, signing, and broadcasting based on options.
- [wallet_createDroplitFaucet](https://bsvmcp.com/docs/tools/wallet_createDroplitFaucet): Creates a faucet owned by this wallet which must be funded before use. This does not provide free credit or approval for another sponsor.
- [wallet_createHmac](https://bsvmcp.com/docs/tools/wallet_createHmac): Creates an HMAC using wallet keys.
- [wallet_createOrdinals](https://bsvmcp.com/docs/tools/wallet_createOrdinals): Creates and inscribes ordinals (NFTs) on the Bitcoin SV blockchain. This tool lets you mint new digital artifacts by encoding data directly into the blockchain. Supports various content types including images, text, JSON, and HTML. The tool handles transaction creation, fee calculation, and broadcasting.
- [wallet_createSignature](https://bsvmcp.com/docs/tools/wallet_createSignature): Creates a digital signature using wallet keys. Supply exactly one of data or hashToDirectlySign.
- [wallet_decrypt](https://bsvmcp.com/docs/tools/wallet_decrypt): Decrypts data using wallet keys.
- [wallet_discoverByAttributes](https://bsvmcp.com/docs/tools/wallet_discoverByAttributes): Discovers certificates matching specific attributes.
- [wallet_discoverByIdentityKey](https://bsvmcp.com/docs/tools/wallet_discoverByIdentityKey): Discovers certificates issued to a given identity key.
- [wallet_encrypt](https://bsvmcp.com/docs/tools/wallet_encrypt): Encrypts data using wallet keys. protocolID is a JSON array like [2,"protocolName"].
- [wallet_gatherCollectionInfo](https://bsvmcp.com/docs/tools/wallet_gatherCollectionInfo): Analyzes a folder of images and gathers all necessary information for minting an ordinals collection. This includes validating images, checking wallet balance, estimating costs, and suggesting metadata. Use this before minting to ensure everything is ready.
- [wallet_generate](https://bsvmcp.com/docs/tools/wallet_generate): Explicitly create a named encrypted account after human approval. Requires BSV_MCP_PASSWORD configured locally. Returns only its public address; back up keys.bep and config.json before funding.
- [wallet_getAddress](https://bsvmcp.com/docs/tools/wallet_getAddress): Retrieves the wallet's BRC-29 deposit address derived for MCP. This address can receive BSV, ordinals, or tokens via external payments.
- [wallet_getBalance](https://bsvmcp.com/docs/tools/wallet_getBalance): Retrieves the current BSV balance for the wallet.
- [wallet_getBsv21Balances](https://bsvmcp.com/docs/tools/wallet_getBsv21Balances): Get aggregated BSV21 token balances grouped by token ID
- [wallet_getHeaderForHeight](https://bsvmcp.com/docs/tools/wallet_getHeaderForHeight): Gets the 80-byte block header at a given height.
- [wallet_getHeight](https://bsvmcp.com/docs/tools/wallet_getHeight): Gets the current blockchain height.
- [wallet_getLockData](https://bsvmcp.com/docs/tools/wallet_getLockData): Get summary of time-locked BSV (total, unlockable, next unlock height)
- [wallet_getNetwork](https://bsvmcp.com/docs/tools/wallet_getNetwork): Gets the network the wallet is connected to (mainnet or testnet).
- [wallet_getOrdinals](https://bsvmcp.com/docs/tools/wallet_getOrdinals): List ordinals/inscriptions in the wallet with metadata. Each result carries an 'id:' tag; that tracking id is the handle the transfer, listing and cancel tools take.
- [wallet_getPublicKey](https://bsvmcp.com/docs/tools/wallet_getPublicKey): Retrieves a public key by protocol/key derivation. Use identityKey:true for the root identity key. protocolID is a JSON array like [2,"1sat"].
- [wallet_getVersion](https://bsvmcp.com/docs/tools/wallet_getVersion): Gets the wallet implementation version.
- [wallet_import](https://bsvmcp.com/docs/tools/wallet_import): Import an encrypted bitcoin-backup WIF account after human approval. Never provide a plaintext key or password. BSV_MCP_PASSWORD must already be configured locally; use the terminal wallet_import command for a WIF.
- [wallet_internalizeAction](https://bsvmcp.com/docs/tools/wallet_internalizeAction): Internalizes an external transaction, adding its outputs to wallet baskets.
- [wallet_isAuthenticated](https://bsvmcp.com/docs/tools/wallet_isAuthenticated): Checks if the wallet user is authenticated.
- [wallet_list](https://bsvmcp.com/docs/tools/wallet_list): List named local accounts by public address. Does not unlock wallets, reveal keys or contact a service.
- [wallet_listActions](https://bsvmcp.com/docs/tools/wallet_listActions): Lists wallet transactions filtered by labels, with optional input/output details.
- [wallet_listCertificates](https://bsvmcp.com/docs/tools/wallet_listCertificates): Lists identity certificates filtered by certifiers and types.
- [wallet_listOrdinal](https://bsvmcp.com/docs/tools/wallet_listOrdinal): List an ordinal for sale on the marketplace
- [wallet_listOutputs](https://bsvmcp.com/docs/tools/wallet_listOutputs): Lists spendable outputs in a basket, optionally filtered by tags.
- [wallet_listTokens](https://bsvmcp.com/docs/tools/wallet_listTokens): List BSV21 token outputs in the wallet
- [wallet_lockBsv](https://bsvmcp.com/docs/tools/wallet_lockBsv): Lock BSV until a specific block height
- [wallet_mintCollection](https://bsvmcp.com/docs/tools/wallet_mintCollection): Mint a collection of ordinals from a folder of images with proper metadata. This tool creates a collection inscription first, then mints each image as a collection item with the appropriate metadata linking it to the collection.
- [wallet_onboarding](https://bsvmcp.com/docs/tools/wallet_onboarding): Open the local wallet setup in the browser. Only available when wallet setup is needed. Complete wallet setup in the browser.
- [wallet_opnsDeregister](https://bsvmcp.com/docs/tools/wallet_opnsDeregister): Deregister an OpNS name
- [wallet_opnsRegister](https://bsvmcp.com/docs/tools/wallet_opnsRegister): Register an OpNS name
- [wallet_payments](https://bsvmcp.com/docs/tools/wallet_payments): PeerPay payment operations. Select operation and pass that operation's arguments in args. Receiving internalizes funds into the embedded wallet and acknowledges the MessageBox item.
- [wallet_peerPayments](https://bsvmcp.com/docs/tools/wallet_peerPayments): Lists pending PeerPay payments or receives one selected payment into the embedded BRC-100 wallet. Receiving requires an explicit messageId and internalizes funds before acknowledging the MessageBox item.
- [wallet_proveCertificate](https://bsvmcp.com/docs/tools/wallet_proveCertificate): Proves select fields of a certificate to a verifier.
- [wallet_purchaseListing](https://bsvmcp.com/docs/tools/wallet_purchaseListing): Purchases a listing from the Bitcoin SV ordinals marketplace. Supports both NFT purchases and BSV21 token purchases.
- [wallet_read](https://bsvmcp.com/docs/tools/wallet_read): Read-only wallet operations. Select operation and pass that operation's arguments in args.
- [wallet_refreshUtxos](https://bsvmcp.com/docs/tools/wallet_refreshUtxos): Syncs external payments sent to BRC-29 deposit addresses into the wallet. Triggers lazy indexing on the server, classifies outputs (funding, ordinals, tokens), and internalizes them.
- [wallet_registerDroplitKey](https://bsvmcp.com/docs/tools/wallet_registerDroplitKey): Registers public authentication material. Registration does not grant sponsor access; a sponsor owner must approve the wallet separately.
- [wallet_relinquishCertificate](https://bsvmcp.com/docs/tools/wallet_relinquishCertificate): Removes a certificate from the wallet.
- [wallet_relinquishOutput](https://bsvmcp.com/docs/tools/wallet_relinquishOutput): Removes an output from a basket without spending it.
- [wallet_remove](https://bsvmcp.com/docs/tools/wallet_remove): Remove a local account only with force, backup confirmation and human approval. Fund absence cannot be proven across all derived addresses. Cannot remove the active account; never sweeps funds.
- [wallet_revealCounterpartyKeyLinkage](https://bsvmcp.com/docs/tools/wallet_revealCounterpartyKeyLinkage): Reveals the linkage between the wallet identity and a counterparty to a verifier.
- [wallet_revealDelegation](https://bsvmcp.com/docs/tools/wallet_revealDelegation): Receive the human owner's BRC-169 certificate handoff, acquire and prove it with this connected agent wallet, and reveal its restrictions to the specified Sigma verifier. Imports a certificate and activates its existing delegation. Never pays, broadcasts, follows redirects, or retries an ambiguous POST. The subject keyring stays with the wallet.
- [wallet_revealSpecificKeyLinkage](https://bsvmcp.com/docs/tools/wallet_revealSpecificKeyLinkage): Reveals linkage for a specific protocol/key combination to a verifier.
- [wallet_sendAllBsv](https://bsvmcp.com/docs/tools/wallet_sendAllBsv): Send all BSV in the wallet to a single recipient
- [wallet_sendBsv](https://bsvmcp.com/docs/tools/wallet_sendBsv): Send BSV to one or more recipients by address or paymail. Supports BSV and USD amounts with automatic conversion.
- [wallet_setup](https://bsvmcp.com/docs/tools/wallet_setup): Wallet setup operation. Select operation and pass that operation's arguments in args.
- [wallet_signAction](https://bsvmcp.com/docs/tools/wallet_signAction): Signs a transaction previously created with createAction (when signAndProcess was false).
- [wallet_signBsm](https://bsvmcp.com/docs/tools/wallet_signBsm): Sign a message using BSM (Bitcoin Signed Message) format
- [wallet_sweepBsv](https://bsvmcp.com/docs/tools/wallet_sweepBsv): Sweep BSV from an external WIF private key into the wallet
- [wallet_sweepBsv21](https://bsvmcp.com/docs/tools/wallet_sweepBsv21): Sweep BSV21 tokens from an external WIF private key into the wallet
- [wallet_sweepOrdinals](https://bsvmcp.com/docs/tools/wallet_sweepOrdinals): Sweep ordinals from an external WIF private key into the wallet
- [wallet_transferOrdToken](https://bsvmcp.com/docs/tools/wallet_transferOrdToken): Transfer an ordinal inscription or send BSV21 fungible tokens. Use type='ordinal' to transfer an NFT/inscription by its ordinals-basket tracking id (from wallet_getOrdinals). Use type='bsv21' to send fungible tokens by token ID and amount.
- [wallet_unlockBsv](https://bsvmcp.com/docs/tools/wallet_unlockBsv): Unlock all matured time-locked BSV
- [wallet_use](https://bsvmcp.com/docs/tools/wallet_use): Validate an account and give its restart configuration. Does not replace the wallet of a running session or modify client settings.
- [wallet_verifyHmac](https://bsvmcp.com/docs/tools/wallet_verifyHmac): Verifies an HMAC using wallet keys.
- [wallet_verifySignature](https://bsvmcp.com/docs/tools/wallet_verifySignature): Verifies a digital signature using wallet keys. Supply exactly one of data or hashToDirectlyVerify.
- [wallet_waitForAuthentication](https://bsvmcp.com/docs/tools/wallet_waitForAuthentication): Blocks until the wallet user is authenticated.

## Ordinals

- [app_ordinals_data](https://bsvmcp.com/docs/tools/app_ordinals_data): App-only: fetches ordinals/NFT marketplace listings and search results.
- [ordinals_getInscription](https://bsvmcp.com/docs/tools/ordinals_getInscription): Retrieves metadata for an inscription by its outpoint. Returns content type, file info, origin, MAP data, and sequence info.
- [ordinals_getTokenByIdOrTicker](https://bsvmcp.com/docs/tools/ordinals_getTokenByIdOrTicker): Retrieves detailed information about a BSV21 token by its ID (txid_vout format). Returns token data including symbol, supply, decimals, funding status, and current state.
- [ordinals_marketListings](https://bsvmcp.com/docs/tools/ordinals_marketListings): Search active 1Sat marketplace listings by name prefix or content type. Prices are satoshis. Pass the last score as from for the next page. Availability is checked again when purchasing.
- [ordinals_marketSales](https://bsvmcp.com/docs/tools/ordinals_marketSales): Query completed 1Sat marketplace sales by name prefix or content type. Prices are satoshis. Pass the last score as from for the next page.
- [ordinals_read](https://bsvmcp.com/docs/tools/ordinals_read): Read-only Ordinals and marketplace operations. Select operation and pass that operation's arguments in args.
- [ordinals_searchInscriptions](https://bsvmcp.com/docs/tools/ordinals_searchInscriptions): Search indexed outputs by 1Sat event/topic/owner key (e.g. own:ADDRESS). Returns inscription and MAP metadata when indexed. This is an index-key search, not free-text search; use marketListings.q for listing names.

## Explorer

- [app_explorer_data](https://bsvmcp.com/docs/tools/app_explorer_data): App-only: fetches BSV price, chain info, decodes transactions, and looks up addresses.
- [bsv_dashboard](https://bsvmcp.com/docs/tools/bsv_dashboard): Interactive BSV dashboard with Explorer, Wallet, and Ordinals tabs. Use this for any BSV-related query that benefits from visual display.
- [bsv_decodeTransaction](https://bsvmcp.com/docs/tools/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](https://bsvmcp.com/docs/tools/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.
- [bsv_getPrice](https://bsvmcp.com/docs/tools/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_read](https://bsvmcp.com/docs/tools/bsv_read): Read-only BSV operations. Select operation and pass that operation's arguments in args.
- [bsv_status](https://bsvmcp.com/docs/tools/bsv_status): Show server version, configured network, wallet availability, backend URLs, live 1Sat modules and any persistent Vault migration warning. Does not request keys, sign, sync or spend. Backend modules do not imply MCP tools or sponsor approval.

## Identity

- [bap_attest](https://bsvmcp.com/docs/tools/bap_attest): Publish a BAP attestation signed by the selected identity wallet's current derived signing key.
- [bap_generate](https://bsvmcp.com/docs/tools/bap_generate): Generates a BAP HD master key AND derives the first identity key if no BAP keys (xprv or identityPk) exist. Saves keys to secure storage. Attempts on-chain registration using payPk (honors DISABLE_BROADCASTING). Optionally takes alternateName and description for the profile.
- [bap_getCurrentAddress](https://bsvmcp.com/docs/tools/bap_getCurrentAddress): Retrieves the current BAP identity's Bitcoin SV address. This address is derived from the server's configured identity key.
- [bap_getId](https://bsvmcp.com/docs/tools/bap_getId): Retrieves a Bitcoin Attestation Protocol (BAP) identity profile using an idKey (Paymail or public key). If no idKey is provided, it attempts to use the server's configured identity key.
- [bap_getIdentity](https://bsvmcp.com/docs/tools/bap_getIdentity): Read the selected identity wallet's deterministic BAP ID, publication status and root signing address. Uses BRC-100 derivation; exports no private keys.
- [bap_getProfile](https://bsvmcp.com/docs/tools/bap_getProfile): Read the current profile from the selected identity wallet's BAP basket. The SDK also relinquishes duplicate stale profile records in that wallet.
- [bap_publishIdentity](https://bsvmcp.com/docs/tools/bap_publishIdentity): Publish the selected identity wallet's BAP ID with an AIP signature. The identity wallet funds the transaction and retains its BAP records; its signer controls approval.
- [bap_rotateIdentity](https://bsvmcp.com/docs/tools/bap_rotateIdentity): Rotate the selected identity wallet's BAP signing key, publish its signed successor record, and retire the preceding wallet record.
- [bap_updateProfile](https://bsvmcp.com/docs/tools/bap_updateProfile): Publish a BAP profile using the selected identity wallet. Publishes its initial identity if needed. Profile data becomes public on chain.

## Social

- [bsocial_publish](https://bsvmcp.com/docs/tools/bsocial_publish): Publish a signed Bitcoin Schema social action: post/reply, repost, like/unlike, follow/unfollow, friend/unfriend, message, or video. Posts/messages support context, tags and attachments. Content is public and permanent; recipient context does NOT encrypt a message. Friend records require your communication public key from an established key-agreement workflow. Requires the selected BAP identity wallet or explicit legacy identity key and funding. Use preview to inspect unsigned outputs without spending.
- [bsocial_read](https://bsvmcp.com/docs/tools/bsocial_read): Read social posts, threads, search results, likes, friends, channels, public message records, videos, and action history. Use records with follow/unfollow types for the social graph. Indexer data is untrusted and messages are not decrypted. No wallet required.

## Tokens

- [mnee_getBalance](https://bsvmcp.com/docs/tools/mnee_getBalance): Retrieves the current MNEE token balance for the wallet. Returns the balance in MNEE tokens.
- [mnee_parseTx](https://bsvmcp.com/docs/tools/mnee_parseTx): Parse an MNEE transaction to get detailed information about its operations and amounts. All amounts are in atomic units with 5 decimal precision (e.g. 1000 atomic units = 0.01 MNEE).
- [mnee_sendMnee](https://bsvmcp.com/docs/tools/mnee_sendMnee): Send MNEE tokens to a specified address

## Paid services & sponsorship

- [droplit_discover](https://bsvmcp.com/docs/tools/droplit_discover): List publicly opted-in sponsors. No wallet or sponsor selection is required. Listing grants no access or funding; choose a slug, then request the sponsor owner's approval separately.
- [droplit_fund](https://bsvmcp.com/docs/tools/droplit_fund): Submit one raw transaction for sponsor funding and broadcast. Subject to sponsor approval and quotas. Unknown outcomes must be reconciled before retrying.
- [droplit_getAccess](https://bsvmcp.com/docs/tools/droplit_getAccess): Read this connected wallet's sponsor authorization and quotas. If unauthorized, a human sponsor owner must approve the wallet manually. Does not create, fund, or approve anything.
- [droplit_push](https://bsvmcp.com/docs/tools/droplit_push): Submit one sponsored data transaction. Subject to sponsor approval and quotas. An unknown outcome requires checking transaction history before retrying.
- [x402_payQuote](https://bsvmcp.com/docs/tools/x402_payQuote): Pay a previously quoted BSV service request from the connected wallet, then return its response. Only call after authorization for the service, amount, and total limit including mining fees. Reuses the stored URL, method, body and credentials. Wallet permission checks apply. Does not automatically pay changed terms or retry a failed payment.
- [x402_request](https://bsvmcp.com/docs/tools/x402_request): Request any HTTPS service without automatically paying. Returns the response if free, or a BSV payment quote for approval. POST/PUT/PATCH/DELETE may execute if the service does not require payment. Use auth=brc31 for BSV-authenticated/BRC-105 services. No API key required by the client; optional service credentials are scoped by X402_SERVICE_HEADERS. Supports BRC-105, bound BRC-120 with OP_TRUE nonces, and compact bsv-tx-v1 challenges.

## Utilities

- [utility](https://bsvmcp.com/docs/tools/utility): Read-only data conversion and skill discovery operations. Select operation and pass that operation's arguments in args.
- [utils_convertData](https://bsvmcp.com/docs/tools/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
- [utils_find_skills](https://bsvmcp.com/docs/tools/utils_find_skills): Search the agent-skills index for skill metadata by keyword. Returns only small on-demand SKILL.md links (id, name, description, plugin, version, url) without fetching skill content.
- [utils_installAgentMaster](https://bsvmcp.com/docs/tools/utils_installAgentMaster): Install the Agent Master CLI tool for managing MCP server configurations across multiple platforms (Claude, VS Code, Cursor, etc.)