Skip to directory

Alby Bitcoin Payments MCP

Alby

Streamable HTTP; legacy SSE is also documented11 documented tools4

About Alby Bitcoin Payments MCP

Alby’s hosted Bitcoin Payments MCP connects an NWC-enabled Lightning wallet to an AI client for wallet queries, balances, invoices, payments and Lightning workflows.

What you can use it for

  • Query wallet information and balances.
  • Create invoices and send or receive Lightning payments.
  • Use wallet actions and payment workflows supported by NWC.
Connection and setup
Hosting
Local or remote hosted
Transport
Streamable HTTP; legacy SSE is also documented
Endpoint
https://mcp.getalby.com/mcp
Authentication
Nostr Wallet Connect (NWC) connection secret using Bearer auth, or documented nwc query parameter; local server uses NWC_CONNECTION_STRING.

Requirements

  • A Lightning wallet that supports Nostr Wallet Connect and an NWC connection string
  • For local package setup, Node.js 20+ and npx; source build also requires Yarn
  • The remotely hosted Claude connector documentation states at least Claude Pro is required for remote MCP connections

Setup steps

  1. Create an NWC connection in a supported Lightning wallet and review its allowed permissions/limits.
  2. For local stdio setup, configure command `npx`, args [`-y`, `@getalby/mcp`], and `NWC_CONNECTION_STRING` using the client's secure local secret mechanism.
  3. For hosted HTTP setup, add https://mcp.getalby.com/mcp and use Bearer authentication with the NWC connection secret; prefer the header method over putting secrets in URLs.
  4. Complete wallet/client authorization as applicable and verify first with a harmless wallet-information or balance read.
  5. Do not send a payment unless the destination and amount have been explicitly reviewed and approved by the user.
Tools 11

Crawl4AI checked the official getAlby/mcp repository, publisher overview, and hosted setup. The same current repository tool roster is also catalogued under duplicate slug alby-bitcoin-payments-mcp-server; copied its 11 exact identifiers and descriptions into this listing. Payment tools can move funds; review destination and invoice before use.

  • get_wallet_service_info

    Get information about the connected Nostr Wallet Connect (NWC) wallet service.

    01
  • get_info

    Get wallet identity and supported wallet capabilities.

    02
  • make_invoice

    Create a Lightning invoice for an amount and optional description.

    03
  • pay_invoice

    Pay a Lightning invoice from the connected wallet; this moves funds.

    04
  • get_balance

    Read the connected Lightning wallet balance.

    05
  • lookup_invoice

    Look up an invoice and its payment status.

    06
  • list_transactions

    List wallet transactions.

    07
  • fetch_l402

    Fetch an HTTP resource protected by Lightning L402 payment; only globally routable hosts are permitted.

    08
  • fiat_to_sats

    Convert a fiat amount to an estimated satoshi amount.

    09
  • parse_invoice

    Decode a Lightning invoice and return its details.

    10
  • request_invoice

    Request an invoice through supported Lightning address/LNURL flows.

    11
Limitations and notes
  • This server can move funds. Use a dedicated wallet with restricted permissions/budget and confirm amounts, destination, and invoice before payment. NWC connection strings are wallet credentials.
Source discrepancies
  • The old getAlby/nwc-mcp-server repository is archived and explicitly deprecated in favor of getAlby/mcp. Current listing uses the replacement implementation; old implementation details are not merged.
Original sources

Documentation checked 2026-10-28T20:00:00.000Z. Connection has not been runtime tested.