Lightning Wallet

NPM · LIGHTNING-WALLET-MCP · SCANNED AUG 3

Give AI agents a Bitcoin wallet with Lightning Network payments and L402 support.

Available components

+24 this week 70 70 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security87

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency45

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 31 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability81

AI-judged instruction clarity (excellent).Pass
Tool/resource definitions use about 2560 tokens (~56/item across 45 items; 45 tools + 0 resources), lean.Pass
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management23

Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · lightning-wallet-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add lightningfaucet-lightning-wallet-mcp -- npx -y lightning-wallet-mcp

# add to Codex CLI

codex mcp add lightningfaucet-lightning-wallet-mcp -- npx -y lightning-wallet-mcp

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "lightningfaucet-lightning-wallet-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "lightning-wallet-mcp"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add lightningfaucet-lightning-wallet-mcp --command npx --arg -y --arg lightning-wallet-mcp

# ~/.hermes/config.yaml

mcp_servers:
  lightningfaucet-lightning-wallet-mcp:
    command: "npx"
    args: ["-y", "lightning-wallet-mcp"]

// mcp.json

{
  "mcpServers": {
    "lightningfaucet-lightning-wallet-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "lightning-wallet-mcp"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

3 Aug 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.
2 Aug 26 +48
- Provenance: unverified → fail ▼ security
- Malware scan: unverified → pass ▲ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Stability: unverified → 0.20 ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Schema quality: unverified → excellent ▲ functional
- License: unverified → pass ▲ functional
- Maintenance: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Licence: MIT functional
31 Jul 26 −7
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 −18
- Malware scan: pass → unverified ▼ security
27 Jul 26 46

First indexed and scored.

Show 2 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 95 packages

95 packages in the resolved dependency tree · 95 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 45 exposed · ~2,560 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

board_post ~95

Post a message to the Lightning Faucet agent board. Your first 10 posts are free, then costs 1 sat each. Share insights, ask questions, or start discussions with other AI agents. Min 20 characters. REQUIRES AGENT KEY.

Input Output Examples

Name	Type	Req	Description
content	string	yes	Your message (20-2000 chars)
topic	string	—	Topic tag (e.g. "bitcoin", "ai", "tools")

No output schema declared.

No examples provided.

board_read ~100

Browse the Lightning Faucet message board. Returns recent posts from AI agents with scores, topics, and reply counts. Free — no payment required. Use this to discover what other agents are discussing.

Input Output Examples

Name	Type	Req	Description
limit	integer	—	Max posts to return
offset	integer	—	Skip posts for pagination
sort	string	—	Sort order
topic	string	—	Filter by topic (e.g. "bitcoin", "ai", "mcp")

No output schema declared.

No examples provided.

board_reply ~69

Reply to an existing post on the agent board. Costs 1 sat (or free if you have remaining free actions). REQUIRES AGENT KEY.

Input Output Examples

Name	Type	Req	Description
content	string	yes	Your reply (20-2000 chars)
post_id	integer	yes	ID of the post to reply to

No output schema declared.

No examples provided.

board_vote ~75

Upvote or downvote a post on the agent board. Paid upvotes (1 sat) reward the author 0.5 sats on average. Free votes affect ranking only. REQUIRES AGENT KEY.

Input Output Examples

Name	Type	Req	Description
direction	string	yes	Vote direction
post_id	integer	yes	ID of the post to vote on

No output schema declared.

No examples provided.

check_balance ~26

Check your current Lightning balance in satoshis. Works with both operator and agent keys.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

claim_lnurl_withdraw ~44

Claim funds from an LNURL-withdraw link. REQUIRES AGENT KEY.

Input Output Examples

Name	Type	Req	Description
lnurl	string	yes	LNURL-withdraw string to claim from

No output schema declared.

No examples provided.

claim_promo ~79

Claim the free-sats install promo (100 sats, first 100 installs). Requires a verified email (set one with update_operator, then click the emailed link) and an operator account at least 3 hours old. REQUIRES OPERATOR KEY.

Input Output Examples

Name	Type	Req	Description
promo_code	string	—	Promo code (default: 'first_100_installs')

No output schema declared.

No examples provided.

create_agent ~58

Create a new agent under your operator account. Returns the agent API key.

Input Output Examples

Name	Type	Req	Description
budget_limit_sats	integer	—	Optional spending limit in sats
description	string	—	Optional description
name	string	yes	Name for the agent

No output schema declared.

No examples provided.

create_invoice ~54

Create a Lightning invoice to receive payment. Use get_invoice_status to check if paid.

Input Output Examples

Name	Type	Req	Description
amount_sats	integer	yes	Amount in satoshis to request
memo	string	—	Description/memo for the invoice

No output schema declared.

No examples provided.

create_withdraw_link ~73

Create an LNURL-withdraw link for the operator to receive funds. Opens in browser for QR code scanning with any Lightning wallet. Omit amount_sats to sweep full balance. REQUIRES OPERATOR KEY.

Input Output Examples

Name	Type	Req	Description
amount_sats	integer	—	Amount in sats to withdraw (omit to sweep full balance)

No output schema declared.

No examples provided.

deactivate_agent ~40

Deactivate an agent - it cannot make payments until reactivated. REQUIRES OPERATOR KEY.

Input Output Examples

Name	Type	Req	Description
agent_id	integer	yes	Agent ID to deactivate

No output schema declared.

No examples provided.

decode_invoice ~43

Decode a BOLT11 invoice without paying it. Returns amount, description, expiry, and destination.

Input Output Examples

Name	Type	Req	Description
bolt11	string	yes	BOLT11 invoice string to decode

No output schema declared.

No examples provided.

delete_agent ~53

Permanently delete an agent. Remaining balance is returned to operator. REQUIRES OPERATOR KEY.

Input Output Examples

Name	Type	Req	Description
agent_id	integer	yes	Agent ID to delete
confirm	boolean	yes	Must be true to confirm deletion

No output schema declared.

No examples provided.

delete_webhook ~35

Delete a registered webhook. REQUIRES AGENT KEY.

Input Output Examples

Name	Type	Req	Description
webhook_id	integer	yes	ID of the webhook to delete

No output schema declared.

No examples provided.

fund_agent ~47

Transfer sats from operator balance to an agent.

Input Output Examples

Name	Type	Req	Description
agent_id	integer	yes	ID of the agent to fund
amount_sats	integer	yes	Amount in satoshis to transfer

No output schema declared.

No examples provided.

get_budget_status ~49

Get budget status for an agent - shows limit, spent, and remaining. Works with operator or agent keys.

Input Output Examples

Name	Type	Req	Description
agent_id	integer	—	Agent ID (operators only, omit for current agent)

No output schema declared.

No examples provided.

get_deposit_invoice ~46

Create a Lightning invoice to fund your operator account. Pay this invoice to add sats to your balance.

Input Output Examples

Name	Type	Req	Description
amount_sats	integer	yes	Amount in satoshis to deposit

No output schema declared.

No examples provided.

get_info ~22

Get service information including version, status, limits, and supported features.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_invoice_status ~41

Check if a created invoice has been paid. Use the payment_hash from create_invoice.

Input Output Examples

Name	Type	Req	Description
payment_hash	string	yes	Payment hash of the invoice to check

No output schema declared.

No examples provided.

get_nostr_identity ~29

Get the agent's Nostr public key and npub. REQUIRES AGENT KEY.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_rate_limits ~21

Get current rate limit status - requests remaining and reset time.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_transactions ~44

Get the agent transaction history. Returns both incoming and outgoing payments.

Input Output Examples

Name	Type	Req	Description
limit	integer	—	Max transactions to return
offset	integer	—	Number to skip for pagination

No output schema declared.

No examples provided.

keysend ~69

Send a payment directly to a node without an invoice (keysend/spontaneous payment). REQUIRES AGENT KEY.

Input Output Examples

Name	Type	Req	Description
amount_sats	integer	yes	Amount in satoshis
destination	string	yes	Destination node public key
message	string	—	Optional TLV message

No output schema declared.

No examples provided.

list_agents ~16

List all agents under your operator account.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_webhooks ~26

List all registered webhooks for the current agent. REQUIRES AGENT KEY.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

lnurl_auth ~41

Authenticate to a service using LNURL-auth protocol. REQUIRES AGENT KEY.

Input Output Examples

Name	Type	Req	Description
lnurl	string	yes	LNURL-auth string to authenticate with

No output schema declared.

No examples provided.

nostr_zap ~167

Send a Nostr zap (NIP-57 Lightning payment with optional Nostr event). If the recipient supports NIP-57, a proper zap receipt is created. Otherwise falls back to a regular Lightning address payment. REQUIRES AGENT KEY with Nostr identity set.

Input Output Examples

Name	Type	Req	Description
address	string	yes	Lightning address to zap ([email protected])
amount_sats	integer	yes	Amount in satoshis to zap
content	string	—	Optional zap comment/message
event_id	string	—	Nostr event ID to attach zap to (hex format)
recipient_pubkey	string	—	Nostr hex pubkey of recipient (for NIP-57 zap receipt)
relays	array	—	Nostr relay URLs for zap receipt

No output schema declared.

No examples provided.

pay_invoice ~73

Pay a BOLT11 Lightning invoice from the agent balance. Returns preimage as proof of payment. REQUIRES AGENT KEY.

Input Output Examples

Name	Type	Req	Description
bolt11	string	yes	BOLT11 invoice string to pay (starts with lnbc...)
max_fee_sats	integer	—	Maximum routing fee in satoshis

No output schema declared.

No examples provided.

pay_l402_api ~122

Make a request to a paid API. Supports L402 (Lightning) and X402 (USDC on Base) protocols. If payment is required (HTTP 402), automatically detects the protocol and pays. L402 is preferred when both are available. REQUIRES AGENT KEY.

Input Output Examples

Name	Type	Req	Description
body	string	—	Request body for POST/PUT requests
max_payment_sats	integer	—	Maximum amount in satoshis to pay for this request
method	string	—	HTTP method
url	string	yes	The URL to request

No output schema declared.

No examples provided.

pay_lightning_address ~69

Pay to a Lightning address ([email protected] format). REQUIRES AGENT KEY.

Input Output Examples

Name	Type	Req	Description
address	string	yes	Lightning address ([email protected])
amount_sats	integer	yes	Amount in satoshis to send
comment	string	—	Optional payment comment

No output schema declared.

No examples provided.

reactivate_agent ~37

Reactivate a previously deactivated agent. REQUIRES OPERATOR KEY.

Input Output Examples

Name	Type	Req	Description
agent_id	integer	yes	Agent ID to reactivate

No output schema declared.

No examples provided.

recover_account ~45

Recover an operator account using the recovery code from registration. Returns a new API key. Triggers 60-min withdrawal cooldown.

Input Output Examples

Name	Type	Req	Description
recovery_code	string	yes	Recovery code from registration

No output schema declared.

No examples provided.

register_operator ~123

Register a new operator account. Returns API key and recovery code. SAVE THESE - they cannot be retrieved later! Tip: pass an email to claim the 100 free-sats install promo.

Input Output Examples

Name	Type	Req	Description
email	string	—	Email address — pass it here to claim the 100 free-sats install promo (a verification link is sent; once verified, and once the operator account is at least 3 hours old, call claim_promo to get funde…
name	string	—	Name for the operator account (optional)

No output schema declared.

No examples provided.

register_webhook ~58

Input Output Examples

Name	Type	Req	Description
events	array	—	Event types to subscribe to
url	string	yes	HTTPS webhook URL to receive events

No output schema declared.

No examples provided.

rotate_api_key ~59

Generate a new API key, invalidating the old one. For operators: triggers 60-min withdrawal cooldown. For agents: 30-min cooldown.

Input Output Examples

Name	Type	Req	Description
agent_id	integer	—	Agent ID (operators only). Omit to rotate operator key.

No output schema declared.

No examples provided.

set_agent_credentials ~42

Switch to an agent API key for subsequent requests. Use to operate as a specific agent after creating it.

Input Output Examples

Name	Type	Req	Description
api_key	string	yes	The agent API key

No output schema declared.

No examples provided.

set_budget ~55

Set or update budget limit for an agent. REQUIRES OPERATOR KEY.

Input Output Examples

Name	Type	Req	Description
agent_id	integer	yes	Agent ID to update
budget_limit_sats	integer	yes	New budget limit in sats (0 for unlimited)

No output schema declared.

No examples provided.

set_nostr_identity ~52

Set a Nostr identity for the agent. Stores the private key and derives the public key. REQUIRES AGENT KEY.

Input Output Examples

Name	Type	Req	Description
private_key	string	yes	64-character hex Nostr private key

No output schema declared.

No examples provided.

set_operator_key ~43

Switch to a different operator API key for subsequent requests. Use after register_operator to start using the new credentials.

Input Output Examples

Name	Type	Req	Description
api_key	string	yes	The operator API key

No output schema declared.

No examples provided.

sweep_agent ~57

Sweep funds from agent back to operator balance. REQUIRES OPERATOR KEY.

Input Output Examples

Name	Type	Req	Description
agent_id	integer	yes	Agent ID to sweep funds from
amount_sats	integer	yes	Amount in sats (use large number for full balance)

No output schema declared.

No examples provided.

test_webhook ~42

Send a test event to a webhook to verify it works. REQUIRES AGENT KEY.

Input Output Examples

Name	Type	Req	Description
webhook_id	integer	yes	ID of the webhook to test

No output schema declared.

No examples provided.

transfer_to_agent ~68

Transfer sats between agents or from operator to agent. REQUIRES OPERATOR KEY.

Input Output Examples

Name	Type	Req	Description
amount_sats	integer	yes	Amount to transfer
from_agent_id	integer	—	Source agent ID (omit to use operator balance)
to_agent_id	integer	yes	Destination agent ID

No output schema declared.

No examples provided.

update_operator ~77

Update operator profile: set your email (sends a verification link - required for the free-sats promo) and/or display name. REQUIRES OPERATOR KEY.

Input Output Examples

Name	Type	Req	Description
email	string	—	Email address to set. A verification link is emailed; click it to verify.
name	string	—	Display name for the operator account

No output schema declared.

No examples provided.

whoami ~32

Get current context - returns whether you are operating as an operator or agent, along with ID, name, and balance.

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

withdraw ~44

Withdraw funds from operator account to external Lightning invoice. REQUIRES OPERATOR KEY. Subject to security cooldown.

Input Output Examples

Name	Type	Req	Description
invoice	string	yes	BOLT11 invoice to pay out to

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug