home / mcp / alby bitcoin payments mcp server

Alby Bitcoin Payments MCP Server

Provides a remote MCP server to connect NWC-based bitcoin lightning wallets to LLM agents and tools.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "getalby-mcp": {
      "url": "https://mcp.getalby.com/sse",
      "headers": {
        "NWC_CONNECTION_STRING": "nostr+walletconnect://..."
      }
    }
  }
}

You connect a bitcoin lightning wallet to your LLM using Nostr Wallet Connect (NWC) via the Alby MCP Server. This server leverages the official MCP TypeScript SDK to provide a streamlined way to access NWC-enabled wallets and related tooling from supported MCP clients.

How to use

You can connect to the Alby MCP Server from MCP clients that support remote servers over SSE or HTTP Streamable transports.

How to install

Prerequisites you need before running the MCP server include Node.js 20 or newer and Yarn.

Install dependencies and build the project, then run the server in your environment.

Additional sections

Configuration and usage notes follow to help you securely connect your NWC wallet through the Alby MCP Server and integrate with popular MCP clients like Claude, Goose, Claude Code, N8N, Windsurf, and others.

Security considerations include using a wallet connection secret in a bearer token when supported by your client, or passing the secret as a query parameter if bearer authorization is not available.

Available tools

NWC

Nostr Wallet Connect integration to establish a secure connection between your wallet and the MCP server.

LNURL

Lightning Network URL protocol support for interacting with LN-based services.

L402

Alby Lightning Tools integration enabling advanced wallet actions through the MCP server.