Bitcoin SV MCP Server
About
A collection of tools for interacting with the Bitcoin SV (BSV) blockchain, including wallet, ordinals, and utility functions.
Details
- License
- MIT
Explore
- Wallet tools for sending BSV, signing, and encryption
- Ordinals creation and inscription on BSV blockchain
- Marketplace listing purchase for NFTs and BSV-20/BSV-21 tokens
- Multiple installation options: plugin, hosted, or self-hosted
- Sigma-protocol signing for ordinals inscriptions (optional)
- Compatible with major MCP clients (Claude Code, Cursor, etc.)
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.
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.
Node.js and npm will also work but may not offer the same performance benefits.
The toolkit is organized into several categories:
> ⚠️ 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)
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.
Installing Bun
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.
Node.js and npm will also work but may not offer the same performance benefits.
Connecting to MCP Clients
This server implements the Model Context Protocol (MCP), allowing AI assistants to utilize Bitcoin SV functionalities. You can connect this server to various MCP-compatible clients.
> 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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
