← BSV MCPInstall

Tool reference

All tools

106 full-catalog tools, plus compact families. Find a tool by name or purpose, then open its inputs and wallet requirements.

This reference combines supported registration configurations. Your running server lists only the tools enabled for its wallet, roles and settings. A registered legacy tool can still require wallet setup before it can run.

Wallet configurations in this reference
Before wallet setup
Public tools and browser onboarding; no local keys loaded.
Legacy local wallet
Existing local Wallet adapter with account management and local identity support.
Legacy local identity
Legacy wallet with an established identity and HD BAP configuration.
Local Vault · broadcasting disabled
All wallet roles assigned, with guarded transaction submission disabled.
Local Vault · all roles
An unlocked embedded wallet with payment, identity and ordinals roles assigned.
Local Vault · payment role only
Identity, encryption and ordinals roles explicitly disabled.
Local Vault · no roles
Full catalog startup is rejected when no signing roles are assigned; compact public reads remain available.
Project · payments scope
A project context limited to its payment-safe wallet calls.
External BRC-100 wallet
A connected signer that owns its keys and permissions; no local account tools.
Local Vault + sponsor
An embedded wallet with a separately configured Droplit sponsor.
Droplit wallet
The integrated sponsored-wallet mode with faucet setup tools.

Wallet

  • app_sweep_complete

    App-only: verify browser signatures and submit the exact previously prepared sweep once.

  • 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

    App-only: scans a Bitcoin address for categorized UTXOs — funding, ordinals, and BSV-21 tokens.

  • app_wallet_data

    App-only: fetches wallet balance, UTXOs, and address.

  • wallet_abortAction

    Aborts a pending (nosend or unsigned) transaction, releasing consumed inputs back to spendable state.

  • wallet_acquireCertificate

    Acquires an identity certificate from a certifier.

  • wallet_cancelListing

    Cancel an ordinal marketplace listing

  • wallet_checkDroplitFaucetStatus

    Reads public faucet balance and payout settings. This is not proof of caller authorization; use droplit_getAccess for that.

  • wallet_createAction

    Creates a new Bitcoin transaction. Handles funding, signing, and broadcasting based on options.

  • 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

    Creates an HMAC using wallet keys.

  • 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

    Creates a digital signature using wallet keys. Supply exactly one of data or hashToDirectlySign.

  • wallet_decrypt

    Decrypts data using wallet keys.

  • wallet_discoverByAttributes

    Discovers certificates matching specific attributes.

  • wallet_discoverByIdentityKey

    Discovers certificates issued to a given identity key.

  • wallet_encrypt

    Encrypts data using wallet keys. protocolID is a JSON array like [2,"protocolName"].

  • 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

    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

    Retrieves the wallet's BRC-29 deposit address derived for MCP. This address can receive BSV, ordinals, or tokens via external payments.

  • wallet_getBalance

    Retrieves the current BSV balance for the wallet.

  • wallet_getBsv21Balances

    Get aggregated BSV21 token balances grouped by token ID

  • wallet_getHeaderForHeight

    Gets the 80-byte block header at a given height.

  • wallet_getHeight

    Gets the current blockchain height.

  • wallet_getLockData

    Get summary of time-locked BSV (total, unlockable, next unlock height)

  • wallet_getNetwork

    Gets the network the wallet is connected to (mainnet or testnet).

  • 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

    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

    Gets the wallet implementation version.

  • 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

    Internalizes an external transaction, adding its outputs to wallet baskets.

  • wallet_isAuthenticated

    Checks if the wallet user is authenticated.

  • wallet_list

    List named local accounts by public address. Does not unlock wallets, reveal keys or contact a service.

  • wallet_listActions

    Lists wallet transactions filtered by labels, with optional input/output details.

  • wallet_listCertificates

    Lists identity certificates filtered by certifiers and types.

  • wallet_listOrdinal

    List an ordinal for sale on the marketplace

  • wallet_listOutputs

    Lists spendable outputs in a basket, optionally filtered by tags.

  • wallet_listTokens

    List BSV21 token outputs in the wallet

  • wallet_lockBsv

    Lock BSV until a specific block height

  • 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

    Open the local wallet setup in the browser. Only available when wallet setup is needed. Complete wallet setup in the browser.

  • wallet_opnsDeregister

    Deregister an OpNS name

  • wallet_opnsRegister

    Register an OpNS name

  • wallet_paymentsCompact

    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

    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

    Proves select fields of a certificate to a verifier.

  • wallet_purchaseListing

    Purchases a listing from the Bitcoin SV ordinals marketplace. Supports both NFT purchases and BSV21 token purchases.

  • wallet_readCompact

    Read-only wallet operations. Select operation and pass that operation's arguments in args.

  • 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

    Registers public authentication material. Registration does not grant sponsor access; a sponsor owner must approve the wallet separately.

  • wallet_relinquishCertificate

    Removes a certificate from the wallet.

  • wallet_relinquishOutput

    Removes an output from a basket without spending it.

  • 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

    Reveals the linkage between the wallet identity and a counterparty to a verifier.

  • 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

    Reveals linkage for a specific protocol/key combination to a verifier.

  • wallet_sendAllBsv

    Send all BSV in the wallet to a single recipient

  • wallet_sendBsv

    Send BSV to one or more recipients by address or paymail. Supports BSV and USD amounts with automatic conversion.

  • wallet_setupCompact

    Wallet setup operation. Select operation and pass that operation's arguments in args.

  • wallet_signAction

    Signs a transaction previously created with createAction (when signAndProcess was false).

  • wallet_signBsm

    Sign a message using BSM (Bitcoin Signed Message) format

  • wallet_sweepBsv

    Sweep BSV from an external WIF private key into the wallet

  • wallet_sweepBsv21

    Sweep BSV21 tokens from an external WIF private key into the wallet

  • wallet_sweepOrdinals

    Sweep ordinals from an external WIF private key into the wallet

  • 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

    Unlock all matured time-locked BSV

  • 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

    Verifies an HMAC using wallet keys.

  • wallet_verifySignature

    Verifies a digital signature using wallet keys. Supply exactly one of data or hashToDirectlyVerify.

  • wallet_waitForAuthentication

    Blocks until the wallet user is authenticated.

