MCP server
by b-open-io
Securely manage your Bitcoin SV Wallet, handle transactions, and interact with NFTs, all with local private key security
Enables Bitcoin SV blockchain operations including wallet management, transactions, and NFT interactions through MCP. Offers both hosted and self-hosted options with local private key security.
Bitcoin SV Wallet is a community-built MCP server published by b-open-io that provides AI assistants with tools and capabilities via the Model Context Protocol. Securely manage your Bitcoin SV Wallet, handle transactions, and interact with NFTs, all with local private key security It is categorized under finance, developer tools.
You can install Bitcoin SV Wallet in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.
MIT
Bitcoin SV Wallet is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.
Add new capabilities to Claude beyond text generation
Example
Access external data sources, execute code, interact with tools and services
Transform Claude from chatbot to action-taking agent
Provide Claude with access to relevant context and data
Example
Load project documentation, access knowledge bases, query databases
Get more accurate, context-aware responses
Automate multi-step workflows combining AI and external tools
Example
Research → Summarize → Create document → Send notification
Complete complex tasks end-to-end without manual steps
Share your MCP server with the developer community
Bitcoin SV Wallet reduced integration guesswork — categories and install configs on the listing matched the upstream repo.
We evaluated Bitcoin SV Wallet against two servers with overlapping tools; this profile had the clearer scope statement.
I recommend Bitcoin SV Wallet for teams standardizing on MCP; the explainx.ai page compares cleanly with sibling servers.
Bitcoin SV Wallet has been reliable for tool-calling workflows; the MCP profile page is a good permalink for internal docs.
Strong directory entry: Bitcoin SV Wallet surfaces stars and publisher context so we could sanity-check maintenance before adopting.
According to our notes, Bitcoin SV Wallet benefits from clear Model Context Protocol framing — fewer ambiguous “AI plugin” claims.
We evaluated Bitcoin SV Wallet against two servers with overlapping tools; this profile had the clearer scope statement.
Useful MCP listing: Bitcoin SV Wallet is the kind of server we cite when onboarding engineers to host + tool permissions.
We wired Bitcoin SV Wallet into a staging workspace; the listing’s GitHub and npm pointers saved time versus hunting across READMEs.
Bitcoin SV Wallet is a well-scoped MCP server in the explainx.ai directory — install snippets and categories matched our Claude Code setup.
showing 1-10 of 44
⚠️ 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.
The easiest way to get started! Use our hosted version with OAuth 2.1 authentication:
{
"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:
**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.
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_WIFenvironment 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 theIDENTITY_KEY_WIFenvironment variable to enable sigma-protocol signing of ordinals inscriptions for authentication, curation, and web-of-trust.
To use the BSV MCP server with Claude Code:
# Using bunx (recommended)
claude mcp add bsv-mcp "bunx bsv-mcp@latest"
# Or using npx
claude mcp add bsv-mcp "npx bsv-mcp@latest"
To add with environment variables:
claude mcp add bsv-mcp "bunx bsv-mcp@latest" -e PRIVATE_KEY_WIF=your_key -e IDENTITY_KEY_WIF=your_identity_key
For encrypted key storage (recommended):
claude mcp add bsv-mcp "bunx bsv-mcp@latest" -e BSV_MCP_PASSPHRASE="your-secure-passphrase"
Note: The server automatically runs in stdio mode when used with Claude Code CLI.
Quick Install: Click the button above to automatically add the BSV MCP server to Cursor! This will install the server with the basic configuration using bunx bsv-mcp@latest.
Manual Setup: To manually configure the BSV MCP server with Cursor:
{
"mcpServers": {
"Bitcoin SV": {
"command": "bunx",
"args": [
"bsv-mcp@latest"
],
"env": {
"PRIVATE_KEY_WIF": "<your_private_key_wif>",
"IDENTITY_KEY_WIF": "<your_identity_key_wif>"
}
}
}
}
Replace <your_private_key_wif> with your actual private key WIF (keep this secure!) If you dont have one you can leave this off for now but you wont be able to use tools that require a wallet. <your_identity_key_wif> is also optional. It will sign 1Sat Ordinals with Sigma protocol using the provided identity key.
Click "Save"
The BSV tools will now be available to Cursor's AI assistant under the "Bitcoin SV" namespace.
If you prefer to use npm instead of Bun:
{
"mcpServers": {
"Bitcoin SV": {
"command": "npx",
"args": [
"bsv-mcp@latest"
],
"env": {
"PRIVATE_KEY_WIF": "<your_private_key_wif>",
"IDENTITY_KEY_WIF": "<your_identity_key_wif>"
}
}
}
}
To connect this server to Claude for Desktop:
Open the Claude configuration json file in your favorite text editor. If you prefer to do it from the cli:
# macOS/Linux
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
# Windows
code %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"Bitcoin SV": {
"command": "bun",
"args": [
"run", "bsv-mcp@latest"
],
"env": {
"PRIVATE_KEY_WIF": "<your_private_key_wif>",
"IDENTITY_KEY_WIF": "<your_identity_key_wif>"
}
}
}
}
<your_private_key_wif> with your actual private key WIFIf you prefer to use npm instead of Bun, replace the "command" field with "npx".
If you prefer using the command line, you can add the BSV MCP server to VS Code (which uses the same underlying settings as Cursor) directly:
Using Bun (Recommended):
code --add-mcp '{"name":"Bitcoin SV","command":"bunx","args":["bsv-mcp@latest"],"env":{"PRIVATE_KEY_WIF":"<your_private_key_wif>","IDENTITY_KEY_WIF":"<your_identity_key_wif>"}}'
Using Node.js/npm:
code --add-mcp '{"name":"Bitcoin SV","command":"npx","args":["bsv-mcp@latest"],"env":{"PRIVATE_KEY_WIF":"<your_private_key_wif>","IDENTITY_KEY_WIF":"<your_identity_key_wif>"}}'
<your_private_key_wif> with your actual private key WIF (optional, required for wallet tools).<your_identity_key_wif> with your identity key WIF (optional, enables Sigma protocol signing).code command is in your system's PATH (it usually is if VS Code was installed normally).This command adds the server configuration to your VS Code settings.json file under the mcp.servers key.
The toolkit is organized into several categories:
Wallet tools provide core BSV wallet functionality:
| Tool Name | Description | Example Output |
|---|---|---|
wallet_getPublicKey | Retrieves a public key for a specified protocol and key ID | {"publicKey":"032d0c73eb9270e9e009fd1f9dd77e19cf764fbad5f799560c4e8fd414e40d6fc2"} |
wallet_createSignature | Creates a cryptographic signature for the provided data | {"signature":[144,124,85,193,226,45,140,249,9,177,11,167,33,215,209,38,...]} |
wallet_verifySignature | Verifies a cryptographic signature against the provided data | {"isValid":true} |
wallet_encryption | Combined tool for encrypting and decrypting data using the wallet's cryptographic keys.<br><br>Examples:<br>1. Encrypt text: "Encrypt this message: Hello World"<br>2. Decrypt data: "Decrypt this data that was previously encrypted for me" | Encrypt: {"ciphertext":[89,32,155,38,125,22,49,226,26,...]} <br> Decrypt: `{"plaintext":"hello |
Prerequisites
Time Estimate
15-60 minutes depending on server complexity
Steps
Troubleshooting
✓ Do
✗ Don't
💡 Pro Tips
Architecture
Model Context Protocol standardizes how AI hosts (Claude, Cursor) communicate with external tools and data sources through server implementations.
Protocols
Compatibility
✓ Use when
Use when you need Claude to access external data, execute actions, or integrate with tools. Best for extending AI capabilities beyond conversation.
✗ Avoid when
Avoid when native integrations exist (use official APIs directly), for real-time critical systems, or when security/compliance requires zero external dependencies.