Bitcoin MCP

🚀 Bitcoin MCP

A Model Context Protocol (MCP) server that provides Bitcoin tools for AI applications such as Claude Desktop and Cursor, allowing them to interact with the Bitcoin network and manage wallet operations.

🚀 Quick Start

Bitcoin MCP server extends the capabilities of any MCP client to perform the following operations:

• Create and restore Bitcoin and Ark wallets.
• Send Bitcoin and Ark transactions.
• Get Bitcoin and Ark wallet balances.
• Real - time Bitcoin price conversion.
• Optimized price retrieval through blockchain.info caching.
• Wallet operations with strong typing.
• Comprehensive error handling and fallback options.
• Schema validation using Zod.
• Integration with @arklabs/wallet-sdk.

✨ Features

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 status.

get_addresses

Get all wallet addresses.

get_balance

Get the wallet balance, with optional Fiat currency conversion.

send_bitcoin

Send Bitcoin to an address:

{
  address: string,
  amount: number, // in satoshis
  feeRate?: number // Optional fee rate
}

🔧 Technical Details

Development

This project uses the following tools:

• pnpm - Package manager
• Vite - Build system
• Vitest - Testing framework
• TypeScript - Programming 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