Alby Bitcoin Payments MCP Server Logo

Alby Bitcoin Payments MCP Server

Official

Connects a Bitcoin Lightning wallet to your LLM using Nostr Wallet Connect, enabling payments and in...

7 views
0 installs
Updated Jan 19, 2026
Not audited
Connects a Bitcoin Lightning wallet to your LLM using Nostr Wallet Connect, enabling payments and interactions with Lightning Network features.
  1. Click the "Install Now" button in FastMCP to add this MCP server, then open the FastMCP connection interface for the newly added server.

  2. In the FastMCP connection interface, add the required environment variable:

    • Key: NWC_CONNECTION_STRING
    • Value: your full NWC connection secret (a string that starts with nostr+walletconnect://...)
    • Note: paste the raw connection string (not URL-encoded) into the NWC_CONNECTION_STRING field. (github.com)
  3. How to obtain the NWC connection secret (nostr+walletconnect://...):

    1. Use a lightning wallet that supports Nostr Wallet Connect (NWC) — e.g., Alby or any wallet listed on nwc.dev. (nwc.dev)
    2. In the wallet app/extension, open its "Connect", "Apps", or "Wallet Connect" section and create a new connection / authorize a new client. The wallet will generate a connection URI that looks like:
      nostr+walletconnect://?relay=&secret=<32-byte-hex>
      (this full URI is the connection secret you must copy). (docs.nwc.dev)
    3. Copy the entire connection URI exactly (no extra spaces). If your wallet shows a QR code or deeplink instead, use the wallet UI option to "copy connection string" or scan the QR with the client that can reveal/copy the URI. (docs.nwc.dev)
  4. If you plan to connect the hosted Alby MCP endpoint using a query parameter (instead of setting NWC_CONNECTION_STRING in FastMCP):

    1. URL-encode the connection string (e.g. in your browser console run: encodeURIComponent("nostr+walletconnect://...")) and use the encoded result as the nwc query value. (github.com)
    2. Example endpoint forms:
  5. Optional: if you run the MCP server locally and want HTTP/SSE transport instead of STDIO, set:

    • Key: MODE
    • Value: HTTP
      (HTTP mode requires bearer auth where the token is the same NWC connection secret). (github.com)
  6. After filling the NWC_CONNECTION_STRING (and optional MODE), save the FastMCP connection. Ensure you pasted the full connection string without added whitespace; then test the connection from your agent (or use the hosted Alby endpoints with the connection secret). If connection fails, re-copy the connection string from your wallet and try again. (docs.nwc.dev)

  7. If you get stuck or your wallet does not show a connection string option, open your wallet's support/docs or contact Alby support for help (support.getalby.com). (github.com)

Quick Start

View on GitHub

More for Finance

View All →

More for Developer Tools

View All →

Report Issue

Thank you! Your issue report has been submitted successfully.