Bitcoin
₿ A Model Context Protocol (MCP) server that enables AI models to interact with Bitcoin, allowing them to generate keys, validate addresses, decode transactions, query the blockchain, and more.
What is Bitcoin?
Bitcoin is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ₿ a model context protocol (mcp) server that enables ai models to interact with bitcoin, allowing them to generate keys, validate addresses, decode transactions, query the blockchain, and more.
₿ A Model Context Protocol (MCP) server that enables AI models to interact with Bitcoin, allowing them to generate keys, validate addresses, decode transactions, query the blockchain, and more.
This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- ₿ A Model Context Protocol (MCP) server that enables AI mode
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx bitcoin-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Bitcoin
The Bitcoin MCP server connects AI assistants directly to the Bitcoin network, enabling them to generate key pairs and addresses, validate addresses, decode raw transactions, retrieve the latest block information, look up transaction details by TXID, and decode BOLT11 Lightning invoices. It also supports Lightning Network payments through LNBits integration, making it useful for developers building Bitcoin-aware applications or analysts who want to query on-chain data conversationally without writing custom scripts.
Prerequisites
- Node.js 18 or later installed
- An MCP-compatible client such as Claude Desktop or Goose
- For Lightning Network features: an LNBits instance with an admin key and read key
- No Bitcoin node required — public APIs are used by default
Verify Node.js is installed
The server is distributed as an npm package and runs via npx, so Node.js 18 or later must be available on your system.
node --versionTest the server runs correctly
Run the package once with npx to confirm it starts without errors before adding it to your MCP client configuration.
npx -y bitcoin-mcp@latestAdd to Claude Desktop configuration
Open your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS) and add the bitcoin-mcp entry under mcpServers.
{
"mcpServers": {
"bitcoin-mcp": {
"command": "npx",
"args": ["-y", "bitcoin-mcp@latest"]
}
}
}Configure Lightning Network support (optional)
If you want the AI to send and receive Lightning payments, add your LNBits credentials as environment variables. Create an LNBits wallet and copy the Admin Key and Read-Only Key from the wallet's API info page.
{
"mcpServers": {
"bitcoin-mcp": {
"command": "npx",
"args": ["-y", "bitcoin-mcp@latest"],
"env": {
"lnbitsUrl": "https://your-lnbits-instance.com",
"lnbitsAdminKey": "your_admin_key_here",
"lnbitsReadKey": "your_read_key_here"
}
}
}
}Restart your MCP client
Restart Claude Desktop (or your chosen MCP client) to pick up the new server configuration. The bitcoin-mcp tools will then be available in your conversations.
Bitcoin Examples
Client configuration
Minimal Claude Desktop configuration for the Bitcoin MCP server without Lightning Network features.
{
"mcpServers": {
"bitcoin-mcp": {
"command": "npx",
"args": ["-y", "bitcoin-mcp@latest"]
}
}
}Prompts to try
Example prompts that exercise the Bitcoin MCP server's key capabilities.
- "What is the latest Bitcoin block? Show me the hash, height, and transaction count."
- "Generate a new Bitcoin key pair and show me the address, public key, and WIF private key."
- "Is the address bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq valid?"
- "Decode this raw Bitcoin transaction: 0200000001..."
- "Look up transaction details for TXID a1b2c3d4e5f6..."Troubleshooting Bitcoin
npx -y bitcoin-mcp@latest hangs or shows network errors
The server queries public Bitcoin APIs; check your internet connection and that outbound HTTPS is allowed. If behind a proxy, set the HTTPS_PROXY environment variable.
Lightning payment tools return authentication errors
Verify that lnbitsUrl is the full base URL of your LNBits instance (e.g., https://legend.lnbits.com), lnbitsAdminKey is the Admin Key (not the Invoice Key), and lnbitsReadKey is the Read-Only Key from the same wallet's API info page.
Claude Desktop does not show Bitcoin tools after configuration
Ensure the JSON in claude_desktop_config.json is valid (no trailing commas), then fully quit and reopen Claude Desktop. Use a JSON validator if unsure.
Frequently Asked Questions about Bitcoin
What is Bitcoin?
Bitcoin is a Model Context Protocol (MCP) server that ₿ a model context protocol (mcp) server that enables ai models to interact with bitcoin, allowing them to generate keys, validate addresses, decode transactions, query the blockchain, and more. 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 license. You can use it freely in both personal and commercial projects.
Bitcoin Alternatives — Similar Finance & Fintech Servers
Looking for alternatives to Bitcoin? Here are other popular finance & fintech servers you can use with Claude, Cursor, and VS Code.
ValueCell
★ 10.7kValueCell is a community-driven, multi-agent platform for financial applications.
Vibe Trading
★ 8.1k'Vibe-Trading: Your Personal Trading Agent'
Quantdinger
★ 6.2kAI quantitative trading platform for crypto, stocks, and forex with backtesting, live trading, market data, and multi-agent research.vibe-trading ,trading-agents,ai-trader,ai-trading
TradingView
★ 2.8kReal-time crypto & stock screening, advanced technical indicators, Bollinger Bands intelligence, candlestick patterns + native Claude Desktop integration. Multi-exchange (Binance, KuCoin, Bybit+). Open-source AI trading infrastructure.
Financial Datasets
★ 2.1kProvides access to comprehensive financial data including income statements, balance sheets, cash flow statements, stock prices, company news, SEC filings, and cryptocurrency information with built-in financial ratio analysis.
Stripe
★ 1.6kThe Stripe Model Context Protocol server allows you to integrate with Stripe APIs through function calling. This protocol supports various tools to interact with different Stripe services.
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.
Set Up Bitcoin in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
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.