Alby Bitcoin Payments

Alby Bitcoin Payments

Connect any bitcoin lightning wallet to your agent to send and receive instant payments globally with your agent.

36
Stars
9
Forks
2
Releases

Overview

This MCP server connects a Bitcoin Lightning wallet to an LLM via Nostr Wallet Connect (NWC). Built on the official MCP TypeScript SDK, it provides MCP server capabilities with knowledge of NWC, LNURL, and L402 through the Alby SDK and Alby Lightning Tools. It supports remote transports (SSE and HTTP Streamable) so agents can interact with the wallet from various environments. Endpoints include SSE at https://mcp.getalby.com/sse and HTTP Streamable at https://mcp.getalby.com/mcp, with authentication via a Bearer token or the nwc query parameter. The authentication workflow is documented: encode the NWC connection secret and use either Authorization: Bearer <secret> or the nwc query parameter. The server runs in STDIO mode by default and can be switched to HTTP mode with MODE=HTTP to expose streamable APIs, protected by the wallet secret. The README provides extensive integration guidance for Claude Web/Desktop, Goose Desktop/CLI, N8N, Windsurf, and more, plus prerequisites (Node.js 20+, Yarn), installation, and from-source workflows. See tools, examples, and troubleshooting for hands-on testing and usage.

Details

Owner
getAlby
Language
TypeScript
License
Apache License 2.0
Updated
2025-12-07

Features

NWC-powered wallet connection

Connect a bitcoin Lightning wallet to your LLM via Nostr Wallet Connect.

Dual transport support

Supports SSE and HTTP Streamable transports for remote MCP access.

Bearer or query authentication

Authenticate using an NWC connection secret via Authorization header or via the nwc query parameter.

Official MCP TypeScript SDK

Built on the MCP TypeScript SDK for compatibility and tooling.

Knowledge base for NWC/LNURL/L402

Includes knowledge of NWC, LNURL, and L402 via Alby SDK and Alby Lightning Tools.

Extensive client integration guides

Provides setup guidance for Claude Web/Desktop, Goose Desktop/CLI, N8N, Windsurf, and other clients.

Modes: STDIO and HTTP

Defaults to STDIO; can enable HTTP mode with MODE=HTTP for streamable APIs.

From Source development workflow

Prerequisites and commands to install, build, and test locally (Node.js, Yarn, env setup, yarn inspect).

Audience

AI developersConnect LLM agents to a Bitcoin Lightning wallet via NWC for payments and wallet-enabled interactions.
Platform integratorsIntegrate MCP server with Claude (Web/Desktop), Goose Desktop/CLI, N8N, Windsurf to enable wallet-powered AI workflows.
MCP/infrastructure engineersHost and maintain an Alby-based MCP server using the MCP TypeScript SDK and remotely accessible transports.

Tags

NWCMCPBitcoinLightningLNURLL402AlbyAlby SDKNostr Wallet ConnectSSEHTTP StreamableClaudeGooseN8NWindsurfTypeScript SDK