Alby Bitcoin Payments Extension
Connect goose to your Bitcoin Lightning Wallet
This tutorial covers how to add the Alby Bitcoin Payments MCP Server as a goose extension to interact with your lightning wallet, make and receive payments, list transactions, convert fiat amounts to sats, request invoices from lightning addresses, and interact with paid MCP tools (such as ones built with PaidMCP).
You'll need a lightning wallet that supports NWC. If you don't have one yet, consider trying Alby Hub.
Quick Install
goose Desktop
goose CLI
Command
npx -y @getalby/mcpEnvironment Variable
NWC_CONNECTION_STRING: nostr+walletconnect://...Configuration
You'll need Node.js installed on your system to run this command, as it uses npx
or you can use the Alby-hosted MCP (see remote options below).
goose Desktop
Local
Remote
goose CLI
Local
Remote
Example Usage
Memory Extension
Use the built-in memory extension to save your contacts. e.g. "My friend Rene's lightning address is [email protected]. Please save it to your memory."
goose Prompt
Pay Rene $1 USD, with message "Hi Rene, it's Roland. I'm making a goose tutorial!"
goose Output
CLI
Tool Calls
─── fiat_to_sats | alby ──────────────────────────
fiat_amount: 1
fiat_currency: USD
─── request_invoice | alby ──────────────────────────
amount_in_sats: 935
description: ...
lightning_address: [email protected]
─── pay_invoice | alby ──────────────────────────
invoice: ...✅ Payment Successful!
I've successfully sent $1 USD (935 sats) to Rene at [email protected] with your message: "Hi Rene, it's Roland. I'm making a goose tutorial!"
Transaction Details:
- Amount: 935 sats ($1 USD)
- Fees: 3 sats
- Total cost: 938 sats
- Message: "Hi Rene, it's Roland. I'm making a goose tutorial!"
- Payment hash:
cd30642470d81c2e8eb04c9ac95e679c53778537aecdf5554b15288ac42fe129
Rene will receive the message "Thanks, sats received!" as confirmation of the payment.