Bsv MCP Server

A collection of Bitcoin SV (BSV) tools for the Model Context Protocol (MCP) framework

Remote serverstreamable-httpGo

What is the Bsv MCP MCP server?

Bsv MCP MCP server exists for a simple reason — assistants are far more useful when they can act on Bsv MCP directly instead of describing what you should do. A collection of Bitcoin SV (BSV) tools for the Model Context Protocol (MCP) framework.

What you get

A collection of Bitcoin SV (BSV) tools for the Model Context Protocol (MCP) framework. This library provides wallet, ordinals, and utility functions for BSV blockchain interaction.

What the assistant can call

Once Bsv MCP is connected, these are the calls the assistant has available:

  • Args — - data (string, required): The data string to be converted
  • Returns — The converted data as a string
  • wallet_getPublicKey — Retrieves a public key for a specified protocol and key ID
  • wallet_createSignature — Creates a cryptographic signature for the provided data
  • wallet_verifySignature — Verifies a cryptographic signature against the provided data
  • wallet_encryption — Combined tool for encrypting and decrypting data using the wallet's cryptographic keys. Examples: 1. Encrypt text: "Encrypt this message: Hello
  • wallet_getAddress — Returns a BSV address for the current wallet or a derived path
  • wallet_sendToAddress — Sends BSV to a specified address (supports BSV or USD amounts)
  • wallet_purchaseListing — Purchases NFTs or BSV-20/BSV-21 tokens from marketplace listings
  • wallet_createOrdinals — Creates and inscribes ordinals on the BSV blockchain
  • bsv_getPrice — Gets the current BSV price from an exchange API
  • bsv_decodeTransaction — Decodes a BSV transaction and returns detailed information

Configuration and credentials

You will need 3 environment variables: PRIVATE_KEY_WIF, IDENTITY_KEY_WIF, YOUR_ACCESS_TOKEN. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

**Use Bun (Optional but recommended) This project is built using Bun, a fast JavaScript runtime and package manager. While Bun is recommended for best performance, the server can also run with Node.js and npm as Bun is designed to be backward compatible with node.

Setting it up

Being a remote server, there is no local install. You register the endpoint with your client, authorise it once, and the tools appear.

Choosing this one

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Bsv MCP's toolset — Args, Returns, wallet_getPublicKey and 11 more — is a fair guide to whether it matches your workflow. It is maintained by b-open-io; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Before you rely on it

  • Your data travels to the provider's service, so the usual questions apply about what you send and what they retain.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Bsv MCP.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the bsv mcp mcp server does with a few real requests.

Available tools

ToolWhat it does
Args- data (string, required): The data string to be converted.
ReturnsThe converted data as a string.
wallet_getPublicKeyRetrieves a public key for a specified protocol and key ID
wallet_createSignatureCreates a cryptographic signature for the provided data
wallet_verifySignatureVerifies a cryptographic signature against the provided data
wallet_encryptionCombined tool for encrypting and decrypting data using the wallet's cryptographic keys. **Examples:** 1. Encrypt text: "Encrypt this message: Hello World" 2. Decrypt data: "Decrypt this data that was previously encrypted
wallet_getAddressReturns a BSV address for the current wallet or a derived path
wallet_sendToAddressSends BSV to a specified address (supports BSV or USD amounts)
wallet_purchaseListingPurchases NFTs or BSV-20/BSV-21 tokens from marketplace listings
wallet_createOrdinalsCreates and inscribes ordinals on the BSV blockchain
bsv_getPriceGets the current BSV price from an exchange API
bsv_decodeTransactionDecodes a BSV transaction and returns detailed information
bsv_exploreComprehensive blockchain explorer tool accessing WhatsOnChain API endpoints
bsocial_createPostCreates a social post on the BSV blockchain using B:// and MAP protocols

How to install the Bsv MCP MCP server

{
  "mcpServers": {
    "bsv": {
      "command": "npx",
      "args": ["-y", "claude"],
      "env": {
        "PRIVATE_KEY_WIF": "your-value",
        "IDENTITY_KEY_WIF": "your-value",
        "YOUR_ACCESS_TOKEN": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

**Use Bun (Optional but recommended) This project is built using Bun, a fast JavaScript runtime and package manager. While Bun is recommended for best performance, the server can also run with Node.js and npm as Bun is designed to be backward compatible with node.

VariableDescriptionRequired
PRIVATE_KEY_WIFCredential the server authenticates with.Yes
IDENTITY_KEY_WIFCredential the server authenticates with.Yes
YOUR_ACCESS_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • Use Bsv MCP to Args.
  • Use Bsv MCP to Returns.
  • Use Bsv MCP to wallet getPublicKey.

Frequently asked questions

It connects Bsv MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (Args, Returns, wallet_getPublicKey, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Bsv MCP directly.