@bsv/simple MCP Server

An MCP (Model Context Protocol) server that provides AI agents with knowledge and code generation tools for building BSV blockchain applications using @bsv/simple.

Quick Start

Claude Code (recommended)

claude mcp add simple-mcp -- npx -y @bsv/simple-mcp

That's it — Claude will automatically download and run the MCP server via npx.

Docker (alternative)

docker build -t simple-mcp .

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "simple": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "simple-mcp"]
    }
  }
}

Resources

URI	Description
simple://api/wallet	WalletCore + BrowserWallet + ServerWallet methods
simple://api/tokens	Token create/list/send/redeem/messagebox
simple://api/inscriptions	Text/JSON/hash inscriptions
simple://api/messagebox	Certification, payments, identity registry
simple://api/certification	Certifier, certificates, revocation
simple://api/did	DID class, wallet DID methods
simple://api/credentials	Schema, Issuer, VC/VP, revocation stores
simple://api/overlay	Overlay, SHIP/SLAP, broadcasting
simple://guide/nextjs	Complete Next.js integration guide

Tools

Tool	Description
scaffold_nextjs_config	Generate next.config.ts + package.json for BSV apps
generate_wallet_setup	Wallet initialization code (browser or server)
generate_payment_handler	Payment handler functions
generate_token_handler	Token CRUD operations
generate_inscription_handler	OP_RETURN inscription handlers
generate_messagebox_setup	MessageBox P2P integration
generate_server_route	Next.js API route for server wallet
generate_credential_issuer	CredentialIssuer setup with schema
generate_did_integration	DID integration code

Prompts

Prompt	Description
integrate_simple	Full integration walkthrough
add_bsv_feature	Feature-specific code generation
debug_simple	Debugging help for common issues