NWC MCP Server

🚀 NWC MCP Server

Connect your Bitcoin Lightning wallet to your Large Language Model (LLM) via Nostr Wallet Connect (NWC or NIP-47).

This MCP server utilizes the official TypeScript SDK.

🚀 Quick Start

Add to Claude Desktop

Add the following content to your claude_desktop_config.json:

{
  "mcpServers": {
    "nwc": {
      "command": "npx",
      "args": ["-y", "@getalby/nwc-mcp-server"],
      "env": {
        "NWC_CONNECTION_STRING": "YOUR NWC CONNECTION STRING HERE"
      }
    }
  }
}

Add to Goose

1. Enter goose configure
2. Add Extension -> Command Line Extension
3. Name it nwc
4. Command to run: npx -y @getalby/nwc-mcp-server
5. Timeout setting: 30
6. Description: Not required
7. Environment variables: Yes
8. Environment variable name: NWC_CONNECTION_STRING
9. Environment variable value: nostr+walletconnect://... (Your NWC connection key here)

Add to Cline

Copy and paste the following into a Cline prompt. It should prompt you to update the connection string.

Add the following to my MCP server list:

"nwc": {
  "command": "npx",
  "args": ["-y", "@getalby/nwc-mcp-server"],
  "env": {
    "NWC_CONNECTION_STRING": "nostr+walletconnect://..."
  },
  "disabled": false,
  "autoApprove": []
}

Add to N8N (Community Node)

Currently, this MCP server can only be used via the command line (STDIO).

You can install the n8n-nodes-mcp community node and run n8n with tool usage permissions:

N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true npx n8n

Create a blank workflow and add an AI Agent node. Configure your LLM model and add a new "MCP Client" to the tools (a cube next to it indicates it's a community node).

Configure the MCP Client by adding a credential selected from the command line (STDIO).
Command: npx
Arguments: -y @getalby/nwc-mcp-server
Environment variable: NWC_CONNECTION_STRING=nostr+walletconnect://your_key_here (Create the entire line in a text editor and paste it, as the password field cannot be switched to plain text)

Check out the N8N Free Chat Workflow for a complete example.

📦 Installation from Source Code

Prerequisites

• Node.js 20+
• Yarn
• Connection string for a Lightning wallet supporting NWC

Installation

yarn install

Build

yarn build

Add Your NWC Connection

Copy .env.example to .env and update your connection string.

Check Tools (Use/Test without LLM)

yarn inspect

Supported Tools

Check the tools directory