Bitcoin

v1.0.0Finance & Fintechstable

Bitcoin & Lightning Network MCP Server.

ai-agentsbitcoinclaude-desktopgooselightning-network
Share:
74
Stars
0
Downloads
0
Weekly
0/5

What is Bitcoin?

Bitcoin is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to bitcoin & lightning network mcp server.

Bitcoin & Lightning Network MCP Server.

This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • generate_key
  • validate_address
  • decode_tx
  • get_latest_block
  • get_transaction

Use Cases

Bitcoin and Lightning Network blockchain data access
Cryptocurrency transaction analysis and management
AbdelStark

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedApr 16, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx bitcoin

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Bitcoin

The Bitcoin MCP Server connects AI assistants to the Bitcoin blockchain and Lightning Network, enabling real-time queries of blockchain data and Lightning invoice operations without any API keys for read-only functions. It exposes tools for generating Bitcoin key pairs, validating addresses, decoding raw transactions, fetching the latest block, and looking up transactions by ID. For Lightning Network functionality, it integrates with LNBits wallets to decode and pay BOLT11 invoices, making it useful for developers building Bitcoin-aware AI workflows.

Prerequisites

  • Node.js 18+ installed (for npx execution)
  • An MCP-compatible client such as Claude Desktop or Goose
  • LNBits instance and API keys (only required for Lightning Network payment features)
  • No Bitcoin node required — blockchain data is fetched from public APIs
1

Install the Bitcoin MCP server

The server is available as an npm package and can be run directly with npx. No global installation is required for basic use.

npx -y bitcoin-mcp@latest
2

Add to Claude Desktop configuration

Edit your Claude Desktop config file to register the bitcoin-mcp server. On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows: %APPDATA%\Claude\claude_desktop_config.json.

{
  "mcpServers": {
    "bitcoin-mcp": {
      "command": "npx",
      "args": ["-y", "bitcoin-mcp@latest"]
    }
  }
}
3

Configure Lightning Network (optional)

To enable Lightning Network features such as paying invoices, provide your LNBits credentials. Obtain the admin and read keys from your LNBits wallet's API info page.

{
  "mcpServers": {
    "bitcoin-mcp": {
      "command": "npx",
      "args": ["-y", "bitcoin-mcp@latest"],
      "env": {
        "LNBITS_URL": "https://demo.lnbits.com",
        "LNBITS_ADMIN_KEY": "your_admin_key",
        "LNBITS_READ_KEY": "your_read_key"
      }
    }
  }
}
4

Restart Claude Desktop

Fully quit and relaunch Claude Desktop so the new MCP server configuration is loaded. Look for the hammer icon in the input bar to confirm tools are available.

5

Verify with a blockchain query

Ask Claude to fetch the latest Bitcoin block. The server will call the blockchain API and return current block height, hash, and timestamp.

Bitcoin Examples

Client configuration

Minimal configuration for Claude Desktop without Lightning Network features.

{
  "mcpServers": {
    "bitcoin-mcp": {
      "command": "npx",
      "args": ["-y", "bitcoin-mcp@latest"]
    }
  }
}

Prompts to try

Try these queries once the server is connected to Claude Desktop.

- "What is the latest Bitcoin block number and when was it mined?"
- "Generate a new Bitcoin key pair with address for me"
- "Validate this Bitcoin address: bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh"
- "Decode this raw Bitcoin transaction and explain what it does"
- "Decode this Lightning invoice and show the amount and description"

Troubleshooting Bitcoin

npx bitcoin-mcp fails with 'command not found' or package not found

Use the correct package name: 'npx -y bitcoin-mcp@latest' (not 'npx bitcoin'). Ensure Node.js 18+ is installed by running 'node --version'.

Lightning Network tools return authentication errors

Verify your LNBits URL is reachable and that LNBITS_ADMIN_KEY and LNBITS_READ_KEY are set correctly in the env block of your MCP config. Obtain keys from your LNBits wallet at Settings → API Info.

Blockchain queries return stale or no data

The server fetches from public blockchain APIs. Transient network failures or rate limiting may cause empty responses. Retry after a moment, or check your internet connection.

Frequently Asked Questions about Bitcoin

What is Bitcoin?

Bitcoin is a Model Context Protocol (MCP) server that bitcoin & lightning network mcp server. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Bitcoin?

Follow the installation instructions on the Bitcoin GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Bitcoin?

Bitcoin works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Bitcoin free to use?

Yes, Bitcoin is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Finance & Fintech MCP Servers

Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "bitcoin": { "command": "npx", "args": ["-y", "bitcoin"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Bitcoin?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides