io.github.lightningfaucet/mcp-server
NPM · LIGHTNING-FAUCET-MCP · SCANNED AUG 3
Give AI agents a Bitcoin wallet with Lightning Network payments and L402 support.
Available components
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 & Transparency19
- Repository check failed: the declared repository URL redirects; it must resolve directly. See how to fix → View diagnostics → Fail
- 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 196 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability71
- AI-judged instruction clarity (good).Pass
- Tool/resource definitions use about 1763 tokens (~47/item across 37 items; 37 tools + 0 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
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
Unverified: 1 category
A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.
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-faucet-mcp
claude mcp add lightningfaucet-mcp-server -- npx -y lightning-faucet-mcp
codex mcp add lightningfaucet-mcp-server -- npx -y lightning-faucet-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"lightningfaucet-mcp-server": {
"type": "local",
"command": [
"npx",
"-y",
"lightning-faucet-mcp"
],
"enabled": true
}
}
} openclaw mcp add lightningfaucet-mcp-server --command npx --arg -y --arg lightning-faucet-mcp
mcp_servers:
lightningfaucet-mcp-server:
command: "npx"
args: ["-y", "lightning-faucet-mcp"] {
"mcpServers": {
"lightningfaucet-mcp-server": {
"command": "npx",
"args": [
"-y",
"lightning-faucet-mcp"
]
}
}
} 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.
- 2 Aug 26 +43
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- MCP protocol: unverified → pass ▲ functional
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- Schema quality: unverified → good ▲ functional
- Licence: MIT functional
- 31 Jul 26 −6
- 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 40
First indexed and scored.
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.
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.
check_balance ~26
Check your current Lightning balance in satoshis. Works with both operator and agent keys.
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.
| Name | Type | Req | Description |
|---|---|---|---|
| lnurl | string | yes | LNURL-withdraw string to claim from |
No output schema declared.
No examples provided.
create_agent ~58
Create a new agent under your operator account. Returns the agent API key.
| 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.
| 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.
deactivate_agent ~40
Deactivate an agent - it cannot make payments until reactivated. REQUIRES OPERATOR KEY.
| 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.
| 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.
| 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.
| Name | Type | Req | Description |
|---|---|---|---|
| webhook_id | integer | yes | ID of the webhook to delete |
No output schema declared.
No examples provided.
export_transactions ~65
Export transaction history in JSON or CSV format.
| Name | Type | Req | Description |
|---|---|---|---|
| end_date | string | — | ISO date for end of range |
| format | string | — | Export format |
| include_pending | boolean | — | Include pending transactions |
| start_date | string | — | ISO date for start of range |
No output schema declared.
No examples provided.
fund_agent ~47
Transfer sats from operator balance to an agent.
| 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_agent_analytics ~42
Get detailed spending analytics for an agent.
| Name | Type | Req | Description |
|---|---|---|---|
| agent_id | integer | — | Agent ID (defaults to current agent) |
| period | string | — | Time period |
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.
| 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.
| 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 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.
| Name | Type | Req | Description |
|---|---|---|---|
| payment_hash | string | yes | Payment hash of the invoice to check |
No output schema declared.
No examples provided.
get_rate_limits ~21
Get current rate limit status - requests remaining and reset time.
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.
| 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.
| 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 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 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.
| Name | Type | Req | Description |
|---|---|---|---|
| lnurl | string | yes | LNURL-auth string to authenticate with |
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.
| 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 ~113
Make a request to an L402-protected API. If payment is required (HTTP 402), automatically pay the Lightning invoice and complete the request. REQUIRES AGENT KEY - use set_agent_credentials first if operating as an operator.
| 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.
| 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.
| 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.
| Name | Type | Req | Description |
|---|---|---|---|
| recovery_code | string | yes | Recovery code from registration |
No output schema declared.
No examples provided.
register_operator ~44
Register a new operator account. Returns API key and recovery code. SAVE THESE - they cannot be retrieved later!
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | — | Name for the operator account (optional) |
No output schema declared.
No examples provided.
register_webhook ~58
Register a webhook URL to receive payment notifications. Max 5 webhooks per agent. REQUIRES AGENT KEY.
| 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.
| 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.
| 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.
| 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_operator_key ~43
Switch to a different operator API key for subsequent requests. Use after register_operator to start using the new credentials.
| 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.
| 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.
| 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.
| 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.
whoami ~32
Get current context - returns whether you are operating as an operator or agent, along with ID, name, and balance.
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.
| Name | Type | Req | Description |
|---|---|---|---|
| invoice | string | yes | BOLT11 invoice to pay out to |
No output schema declared.
No examples provided.