mcp-server-bitcoin-wallet
3.1
If you are the rightful owner of mcp-server-bitcoin-wallet and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A Model Context Protocol (MCP) server that enables AI agents to interact with a Bitcoin wallet.
Bitcoin Wallet MCP Server
A Model Context Protocol (MCP) server that enables AI agents to interact with a Bitcoin wallet.
Features
get_address: Display a Bitcoin address to receive a paymentget_balance: Display the current balance of the walletsend_transaction: Send a transaction to a specific address
Setup
- Install dependencies:
pnpm install
- Set environment variables:
export WALLET_PASSWORD="your-secure-password"
- Build the project:
pnpm build
- Run the server:
pnpm start
Development
- Run in development mode with the MCP CLI:
pnpm dev
- Run with the MCP Inspector:
pnpm inspect
Architecture
This is a simple SPV (Simplified Payment Verification) Bitcoin wallet that:
- Stores a single private key encrypted in the OS keychain
- Uses the password from WALLET_PASSWORD env var for key encryption
- Follows a stateless-ready architecture where all network data is fetched on-demand
Security Notes
- The wallet password must be provided via environment variable
- The private key is stored encrypted in the OS keychain
- Never logs sensitive information like private keys or mnemonics
- All operations are performed in memory and cleaned up after use
