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.
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.)
Social
Read follow relationships from the BMAP API. Shows who a user is following or who follows them.
Read likes and reactions for a specific post from the BMAP API. Shows who liked the post and what emoji reactions were used.
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.
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.
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.