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

1. Install dependencies:

pnpm install

2. Run tests:

pnpm test

3. Build the project:

pnpm build

License

MIT License