bitcoin MCP Server

Use This MCP server To

Create and restore Bitcoin and Ark wallets programmatically Send Bitcoin and Ark transactions via AI-driven workflows Retrieve real-time Bitcoin and Ark wallet balances Convert Bitcoin prices in real-time for financial applications Cache Bitcoin price data for efficient repeated queries Validate wallet operations with strong typing and schema checks Integrate Bitcoin wallet management into AI copilots like Claude Desktop Enable AI agents to interact with Bitcoin blockchain securely

README

Bitcoin MCP

Bitcoin MCP Demo

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

bitcoin-mcp FAQ

How does Bitcoin MCP handle wallet creation and restoration?

It provides tools to create or restore Bitcoin and Ark wallets using private keys or new generation, supporting multiple Bitcoin networks like mainnet, testnet, and signet.

What error handling mechanisms are included in Bitcoin MCP?

The server includes comprehensive error handling and fallback strategies to ensure reliable wallet operations and transaction management.

How does Bitcoin MCP optimize Bitcoin price fetching?

It uses cache-optimized price fetching from blockchain.info to reduce latency and improve efficiency in real-time price conversions.

Can Bitcoin MCP be integrated with other blockchain SDKs?

Yes, it integrates with the @arklabs/wallet-sdk to extend functionality for Ark blockchain alongside Bitcoin.

What kind of schema validation does Bitcoin MCP use?

It uses Zod for schema validation to ensure data integrity and correctness in wallet and transaction operations.

Which AI applications can use Bitcoin MCP?

AI applications like Claude Desktop and Cursor can leverage Bitcoin MCP to manage Bitcoin wallets and transactions within their workflows.

Does Bitcoin MCP support multiple Bitcoin networks?

Yes, it supports bitcoin mainnet, testnet, signet, and mutinynet networks for flexible development and testing.

How secure is the Bitcoin MCP server?

It employs strongly typed operations, schema validation, and robust error handling to maintain secure and reliable interactions with the Bitcoin network.