Bitcoin MCP Server
Bitcoin and Lightning Network interactions through key generation and transaction decoding.
Data last scanned today · Reviewed today
Overview
The Bitcoin MCP Server provides a bridge between AI agents and the Bitcoin network. It includes capabilities for generating cryptographic keys, validating addresses, and decoding blockchain transactions, facilitating direct interaction with the protocol for development or inquiry purposes. Designed for integration with various AI environments, the server supports standard Model Context Protocol communication methods. It allows users to query blockchain data or manage network-related tasks through their preferred AI client interfaces.
Our verdict
With a security score of 37/100, this server is considered high-risk. The architecture lacks a read-only mode, meaning all installations grant full write access by default. Given that the repository has not received a commit in 365 days and is community-maintained rather than vendor-backed, users should exercise extreme caution. This tool is best reserved for experimental environments where transactional risks can be isolated.
- Small footprint with only 15 direct dependencies
- Comprehensive integration documentation provided
- MIT licensed for permissive use
- No read-only mode restricts security controls
- Inactive repository with no updates for one year
- Lacks official vendor maintenance and support
Setup
{
"mcpServers": {
"bitcoin-mcp": {
"args": [
"-y",
"bitcoin-mcp"
],
"command": "npx"
}
}
}Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.
- No read-only mode — running this grants full read/write access.
- No built-in authentication — anyone with access to this config can invoke every tool it exposes.
Tools
| Tool | Description | Risk |
|---|---|---|
| generate_key | Create new Bitcoin key pairs including address, public key, and private key. | medium |
| validate_address | Validate the correctness of a Bitcoin address. | low |
| decode_transaction | Parse a raw Bitcoin transaction and display its details in a human-readable format. | low |
| get_latest_block | Retrieve details about the most recent block including hash, height, timestamp, and transaction count. | low |
| get_transaction_details | Fetch detailed information about a transaction using its TXID. | low |
| decode_invoice | Parse a BOLT11 Lightning invoice and display human-readable information. | low |
| pay_invoice | Pay a Lightning invoice directly from your LNBits wallet. | medium |
Compatibility
| Client | Local | Docker | Remote | Read-only |
|---|---|---|---|---|
| Claude Desktop | ||||
| Cursor | ||||
| VS Code | ||||
| Windsurf | ||||
| ChatGPT |
Frequently asked questions
›Can this server process payments on the Lightning Network?
Yes, the server includes a tool for paying Lightning invoices directly from an LNBits wallet.
›Does the server require specific configuration for Lightning Network features?
Yes, there is an optional setup step for Lightning Network configuration provided in the development setup documentation.
›What kind of Bitcoin address validation does the server provide?
The server includes a dedicated tool to validate the correctness of a Bitcoin address.
›Can the server decode raw transaction data?
Yes, it provides a feature to parse raw Bitcoin transactions and display the details in a human-readable format.
›How can I test if the Claude Desktop integration is working?
After restarting Claude Desktop, you can verify the integration by asking Claude a question related to Bitcoin, such as requesting details on the latest block.
Badge
Maintain this server? Add the live badge to your README.