NWC

You can connect a bitcoin lightning wallet to your language model workflow using Nostr Wallet Connect (NWC) through an MCP server. This setup enables secure, wallet-based authentication and streamlined tool access for chat agents and automations.

How to use

Connect to an MCP server to expose tools from your LLM environment. You can use a hosted MCP endpoint via SSE or HTTP Streamable transports, or run a local MCP server that connects to your NWC wallet. When using hosted endpoints, you provide your NWC connection secret as a Bearer token to authenticate requests.

How to install

Prerequisites you need before installing this MCP server are: Node.js 20 or newer and Yarn. You also need a NWC connection string (your NWC wallet connection secret). Install and run steps are below.

# 1) Install dependencies
yarn install

# 2) Build the MCP server (TypeScript project)
yarn build

# 3) Prepare environment with your NWC connection string (example)
# Copy .env.example to .env and set NWC_CONNECTION_STRING
cp .env.example .env

Configuration and usage notes

You have two primary ways to connect: a hosted HTTP endpoint or a local STDIO server. The hosted HTTP endpoint is available at the Alby MCP server address, while the local server runs on your machine with an explicit command. Use the Bearer token derived from your NWC connection secret for authorization.

Additional setup options

Add the hosted HTTP endpoint to your MCP client with the following URL and no extra arguments. You can also run a local instance using the provided STDIO command, which requires your NWC connection string.