Bitcoin SV MCP Server

> ⚠️ NOTICE: Experimental Work in Progress
> This project is in an early experimental stage. Features may change, and the API is not yet stable.
> Contributions, feedback, and bug reports are welcome! Feel free to open issues or submit pull requests.

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.

Installation Options

Option 1: Claude Code Plugin (Simplest)

Install bsv-mcp as a Claude Code plugin — one command, no configuration required:

claude plugin install bsv-mcp@b-open-io

The plugin bundles the MCP server and registers it automatically. This works in both local Claude Code and Cowork environments. No environment variables or JSON config needed to get started.

Option 2: Hosted Version (FREE - No BSV Required!)

The easiest way to get started! Use our hosted version with OAuth 2.1 authentication:

1. Configure: Add the MCP server configuration to your IDE
2. Authenticate: Sign in with your Bitcoin wallet via sigma-auth
3. Use: Start using BSV features immediately - no BSV needed!

{
  "mcpServers": {
    "bsv-mcp-hosted": {
      "url": "https://bsv-mcp.rohenaz.workers.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
      }
    }
  }
}

To get your access token, authenticate at https://auth.sigmaidentity.com

Benefits:
- ✅ No Bitcoin required - we pay for everything
- ✅ Secure OAuth 2.1 authentication with Bitcoin signatures
- ✅ Instant setup - no installation needed
- ✅ Always up-to-date
- ✅ Global availability via Cloudflare

Option 3: Self-Hosted Installation

Prerequisites

Use Bun (Optional but recommended)

macOS (using Homebrew):

brew install oven-sh/bun/bun

macOS/Linux/WSL (using installer script):

curl -fsSL https://bun.sh/install | bash

Windows:
Windows users should use WSL (Windows Subsystem for Linux) or Docker to run Bun.

> Note:** The PRIVATE_KEY_WIF environment variable is now optional. Without it, the server runs in limited mode with educational resources and non-wallet tools available. Wallet and MNEE token operations require a valid private key. You can also set the IDENTITY_KEY_WIF environment variable to enable sigma-protocol signing of ordinals inscriptions for authentication, curation, and web-of-trust.

Claude Code

To use the BSV MCP server with Claude Code:

```bash