Ordinals

  • app_ordinals_data

    App-only: fetches ordinals/NFT marketplace listings and search results.

  • ordinals_getInscription

    Retrieves metadata for an inscription by its outpoint. Returns content type, file info, origin, MAP data, and sequence info.

  • 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

    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

    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_readCompact

    Read-only Ordinals and marketplace operations. Select operation and pass that operation's arguments in args.

  • 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

    App-only: fetches BSV price, chain info, decodes transactions, and looks up addresses.

  • 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

    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 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

    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_readCompact

    Read-only BSV operations. Select operation and pass that operation's arguments in args.

  • 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

    Publish a BAP attestation signed by the selected identity wallet's current derived signing key.

  • bap_friend

    Initiates a friend request to another BAP ID by broadcasting an on-chain MAP transaction.

  • 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

    Retrieves the current BAP identity's Bitcoin SV address. This address is derived from the server's configured identity key.

  • 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

    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

    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

    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

    Rotate the selected identity wallet's BAP signing key, publish its signed successor record, and retire the preceding wallet record.

  • bap_updateProfile

    Publish a BAP profile using the selected identity wallet. Publishes its initial identity if needed. Profile data becomes public on chain.

Social

  • bmap_readFollows

    Read follow relationships from the BMAP API. Shows who a user is following or who follows them.

  • bmap_readLikes

    Read likes and reactions for a specific post from the BMAP API. Shows who liked the post and what emoji reactions were used.

  • bmap_readPosts

    Read social posts from the BMAP API (query layer). Can fetch posts by author (BAP ID), specific post by transaction ID, or recent posts from all users. Supports pagination and feed functionality.

  • bsocial_createPost

    Create a social post on the BSV blockchain using B:// and MAP protocols. Posts are stored permanently on-chain and can include plain text or markdown content.

  • bsocial_readPosts

    Read social posts from the BSV blockchain using BMAP API. Can fetch posts by author (BAP ID), specific post by transaction ID, or recent posts from all users. Supports pagination and feed functionality.

Tokens

  • mnee_getBalance

    Retrieves the current MNEE token balance for the wallet. Returns the balance in MNEE tokens.

  • 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

    Send MNEE tokens to a specified address

Paid services & sponsorship

  • 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

    Submit one raw transaction for sponsor funding and broadcast. Subject to sponsor approval and quotas. Unknown outcomes must be reconciled before retrying.

  • 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

    Submit one sponsored data transaction. Subject to sponsor approval and quotas. An unknown outcome requires checking transaction history before retrying.

  • 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

    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

  • utilityCompact

    Read-only data conversion and skill discovery operations. Select operation and pass that operation's arguments in args.

  • 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

    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

    Install the Agent Master CLI tool for managing MCP server configurations across multiple platforms (Claude, VS Code, Cursor, etc.)