bitcoin-mcp
6
Bitcoin MCP is an MCP server offering Bitcoin tools for AI applications, enabling operations like wallet management and real-time transactions with comprehensive error handling and schema validation.
Bitcoin MCP
A Model Context Protocol (MCP) server that provides Bitcoin tools for AI applications like Claude Desktop and Cursor, allowing them to interact with the Bitcoin Network and manage wallet operations.
Overview
The Bitcoin MCP server extends any MCP client's capabilities by providing tools to do anything with Bitcoin:
- Create and restore Bitcoin and Ark wallets
- Send Bitcoin and Ark transactions
- Retrieve Bitcoin and Ark wallet balances
- Real-time Bitcoin price conversion
- Cache-optimized price fetching via blockchain.info
- Strongly typed wallet operations
- Comprehensive error handling and fallbacks
- Schema validation with Zod
- Integration with
@arklabs/wallet-sdk
Available Tools
setup_wallet
Create or restore a Bitcoin wallet:
{
action: "create" | "restore",
privateKey?: string,
network?: "bitcoin" | "testnet" | "signet" | "mutinynet",
arkServerUrl?: string,
esploraUrl?: string
}
get_wallet_status
Get the current wallet status and initialization state.
get_addresses
Get all wallet addresses.
get_balance
Get wallet balance with optional fiat conversion.
send_bitcoin
Send Bitcoin to an address:
{
address: string,
amount: number, // in satoshis
feeRate?: number // optional fee rate
}
Development
This project uses:
- pnpm - Package manager
- Vite - Build system
- Vitest - Testing framework
- TypeScript - Language
- Zod - Schema validation
Getting Started
- Install dependencies:
pnpm install
- Run tests:
pnpm test
- Build the project:
pnpm build
License
MIT License