home / mcp / bitcoin sv mcp server

Bitcoin SV MCP Server

An MCP Server for Bitcoin SV

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "b-open-io-bsv-mcp": {
      "url": "https://bsv-mcp.rohenaz.workers.dev/mcp",
      "headers": {
        "TRANSPORT": "stdio",
        "DROPLET_API_URL": "https://your-droplet-service.com",
        "PRIVATE_KEY_WIF": "5HueCGU8...",
        "USE_DROPLET_API": "false",
        "IDENTITY_KEY_WIF": "Kx1234...",
        "BSV_MCP_PASSPHRASE": "my secure pass",
        "BSV_MCP_KEEP_LEGACY": "false",
        "DROPLET_FAUCET_NAME": "default_faucet",
        "BSV_MCP_AUTO_MIGRATE": "false"
      }
    }
  }
}

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.