# BSV MCP

> An open source Model Context Protocol server that gives Claude, Cursor, and any MCP client a Bitcoin SV wallet: send BSV, inscribe ordinals, manage identity, and read the chain.

BSV MCP is version 0.4.0 and speaks MCP protocol 2025-11-25.
It runs three ways: locally over stdio, self-hosted over Streamable HTTP, or as
the hosted service on this domain. Every page on this site is also available as
markdown by sending `Accept: text/markdown`, or by appending `.md` to the path.

## Docs

- [Home](https://bsvmcp.com/index.md): what BSV MCP is, the tool catalogue, install instructions and deployment modes
- [Connect](https://bsvmcp.com/connect.md): generate or import a Bitcoin key and get a client configuration
- [Documentation](https://bsvmcp.com/docs.md): wallet setup, backend configuration, tools, sponsorship, delegation and troubleshooting
- [README](https://github.com/b-open-io/bsv-mcp#readme): quick start and source
- [Changelog](https://github.com/b-open-io/bsv-mcp/blob/master/CHANGELOG.md): release history

## API

- [MCP endpoint](https://bsvmcp.com): Streamable HTTP transport, OAuth 2.1 protected
- [Protected resource metadata](https://bsvmcp.com/.well-known/oauth-protected-resource): RFC 9728, declares supported scopes
- [Authorization server metadata](https://bsvmcp.com/.well-known/oauth-authorization-server): RFC 8414 endpoints for https://auth.sigmaidentity.com

## Scopes

- `openid`: Authenticate and identify the user.
- `profile`: Read the user's basic profile.
- `email`: Read the user's email address.
- `offline_access`: Refresh access without re-prompting the user.

## Tools

- Wallet (60 tools): Send BSV, manage UTXOs, inscribe files and mint collections from a local key, a BRC-100 signer, or a Droplit-sponsored wallet.
- Ordinals (6 tools): Look up 1Sat Ordinals, browse marketplace listings, and buy or list NFTs directly from a conversation.
- Explorer (7 tools): Decode raw transactions, fetch blocks and addresses, and pull the live BSV price with built-in caching.
- Identity (1 tools): Create and manage Bitcoin Attestation Protocol (BAP) identities and sign attestations on-chain.
- Social (5 tools): Post, like, and follow on BSocial. Your agent can publish to the open social graph.
- Tokens (5 tools): Check balances and transfer MNEE stablecoin, with utilities for encoding, hashing, and data conversion.

Tools in the release catalog (availability depends on configuration): 80+.

## Optional

- [Source](https://github.com/b-open-io/bsv-mcp): issue tracker and contribution guide
- [Package](https://www.npmjs.com/package/bsv-mcp): published npm package
- [Sitemap](https://bsvmcp.com/sitemap.xml): every indexable URL