プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。レビューとアカウント機能は今後のステップで始まります。
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Nwc MCP

作者:llmops-proバージョン 0.2.3i★ –iパソコンで動く
レジストリ名io.github.llmops-pro/nwc-mcp

インストール

概要

作者による説明(英語の原文)

Lightning wallet for AI agents via Nostr Wallet Connect (NIP-47): budget caps, confirm, audit log.

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

  • 接続方法: パソコンで動く
  • トランスポート: stdio
  • カテゴリ: その他
  • 入力が必要なもの:NWC_CONNECTION_STRING

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

  • 基本チェック:1項目中1項目に合格
  • あなたのパソコンで、あなたのユーザーと同じ権限(ファイル、ネットワーク、アプリ)で動きます。
  • 自分で入力するもの: NWC_CONNECTION_STRING, NWC_DAILY_BUDGET_SATS, NWC_READ_ONLY

「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。

必要なもの

  • npmNode.jsのインストール(npxコマンドに必要)

どのアプリを使っていますか?

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

{
  "mcpServers": {
    "nwc": {
      "command": "npx",
      "args": [
        "-y",
        "nwc-mcp"
      ],
      "env": {
        "NWC_CONNECTION_STRING": "your-value",
        "NWC_DAILY_BUDGET_SATS": "your-value",
        "NWC_READ_ONLY": "your-value"
      }
    }
  }
}

ターミナルでこれを実行します

claude mcp add nwc --env NWC_CONNECTION_STRING=your-value --env NWC_DAILY_BUDGET_SATS=your-value --env NWC_READ_ONLY=your-value -- npx -y nwc-mcp

動かす前に、空欄の値を入力してください。

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

