A

Alby Bitcoin Payments MCP Server

Enables Bitcoin Lightning wallet integration with LLMs through Nostr Wallet Connect (NWC). Supports ...

86 views
0 installs
Updated Feb 6, 2026
Not audited
Tools I Recommend
Enables Bitcoin Lightning wallet integration with LLMs through Nostr Wallet Connect (NWC). Supports lightning payments, LNURL operations, and L402 authentication for AI-powered bitcoin transactions.
  1. Open the FastMCP connection interface

    • Click the "Install Now" button and open the FastMCP connection (Install/Configure) dialog where you add environment variables for the MCP server.
  2. Add the required environment variable in the FastMCP UI

    • Key: NWC_CONNECTION_STRING
    • Value: your full NWC connection secret (a URI that starts with nostr+walletconnect://...)
    • Mark the value as secret/hidden (password) if FastMCP offers that option, then save the entry.
  3. Obtain the NWC connection secret from a wallet that supports NWC

    • Use a wallet or wallet-service that supports Nostr Wallet Connect (NWC). NWC connection secrets are created by the wallet and look like nostr+walletconnect://<pubkey>?relay=...&secret=.... (docs.nwc.dev)
    • If you use Alby: log into your Alby account → Wallet Configuration → “Link Your Own Wallet” → copy/paste the NWC Connection Secret the wallet provides. (Alby provides an NWC flow in its guides.) (guides.getalby.com)
    • General flows:
      • Mobile/web wallets often present a QR code or a deeplink; scan or open it to get the nostr+walletconnect://... string.
      • Some wallets let you “Copy connection secret” from a session or connection settings—copy the whole string without extra spaces. (nwc.dev)
  4. If you need the connection secret as a URL query parameter (remote MCP endpoint)

    • If your MCP endpoint requires the secret in a URL (e.g., https://mcp.getalby.com/mcp?nwc=ENCODED_NWC_URL), you must URL‑encode the secret first.
    • In a browser console run:
      • encodeURIComponent("nostr+walletconnect://...")
    • Copy the output (it will look like nostr%2Bwalletconnect%3A%2F%2F...) and paste it as the nwc= query value. (Do not add spaces or trim parts of the secret.)
  5. Save and restart the MCP connection

    • After saving the NWC_CONNECTION_STRING in FastMCP, apply/save the configuration and restart or re‑install the MCP server/extension so it picks up the new environment variable.
  6. Verify the connection

    • Use the MCP server’s inspect/test features (or your agent’s connection test) to confirm the wallet responds (the server can call get_info / show wallet methods). If using Alby’s hosted MCP you can also supply the same NWC secret as a Bearer token in Authorization headers: Authorization: Bearer nostr+walletconnect://.... (docs.nwc.dev)
  7. Security notes

    • Never paste the connection secret in public logs, screenshots, or chat.
    • Keep the FastMCP value secret/hidden and rotate/revoke the NWC connection from your wallet if it is ever exposed. (docs.nwc.dev)

If you want, tell me which wallet you plan to use (e.g., Alby extension, mobile Alby, or another NWC-enabled wallet) and I’ll give exact, wallet‑specific steps for copying the connection secret.

Quick Start

View on GitHub

More for Finance

View All →

More for Developer Tools

View All →

Similar MCP Servers

Alby Bitcoin Payments

Alby Bitcoin Payments

Official Remote Remote

Connects to Bitcoin Lightning wallets through Nostr Wallet Connect, enabling cryptocurrency payments, invoice management, balance checking, transaction history, fiat-to-sats conversion, and L402-protected resource access.

Finance Developer Tools

Report Issue

Thank you! Your issue report has been submitted successfully.