Bitcoin SV

You can run a Bitcoin SV MCP Server to access wallet, ordinals, and utility tools through natural language prompts in supported MCP clients. This server exposes a structured set of BSV capabilities that AI assistants can call to interact with the Bitcoin SV network safely, using configurable keys, signing, and optional remote or hosted access.

How to use

Connect to the MCP server from your MCP client or AI assistant. You can use a hosted version that requires no BSV and a self-hosted option if you prefer full control. When you issue requests through your assistant, you can perform wallet operations, interact with ordinals, explore the blockchain, and manage assets or tokens. If you enable identity or signing, ordinals inscriptions can be authenticated with a sigma-protocol identity key.

How to install

Prerequisites: you need a modern runtime for running the MCP server. Bun is recommended for best performance, but you can also run with Node.js and npm.

Option 1: Hosted version (no local install required) simply requires adding the MCP configuration to your client and authenticating with your wallet to start using BSV features.

Option 2: Self-hosted installation steps: install Bun or use Node.js, then run the server. The setup below assumes Bun for best performance, with an example provided for npm as an alternative.

# Bun is recommended
# macOS/Linux: install Bun
brew install oven-sh/bun/bun

# Or install via the installer script
curl -fsSL https://bun.sh/install | bash

# Start the MCP server (example)
bun run index.ts

"}]} ,{

## Configuration and security

Configuration supports hosted access and self-hosted options. If you use the hosted service, you’ll typically configure an MCP server entry with the remote URL and authorization token. For self-hosted use, you may run the local server with a private key for wallet-related operations. Encrypted key storage is available via a passphrase, and you may enable a sigma-key identity to sign ordinals inscriptions for authentication and web-of-trust features.

Important environment variables and security recommendations include enabling encrypted key storage, using strong passphrases, and backing up keys securely. You may opt into Droplet API mode to run without local private keys while still performing wallet operations through a remote faucet service.

## Troubleshooting

If you run into connection or startup issues, ensure Bun or Node.js is installed, verify keys if you use wallet tools, and check that your MCP client is configured to talk to the MCP server. Keep Bun up to date and monitor logs for clues about errors.

For debugging, review the MCP logs in your system’s log location or the client’s extension logs if you’re using a UI like Cursor or Claude integration.

## Notes and examples

The server exposes a broad set of tools organized into categories such as Wallet Tools, BSV Tools, Ordinals Tools, Utility Tools, MNEE Tools, and BAP Tools. You can use natural language prompts with your AI assistant to perform operations like querying addresses, signing messages, decoding transactions, exploring the blockchain, minting ordinals, and managing tokens.

## Available tools

### wallet\_getPublicKey

Retrieves a public key for a specified protocol and key ID.

### wallet\_createSignature

Creates a cryptographic signature for provided data.

### wallet\_verifySignature

Verifies a cryptographic signature against the provided data.

### wallet\_encryption

Encrypts or decrypts data using wallet keys.

### wallet\_getAddress

Returns a BSV address for the current wallet or a derived path.

### wallet\_sendToAddress

Sends BSV to a specified address.

### wallet\_purchaseListing

Purchases NFT or token listings from a marketplace.

### wallet\_createOrdinals

Creates and inscriptions ordinals on the BSV blockchain.

### bsv\_getPrice

Gets the current BSV price from an exchange API.

### bsv\_decodeTransaction

Decodes a BSV transaction and provides detailed info.

### bsv\_explore

Access blockchain data via WhatsOnChain endpoints.

### bsocial\_createPost

Creates a social post on the BSV blockchain.

### bsocial\_readPosts

Reads social posts from the BSV blockchain.

### ordinals\_getInscription

Retrieves details about a specific inscription.

### ordinals\_searchInscriptions

Searches for inscriptions by criteria.

### ordinals\_marketListings

Retrieves NFT/token market listings.

### ordinals\_marketSales

Gets information about token market sales.

### ordinals\_getTokenByIdOrTicker

Retrieves details about a BSV20 token by ID.

### utils\_convertData

Converts data across encodings.

### bap\_getId

Retrieves a BAP identity profile.

### bap\_getCurrentAddress

Retrieves the current BAP address.

### bap\_generate

Generates a new BAP HD master key.

### mnee\_getBalance

Retrieves the MNEE balance for the wallet.

### mnee\_sendMnee

Sends MNEE tokens to a specified address.

### mnee\_parseTx

Parses an MNEE transaction for details.