{
  "mcpServers": {
    "nwc": {
      "command": "npx",
      "args": [
        "-y",
        "nwc-mcp"
      ],
      "env": {
        "NWC_CONNECTION_STRING": "your-value",
        "NWC_DAILY_BUDGET_SATS": "your-value",
        "NWC_READ_ONLY": "your-value"
      }
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "nwc": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "nwc-mcp"
      ],
      "env": {
        "NWC_CONNECTION_STRING": "your-value",
        "NWC_DAILY_BUDGET_SATS": "your-value",
        "NWC_READ_ONLY": "your-value"
      }
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

自分で入力する値

  • NWC_CONNECTION_STRING 秘密 必須 env
    Nostr Wallet Connect connection string (nostr+walletconnect://...)
  • NWC_DAILY_BUDGET_SATS env
    Daily spend cap in sats
  • NWC_READ_ONLY env
    Set true to block all spend tools

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月7日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント llmops-pro で確認済みです

  • … 未チェック

    今もメンテナンスされている

    このリポジトリはまだGitHubから読み取っていません

  • … 未チェック

    ライセンスがある

    このリポジトリはまだGitHubから読み取っていません

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

その他のほかのサーバーとの比較i

  • このカテゴリのほかの32684件のうち0%よりスターが多い
  • このカテゴリのほかの32684件のうち12%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの32684件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Nwc MCPは安全ですか?

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:NWC_CONNECTION_STRING

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は–、最新バージョン(0.2.3)がレジストリに届いたのは5 か月前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは?

同じカテゴリには:Spec Driven Development, Remote Desktop Commander, Master CSS

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方:★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Remote Desktop Commander

作者:desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

クラウドで動く★ 211一昨日更新
インストール

Master CSS

作者:master-co

Inspect Master CSS classes, generated CSS, and project stylesheets from your AI client.

パソコンで動く今日更新
インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

nwc-mcp

A Lightning wallet for your LLM agent. MCP server that exposes Nostr Wallet Connect (NIP-47) wallet operations as tools your agent can call — read balance, generate invoices, pay invoices, pay Lightning Addresses, pay LNURLs, batch payments, keysend — all wrapped in a defense-in-depth safety stack.

Drop it into Claude Desktop, Claude Code, Cursor, or any MCP-speaking client. Hand the agent a sub-wallet (not your main one). Set a daily cap. Let it spend sats on your behalf within rails you control.

v0.2 — all spend tools shipped. Twelve tools (7 read/receive + 5 spend + 1 confirm), four safety gates, full audit log. Validated end-to-end against Alby Hub + Olympus by ZEUS routing — real outbound payment settled in 8 seconds.


What you can do with this

  • A coding agent that pays for its own paywalled tool calls (L402-style paid MCP servers).
  • A NOSTR bot that zaps interesting notes under a daily cap you set.
  • An evaluation harness that pays a small fee per task to a worker agent it consumes.
  • A storefront agent that issues receive invoices in response to incoming DMs.
  • Personal sats-aware agents — "every Friday, send 1,000 sats to my favorite OSS maintainers via their LN addresses."

The safety stack is the load-bearing reason this is usable in production: the agent can request a payment, but the *server* refuses anything that breaches your configured limits, demands a second-step confirmation if you set one, and writes every call to a structured audit log.


The twelve tools

Read-only (always enabled, no spend risk)
ToolPurpose
nwc_get_infoWallet capabilities, supported NIP-47 methods, node pubkey, network, alias. Call first.
nwc_get_balanceSpendable balance in sats (and msat).
nwc_lookup_invoiceLook up an invoice by payment hash or bolt11; returns state + preimage if settled.
nwc_list_transactionsList transactions with filters (time range, direction, unpaid).
nwc_decode_invoiceParse a bolt11 locally — amount, memo, expiry, payee pubkey. No network call.
nwc_budget_statusCurrent spend budget state — daily spent, caps, lifetime spent.
Receive (safe — only generates invoices, no spend)
ToolPurpose
nwc_make_invoiceCreate a bolt11 invoice for a given amount of sats.
Spend (gated by the safety pipeline)
ToolPurpose
nwc_pay_invoicePay a bolt11. Amount-resolution for amountless invoices via amount_override_sats.
nwc_pay_lightning_addressPay name@domain.tld (LUD-16). Direct LNURL-pay resolution, non-proxied by default.
nwc_pay_lnurlPay a raw lnurl1... bech32 string (LUD-01).
nwc_multi_pay_invoicePay up to 20 invoices in one call. Sum is checked against the budget cap atomically.
nwc_pay_keysendSpontaneous payment direct to a pubkey. Default-off — opt in via NWC_KEYSEND_ENABLED=true.
nwc_confirm_paymentExecute a two-step-confirm payment by consuming its one-time token.

Requirements

  • Node 20+
  • A NWC connection string from a NIP-47-compatible wallet (Alby Hub, Mutiny, Coinos, Phoenix, …)

The canonical buyer setup is Alby Hub PRO with a dedicated sub-wallet for the agent — that's what this server has been smoke-tested against. But the protocol is wallet-agnostic; anything that speaks NIP-47 works.

Install

# From npm (once published)

npx -y nwc-mcp

From source

git clone cd nwc-mcp corepack enable pnpm pnpm install pnpm build

Configure

Copy .env.example to .env and fill in your NWC connection string:

cp .env.example .env

edit .env: NWC_CONNECTION_STRING=nostr+walletconnect://...

The server auto-loads .env from the current working directory and from the project root (one level up from dist/). Env vars passed by the parent process (e.g., claude mcp add --env ...) take precedence over .env. .env is gitignored — keep your NWC string out of any committed file.

Required
VarPurpose
NWC_CONNECTION_STRINGnostr+walletconnect://... — get this from your wallet (in Alby Hub: Sub-wallets → Connections). Treat as a secret — anyone holding it can spend up to the daily cap.
NWC_DAILY_BUDGET_SATSRolling 24h spend cap. Server refuses to start without this set.
Optional safety knobs
VarDefaultPurpose
NWC_TOTAL_BUDGET_SATSunsetLifetime spend cap.
NWC_MAX_INVOICE_SATSunsetPer-payment cap.
NWC_READ_ONLYfalseIf true, disables all spend tools — useful for dev / eval / curious mode.
NWC_REQUIRE_CONFIRMfalseIf true, spend tools return a one-time token; payment only executes after nwc_confirm_payment with the token. Trades agent autonomy for safety.
NWC_KEYSEND_ENABLEDfalseOpt-in toggle for nwc_pay_keysend. Off because keysend is power-user (no payment hash, weaker safety surface than bolt11).
NWC_ALLOWED_DESTINATIONSunsetComma-separated allowlist of LN addresses / pubkeys / LNURLs. If set, ONLY those can be paid.
NWC_LOG_PATH./nwc-mcp.logPath to the structured audit log file.
NWC_BUDGET_STATE_PATH./nwc-mcp-state.jsonPath to the persisted budget tracker state.

Wire into an MCP client

Claude Code (project-scoped, recommended)

From this directory:

claude mcp add nwc -s project node "$(pwd)/dist/index.js"

This writes a .mcp.json in the project root. Project-scoped servers load only when Claude Code starts from this directory tree. Use /mcp inside a session to inspect what's loaded. Restart the CLI to pick up a fresh dist/index.js after a rebuild.

Switch -s project to -s user if you want the server available everywhere.

Claude Desktop / Cursor / other clients

See examples/claude-desktop-config.json for the manifest snippet. Copy it into your client's config, replace the path placeholder. Because the server loads .env itself, you don't need to pass NWC_* vars through the client config — leave the env block empty.


Safety model

This server is designed for use by autonomous LLM agents that hold the keys to spend real sats. The defense in depth runs in this order on every spend tool call:

  1. `NWC_READ_ONLY` gate — if set, blocks at the first gate. No decode, no network, audit log entry only.
  2. Invoice decode + amount resolution — for bolt11-based tools. Rejects ambiguity (amount-override conflicting with embedded amount).
  3. Allowlist check — if NWC_ALLOWED_DESTINATIONS is set, the payee (pubkey for bolt11, LN address for LUD-16, LNURL string for LUD-01, pubkey for keysend) must match. Empty allowlist = no-op.
  4. Budget check — daily rolling cap + optional total cap + optional per-invoice cap. State is persisted to NWC_BUDGET_STATE_PATH.
  5. Two-step confirmation gate — if NWC_REQUIRE_CONFIRM=true, returns a 16-byte hex token with 5-minute TTL instead of executing. Agent must call nwc_confirm_payment with the token. Safety re-runs on consume.
  6. Execute — calls the wallet via NIP-47. On success: budget records principal + (over-rounded) fees.
  7. Audit log — every attempt (success, blocked, error) is appended as one structured JSON line per call.

The floor is your NWC connection's own daily cap, set in your wallet. This server's checks are belt-and-suspenders on top — if you trust nothing about the server, the wallet still won't spend past its connection-level cap.

Verifying calls actually went through

Independent of what the LLM tells you, tail the audit log:

tail -n 5 nwc-mcp.log

Successful call: {"ts":"...","tool":"nwc_pay_invoice","outcome":"ok","result":{"paid_sats":50,...}}. Blocked: {"ts":"...","tool":"nwc_pay_invoice","outcome":"blocked","blocked_reason":"..."}. The audit log is append-only by intent; rotate it as part of your operational hygiene.


Testing

pnpm typecheck   # tsc --noEmit

pnpm test # 25 vitest cases covering Allowlist, ConfirmStore, evaluateSafety, decodeLnurl pnpm build # produces dist/index.js (~47 KB ESM bundle)

evaluateSafety is a pure function that the unit tests exercise across the full safety matrix (read-only / amount-conflict / allowlist / budget / confirm) without touching a real wallet.

For end-to-end smoke testing against a live wallet, see paywall-mcp-test/ in the parent project — a throwaway second MCP server that exposes one paid tool (premium_compliment) and validates the full agent → invoice → pay → redeem loop.


License

MIT — see LICENSE.

Contact / Issues

Built by LLMOps.Pro.

  • NOSTR: npub1hdg932jvwc3jdvkqywgqv0ue4nn60exrf92asy8mtazt3hjg7d2s2yw0nw — follow, DM, zap.
  • Lightning Address: sovereigncitizens@getalby.com — for support zaps and "this was useful" tips.
  • Bug reports / feature requests: open a GitHub issue (https://github.com/llmops-pro/nwc-mcp).
  • Security issues: please disclose privately via NOSTR DM before opening a public issue.
PopNxに聞く