wallet_getPublicKeyLABSCO SUMMARY
An agent can hold a BSV wallet, read the chain, and trade ordinals.
The spread is what makes it usable in one conversation: look up a price, decode a transaction, check a token's market, and then actually send, buy or inscribe — with the key handling kept behind a passphrase rather than pasted into a config.
What it is
A toolkit for Bitcoin SV work from an AI client, grouped by what you are doing: wallet operations, chain lookups, ordinals and token markets, on-chain social posts, BAP identities and MNEE tokens. It also carries educational prompts about the BSV SDK, so the model can look up how the protocol works before it acts.
What you get
- Wallet —
wallet_getAddress,wallet_getPublicKey,wallet_createSignature,wallet_verifySignature,wallet_encryptionfor encrypt and decrypt,wallet_sendToAddressin BSV or USD amounts,wallet_purchaseListing,wallet_createOrdinals - Chain —
bsv_getPrice,bsv_decodeTransactionfor a full input and output breakdown,bsv_exploreacross the WhatsOnChain endpoints - Ordinals —
ordinals_getInscription,ordinals_searchInscriptions,ordinals_marketListings,ordinals_marketSales,ordinals_getTokenByIdOrTicker - Social —
bsocial_createPostwrites a post using the B:// and MAP protocols,bsocial_readPostsreads them back with filters - Identity —
bap_getId,bap_getCurrentAddress,bap_generate - MNEE tokens —
mnee_getBalance,mnee_sendMnee,mnee_parseTx - Utilities —
utils_convertDatabetween utf8, hex, base64 and binary - Prompts the model can pull in:
bitcoin_sv_ordinals,bitcoin_sv_sdk_overview,bitcoin_sv_sdk_wallet,bitcoin_sv_sdk_transaction,bitcoin_sv_sdk_auth,bitcoin_sv_sdk_cryptography
Requirements
PRIVATE_KEY_WIF is optional — without it the server runs in a limited mode with the educational resources and the non-wallet tools, and wallet plus MNEE operations need a key. IDENTITY_KEY_WIF turns on sigma-protocol signing of ordinals inscriptions; BSV_MCP_PASSPHRASE enables encrypted key storage, which the README recommends over passing a raw key. Run it with bunx bsv-mcp@latest (Bun is the project's runtime, npx works too), or install the Claude Code plugin with claude plugin install bsv-mcp@b-open-io. There is also a hosted endpoint at https://bsv-mcp.rohenaz.workers.dev/mcp with OAuth sign-in through auth.sigmaidentity.com, where you hold no coins of your own. The project describes itself as early and experimental, with an unstable API.
Setup effort
One command — claude plugin install bsv-mcp@b-open-io
USE CASES
Trying it without owning any BSV
Point the client at the hosted endpoint and sign in with a Bitcoin wallet over OAuth — the tools work without you funding a key first.
Making sense of a transaction someone sent you
Decode it into inputs, outputs, size and locktime, then explore the addresses involved against the chain.
Buying an ordinal or a token listing
Search the inscriptions or pull the current market listings, then purchase the one you picked in the same pass.
Paying someone in dollars, not satoshis
Send to an address in USD terms and let the wallet do the conversion, instead of working out the amount yourself.
Posting to the chain and reading it back
Write a markdown post through the B:// and MAP protocols, then read the recent feed or the replies to a given transaction.
Working with MNEE balances
Check the balance, send an amount in MNEE or USD, and parse the resulting transaction into its per-address inputs and outputs.
25 tools
Listed in project docs. Your client may show a different list.
wallet_createSignaturewallet_verifySignaturewallet_encryptionwallet_getAddresswallet_sendToAddresswallet_purchaseListingwallet_createOrdinalsbsv_getPricebsv_decodeTransactionbsv_explorebsocial_createPostbsocial_readPostsordinals_getInscriptionordinals_searchInscriptionsordinals_marketListingsordinals_marketSalesordinals_getTokenByIdOrTickerutils_convertDatabap_getIdbap_getCurrentAddressbap_generatemnee_getBalancemnee_sendMneemnee_parseTxBEFORE YOU INSTALL
What to know first
Tools you get
25 tools named in the project's documentation.
INSTALLATION
Connect your client
Server setup
The command line the project publishes
claude plugin install bsv-mcp@b-open-ioHosted endpoint
https://bsv-mcp.rohenaz.workers.dev/mcpAdd this hosted endpoint to your MCP client.
MCP Clients
Claude Code
claude mcp add bsv-mcp "bunx bsv-mcp@latest"Cursor
{
"mcpServers": {
"Bitcoin SV": {
"command": "bunx",
"args": [
"bsv-mcp@latest"
],
"env": {
"PRIVATE_KEY_WIF": "<YOUR_PRIVATE_KEY_WIF>",
"IDENTITY_KEY_WIF": "<YOUR_IDENTITY_KEY_WIF>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"Bitcoin SV": {
"command": "bun",
"args": [
"run",
"bsv-mcp@latest"
],
"env": {
"PRIVATE_KEY_WIF": "<YOUR_PRIVATE_KEY_WIF>",
"IDENTITY_KEY_WIF": "<YOUR_IDENTITY_KEY_WIF>"
}
}
}
}VS Code
code --add-mcp '{"name":"Bitcoin SV","command":"bunx","args":["bsv-mcp@latest"],"env":{"PRIVATE_KEY_WIF":"<YOUR_PRIVATE_KEY_WIF>","IDENTITY_KEY_WIF":"<YOUR_IDENTITY_KEY_WIF>"}}'Any MCP client — hosted
{
"mcpServers": {
"bsv-mcp-hosted": {
"url": "https://bsv-mcp.rohenaz.workers.dev/mcp",
"headers": {
"Authorization": "Bearer <YOUR_ACCESS_TOKEN>"
}
}
}
}