# open source · 80+ tools

The Bitcoin SV wallet for MCP clients.

Tools that let Claude, Cursor or any agent send BSV, inscribe ordinals and read the chain. No SDK code. One command, hosted or local.

terminal

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

Connect the hosted server Clone source

>_ fig. 1 — prompt to txid

Claude Code v2.1.206

Welcome back you!

bsv-mcp · local wallet

1 MCP server connected

~/bsv-mcp

Tips for getting started

Ask in plain language, get a txid

What's new

Send BSV, inscribe ordinals, read the chain

/release-notes for more

inscribe hello.svg as a 1sat ordinal and tell me the txid

I'll inscribe it, then report the outpoint.

wallet_createOrdinals(dataB64: "…", contentType: "image/svg+xml")broadcast ✓(ctrl+o to expand)

content prepared as base64 selecting UTXOs · estimating fee broadcast ✓

Inscribed. Outpoint f3a1…9c2e_0 — view it on 1satordinals.com

auto mode on (shift+tab to cycle) · ← for agents

tools

MIT

open source

clients documented

# why

Wallet code is the part of every agent nobody wants to write.

without

Hand-wire the SDK into every agent you build
Manage keys, UTXOs and fees yourself
Re-implement broadcasting for each client

with bsv-mcp

One MCP server, every client
Keys encrypted at rest or held by your own signer
Ask in plain language, get a txid

# tools

Everything on-chain, as tools your agent can call.

Counts describe the release catalog. Your available tools depend on wallet mode and enabled categories; see the docs for setup.

full reference

60 tools

Wallet

Send BSV, manage UTXOs, inscribe files and mint collections from a local key, a BRC-100 signer, or a Droplit-sponsored wallet.

6 tools

Ordinals

Look up 1Sat Ordinals, browse marketplace listings, and buy or list NFTs directly from a conversation.

7 tools

Explorer

Decode raw transactions, fetch blocks and addresses, and pull the live BSV price with built-in caching.

1 tool

Identity

Create and manage Bitcoin Attestation Protocol (BAP) identities and sign attestations on-chain.

5 tools

Social

Post, like, and follow on BSocial. Your agent can publish to the open social graph.

5 tools

Tokens

Check balances and transfer MNEE stablecoin, with utilities for encoding, hashing, and data conversion.

# install

Run it your way.

The same server ships in three shapes. Pick the one that fits your client and your key custody.

Local

stdio transport

Runs on your machine with an external signer or local keys. Optional encrypted key storage; see the wallet setup docs.

HTTP

Streamable HTTP

Self-host the Streamable HTTP endpoint with OAuth 2.1 and JWT validation.

Hosted

bsvmcp.com

Add the hosted URL to your AI client and authorize access through Sigma Identity.

# pick your client

Claude Code

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

Or register the local server yourself

Claude Code

claude mcp add --transport stdio bsv-mcp -- bunx bsv-mcp@latest --stdio

Or use the hosted server

Claude Code

claude mcp add --transport http bsv-mcp https://bsvmcp.com

The plugin bundles the server and registers it automatically, so no config file is needed.

Claude Code MCP documentation

works with Claude Code · Claude Desktop · Cursor · Codex · Grok Build · opencode · Any MCP client

# keys

Your keys never end up in a prompt.

An agent with a wallet needs guardrails. The model can act without ever seeing raw key material.

Encrypted at rest
Local accounts use encrypted bitcoin-backup files. Missing keys stop startup; the server never generates a replacement.
No passphrase env vars
Passphrases are entered through a temporary local web prompt, never read from the environment.
Bitcoin-signed auth
Hosted mode uses OAuth 2.1 via sigma-auth. Your public key is your identity. Nothing to register.
External signers
Point at a BRC-100 wallet and it stays the permission authority. Every spend is approved there.

# faq

Before you install.

Does it work with my client?: Anything that speaks MCP. Claude Code, Claude Desktop, Cursor, Codex, Grok Build and opencode are documented above with their exact config; any other stdio client runs it with bunx bsv-mcp@latest --stdio.
Where are my keys?: Use an external BRC-100 signer or a named encrypted account. Run init in a local terminal and back up the account before funding it.
Is it maintained?: Yes. The changelog on GitHub is the record of what shipped.
Can I read the code first?: All of it. MIT licensed, on GitHub. The tool count is a release snapshot; available tools depend on your wallet mode and enabled categories.

# ship

Put your agent on-chain.

Connect a wallet, check your balance, and make your first request from a chat window.

Connect the hosted server