Bitcoin MCP logo

Bitcoin MCP

by AbdelStark

Connects AI clients to Bitcoin and Lightning tools for keys, addresses, transactions, blocks, invoices, and LNBits payments.

Install Bitcoin MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "abdelstark-bitcoin-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bitcoin-mcp@latest"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 7 tools correctly (1mo ago).

Overview

AbdelStark/bitcoin-mcp MCP server exposes Bitcoin and Lightning Network operations to AI clients through MCP tools. It can generate key pairs, validate addresses, decode transactions and invoices, retrieve blockchain data, and pay Lightning invoices from an LNBits wallet. The server can run locally through an npm package and be configured for Claude Desktop or Goose. Reach for it when an agent needs structured access to Bitcoin data or selected Lightning operations.

Use cases

  • Generate Bitcoin key material for an agent workflow
  • Validate Bitcoin addresses before processing
  • Inspect blocks and transactions by blockchain identifiers
  • Decode raw Bitcoin transactions and BOLT11 invoices
  • Pay Lightning invoices through an LNBits wallet

Key features

  • Bitcoin key-pair generation
  • Bitcoin address validation
  • Raw transaction decoding
  • Latest-block and transaction queries
  • BOLT11 invoice decoding
  • LNBits Lightning invoice payments

Tools7

What Bitcoin MCP lets your agent do. Expand a tool for its parameters.

Verified live~241 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

11/11 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · bitcoin-mcp@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars77Stargazers on the source repository.
npm downloads176Package downloads in the last 30 days.
Last commit1y agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed7Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Bitcoin MCP works

What AbdelStark/bitcoin-mcp MCP server does

AbdelStark/bitcoin-mcp MCP server gives MCP-compatible AI clients access to Bitcoin and Lightning Network functions. Its Bitcoin features cover key generation, address validation, raw transaction decoding, latest-block queries, and transaction lookups by TXID. It also includes Lightning-specific operations for reading BOLT11 invoices and paying invoices through an LNBits wallet.

The server is intended for agent workflows that need to inspect blockchain information or perform narrowly defined Bitcoin and Lightning actions through tool calls.

How it works

An MCP client starts the server and communicates with it through the Model Context Protocol. Goose is also documented as a supported client, with both local command-line and remote SSE integration modes described in the project material.

For read-oriented Bitcoin tasks, the available tools can return information about the latest block, retrieve transaction details using a transaction ID, decode raw transaction data, or validate an address. Key generation returns a Bitcoin address, public key, and private key in WIF format. Lightning tools parse BOLT11 invoice data and can submit a payment using an LNBits wallet.

Setup and configuration

The documented Claude Desktop setup uses this MCP configuration:

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

After adding the entry to Claude Desktop's configuration file, restart the application so it launches the server. The README identifies platform-specific configuration paths for macOS and Windows. It also documents Goose setup as either a local command-line extension or a remote SSE extension.

The payment capability should therefore be configured using the project's current documentation before use.

Tools and capabilities

  • Generate Bitcoin key pairs, including address, public key, and WIF private key.
  • Check whether a Bitcoin address is valid.
  • Decode raw Bitcoin transactions into human-readable details.
  • Retrieve the latest Bitcoin block and its metadata.
  • Look up transaction details by TXID.
  • Decode BOLT11 Lightning invoices.
  • Pay Lightning invoices from an LNBits wallet.

AbdelStark/bitcoin-mcp MCP server can be tested from Claude Desktop with questions about the latest block or a transaction identified by its TXID. The response should come from the connected MCP tools rather than from a generic model answer.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Bitcoin MCP

Run it through npm with `npx -y bitcoin-mcp@latest`. Claude Desktop can launch this command from its MCP server configuration.

Yes. The README provides Claude Desktop configuration using the `bitcoin-mcp@latest` npm package and instructs users to restart Claude Desktop after saving the configuration.

Yes. It can decode raw Bitcoin transactions and return their details in a human-readable format. It can also retrieve transaction information by TXID.

Yes. The server can pay a Lightning invoice directly from an LNBits wallet.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewBitcoin MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/abdelstark-bitcoin-mcp?style=directory)](https://allmcps.com/mcp/abdelstark-bitcoin-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/abdelstark-bitcoin-mcp"><img src="https://allmcps.com/api/badge/abdelstark-bitcoin-mcp?style=directory" alt="Bitcoin MCP on AllMCPs" /></a>