Lightning Enable MCP Server
OCI · DOCKER.IO/REFINEDELEMENT/LIGHTNING-ENABLE-MCP:1.21.0 · 3 COMPONENTS · SCANNED AUG 3
AI agent Lightning payments: invoices, wallets, L402 access, API discovery, budgets, and commerce.
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 Security0
- Malware scan not yet available for this package.Unverified
- CVE data not yet available for this package.Unverified
- Install-script risk not yet assessed.Unverified
- Dependency-health data not yet available.Unverified
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 0 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability74
- AI-judged instruction clarity (good).Pass
- Context-footprint check failed: tool/resource definitions use about 2725 tokens (~104/item across 26 items; 26 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- 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: 2 categories
Categories scored 0 because we could not verify them: 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.
oci · docker.io/refinedelement/lightning-enable-mcp:1.21.0
claude mcp add refined-element-lightning-enable-mcp -- docker run --rm -i docker.io/refinedelement/lightning-enable-mcp:1.21.0
codex mcp add refined-element-lightning-enable-mcp -- docker run --rm -i docker.io/refinedelement/lightning-enable-mcp:1.21.0
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"refined-element-lightning-enable-mcp": {
"type": "local",
"command": [
"docker",
"run",
"--rm",
"-i",
"docker.io/refinedelement/lightning-enable-mcp:1.21.0"
],
"enabled": true
}
}
} mcp_servers:
refined-element-lightning-enable-mcp:
command: "docker"
args: ["run", "--rm", "-i", "docker.io/refinedelement/lightning-enable-mcp:1.21.0"] {
"mcpServers": {
"refined-element-lightning-enable-mcp": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"docker.io/refinedelement/lightning-enable-mcp:1.21.0"
]
}
}
} 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 39
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 oci/docker.io/refinedelement/lightning-enable-mcp:1.21.0
Provenance none
Ecosystem: oci · Outcome: none
Reason: no_attestation
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.
access_l402_resource ~167
Fetch a URL with automatic L402 payment handling. If the server returns a 402 Payment Required response, the invoice will be automatically paid and the request retried.
| Name | Type | Req | Description |
|---|---|---|---|
| body | string | — | Optional request body for POST/PUT requests |
| confirmation_nonce | string | — | Confirmation code the human operator read from the server console, for payments above the auto-approve threshold. The code is NEVER in a tool result — ask the human for it. Omit on the first call to… |
| headers | object | — | Optional additional request headers |
| max_sats | integer | — | Maximum satoshis to pay for this request |
| method | string | — | HTTP method (GET, POST, PUT, DELETE) |
| url | string | yes | The URL to fetch |
No output schema declared.
No examples provided.
check_invoice_status ~41
Check if a Lightning invoice has been paid. Use the invoice ID from create_invoice.
| Name | Type | Req | Description |
|---|---|---|---|
| invoice_id | string | yes | The invoice ID returned from create_invoice |
No output schema declared.
No examples provided.
check_wallet_balance ~19
Check the connected Lightning wallet balance via NWC.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
configure_budget ~47
Set spending limits for the session.
| Name | Type | Req | Description |
|---|---|---|---|
| per_request | integer | — | Maximum satoshis per individual request |
| per_session | integer | — | Maximum total satoshis for the entire session |
No output schema declared.
No examples provided.
confirm_payment ~53
Confirm a pending payment using the nonce code from a previous payment request. Call this after a payment tool returns requiresConfirmation=true with a nonce.
| Name | Type | Req | Description |
|---|---|---|---|
| nonce | string | yes | The 6-character confirmation code from the payment request |
No output schema declared.
No examples provided.
create_invoice ~82
Create a Lightning invoice to receive a payment. Returns a BOLT11 invoice string to share with the payer.
| Name | Type | Req | Description |
|---|---|---|---|
| amount_sats | integer | yes | Amount to receive in satoshis |
| expiry_secs | integer | — | Invoice expiry time in seconds. Defaults to 3600 (1 hour) |
| memo | string | — | Optional description/memo for the invoice |
No output schema declared.
No examples provided.
create_l402_challenge ~126
Create an L402 payment challenge to charge another agent or user for accessing a resource. Returns a Lightning invoice and macaroon. The payer must pay the invoice and present the L402 token (macaroon:preimage) back to you for verification. Requires LIGHTNING_ENABLE_API_KEY with an Agentic Commerce subscription.
| Name | Type | Req | Description |
|---|---|---|---|
| description | string | — | Description shown on the Lightning invoice |
| price_sats | integer | yes | Price in satoshis to charge |
| resource | string | yes | Resource identifier - URL, service name, or description of what you're charging for |
No output schema declared.
No examples provided.
create_lightning_enable_account ~191
Self-bootstrapping signup: activate a Lightning Enable account with a tiny Lightning payment (~100 sats) and get back a merchant API key. Requires NO Lightning Enable API key (it CREATES one) — only a connected wallet. On success the API key is saved to ~/.lightning-enable/config.json so the producer/ASA tools unlock. Above-threshold fees require an out-of-band confirmation code (as with pay_l402_challenge).
| Name | Type | Req | Description |
|---|---|---|---|
| confirmation_nonce | string | — | Confirmation code the human operator read from the server console, for an above-threshold activation fee. The code is NEVER in a tool result — ask the human for it. Omit on the first call to request… |
| string | yes | Email address to register the Lightning Enable account under. | |
| max_sats | integer | — | Maximum satoshis to pay for activation. The fee is ~100 sats. |
No output schema declared.
No examples provided.
discover_agent_services ~106
Discover agent services on the Nostr network. Search by category, hashtag, or keyword. Returns capabilities published as kind 38400 events. Use this to find agents that offer services you can pay for via L402.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | — | Filter by service category (e.g., 'ai', 'data', 'translation') |
| hashtags | array | — | Filter by hashtags |
| limit | integer | — | Maximum results to return |
| query | string | — | Search query |
No output schema declared.
No examples provided.
discover_api ~181
Discover L402-enabled APIs. Use 'query' to search the registry for available APIs by keyword, or use 'url' to fetch a specific API's manifest with full endpoint details and pricing. Use 'category' to browse by category. With budget_aware=true, shows how many calls you can afford.
| Name | Type | Req | Description |
|---|---|---|---|
| budget_aware | boolean | — | If true, annotate endpoints with affordable call counts based on remaining budget. Default: true. |
| category | string | — | Filter registry results by category (e.g., 'ai', 'data', 'finance'). |
| query | string | — | Search the L402 API registry by keyword (e.g., 'weather', 'ai', 'geocoding'). |
| url | string | — | Base URL of the L402-enabled API, or direct URL to the manifest JSON file. If omitted, searches the registry instead. |
No output schema declared.
No examples provided.
exchange_currency ~92
Exchange currency within your wallet (USD to BTC or BTC to USD). Currently only available with Strike wallet.
| Name | Type | Req | Description |
|---|---|---|---|
| amount | number | yes | Amount in source currency (e.g., 100 for $100 or 0.001 for 0.001 BTC) |
| source_currency | string | yes | Currency to convert from: USD or BTC |
| target_currency | string | yes | Currency to convert to: BTC or USD |
No output schema declared.
No examples provided.
get_agent_reputation ~71
Get an agent's reputation score and reviews. Queries kind 38403 attestation events for the given pubkey. Returns average rating and individual reviews.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | — | Maximum number of attestations to return |
| pubkey | string | yes | Pubkey of the agent to query reputation for |
No output schema declared.
No examples provided.
get_all_balances ~34
Get all currency balances from your wallet (USD, BTC, etc.). Most useful with Strike wallet which supports multiple currencies.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
get_btc_price ~24
Get the current Bitcoin price in USD. Only available with Strike wallet.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
get_budget_status ~31
View current budget status and spending limits (read-only). Edit ~/.lightning-enable/config.json to change limits.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
get_payment_history ~45
List recent L402 payments made during this session.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | — | Maximum number of payments to return |
| since | string | — | ISO timestamp to filter payments from |
No output schema declared.
No examples provided.
get_receipts ~90
Read the durable, append-only payment receipt log (~/.lightning-enable/receipts.jsonl). Unlike get_payment_history (in-memory, this session only), receipts persist across sessions and include the spend policy and how to revoke the wallet. Use to review what an agent has spent and how to pull the plug.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | — | Maximum number of recent receipts to return (1-200) |
No output schema declared.
No examples provided.
pay_invoice ~128
Pay a Lightning invoice directly and get the preimage as proof of payment. Use this to pay any BOLT11 Lightning invoice without L402 protocol overhead.
| Name | Type | Req | Description |
|---|---|---|---|
| confirmation_nonce | string | — | Confirmation code the human operator read from the server console, for payments above the auto-approve threshold. The code is NEVER in a tool result — ask the human for it. Omit on the first call to… |
| invoice | string | yes | BOLT11 Lightning invoice string to pay |
| max_sats | integer | — | Maximum satoshis allowed to pay. Defaults to 1000 |
No output schema declared.
No examples provided.
pay_l402_challenge ~170
Manually pay an L402 or MPP invoice and receive the authorization token. Use this if you need to handle the L402/MPP flow yourself. Omit macaroon for MPP (Machine Payments Protocol) mode.
| Name | Type | Req | Description |
|---|---|---|---|
| confirmation_nonce | string | — | Confirmation code the human operator read from the server console, for payments above the auto-approve threshold. The code is NEVER in a tool result — ask the human for it. Omit on the first call to… |
| invoice | string | yes | BOLT11 Lightning invoice string |
| macaroon | string|null | — | Base64-encoded macaroon from the L402 challenge. Omit for MPP mode (preimage-only authentication). |
| max_sats | integer | — | Maximum satoshis allowed for this payment |
No output schema declared.
No examples provided.
publish_agent_attestation ~127
Publish an attestation (review) for an agent after a completed agreement. Creates a kind 38403 event that builds the agent's on-protocol reputation. Requires LIGHTNING_ENABLE_API_KEY.
| Name | Type | Req | Description |
|---|---|---|---|
| agreement_id | string | yes | Event ID of the agreement this review is for |
| content | string | yes | Free-text review content |
| proof | string | — | Optional: hash of L402 payment preimage as proof of real transaction |
| rating | integer | yes | Rating from 1-5 |
| subject_pubkey | string | yes | Pubkey of the agent being reviewed |
No output schema declared.
No examples provided.
publish_agent_capability ~168
Publish an agent capability advertisement to the Nostr network. Makes your agent discoverable by other agents. Creates a kind 38400 event. Optionally creates an L402 proxy for payment settlement. Requires LIGHTNING_ENABLE_API_KEY.
| Name | Type | Req | Description |
|---|---|---|---|
| categories | array | yes | Service categories (e.g., ['ai', 'translation']) |
| content | string | yes | Description of the service |
| hashtags | array | — | Hashtags for discoverability |
| l402_endpoint | string | — | L402 endpoint URL for payment settlement |
| price_sats | integer | yes | Price per request in satoshis |
| service_id | string | yes | Unique service identifier (used as d-tag) |
| target_url | string | — | Target API URL (if auto-creating an L402 proxy via Lightning Enable) |
No output schema declared.
No examples provided.
request_agent_service ~114
Sends a service request (kind 38401 event) referencing the provider's capability. The provider responds with agreement/settlement terms; settle via settle_agent_service. If the provider has an L402 endpoint, you can skip this step and use settle_agent_service directly. Requires LIGHTNING_ENABLE_API_KEY.
| Name | Type | Req | Description |
|---|---|---|---|
| budget_sats | integer | yes | Maximum budget in satoshis |
| capability_event_id | string | yes | Event ID of the capability to request |
| parameters | string | — | Additional parameters as a JSON string |
No output schema declared.
No examples provided.
send_onchain ~120
Send an on-chain Bitcoin payment to a Bitcoin address. Currently only available with Strike wallet.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | yes | Bitcoin address to send to (e.g., bc1q...) |
| amount_sats | integer | yes | Amount to send in satoshis |
| confirmation_nonce | string | — | Confirmation code the human operator read from the server console. On-chain sends always require it: the first call prints a code to the console (never in the result) and returns requiresConfirmation… |
No output schema declared.
No examples provided.
settle_agent_service ~254
Settle an agent service agreement via L402 payment (CONSUMER/REQUESTER side). Pays the L402 endpoint specified in the agreement, completing the service transaction. Uses the same L402 auto-pay flow as access_l402_resource. The L402 endpoint URL comes from discover_agent_services or request_agent_service results. NOTE: If you are the PROVIDER (selling a service), use create_l402_challenge to generate a Lightning invoice at the agreed price, then verify_l402_payment to confirm payment before delivering the service.
| Name | Type | Req | Description |
|---|---|---|---|
| agreement_id | string | — | Agreement event ID for tracking |
| body | string | — | Optional request body for POST requests (e.g., service parameters as JSON) |
| confirmation_nonce | string | — | Confirmation code the human operator read from the server console, for settlements above the auto-approve threshold. The code is NEVER in a tool result — ask the human for it. Omit on the first call… |
| l402_endpoint | string | yes | L402 endpoint URL from the service agreement |
| max_sats | integer | — | Maximum satoshis to pay |
| method | string | — | HTTP method (GET, POST, PUT, DELETE). Defaults to GET |
No output schema declared.
No examples provided.
test_l402_payment ~144
Self-test the Lightning wallet by paying the public 1-sat L402 test endpoint end to end. Proves the wallet is connected, returns a preimage, and can complete an L402 payment. Costs about 1 satoshi. Use this to verify setup or answer 'is my wallet actually working?'. If your budget config requires confirmation for this amount, the verdict is 'needs_confirmation' and the server prints a code to its console — re-run with confirmation_nonce set to that code.
| Name | Type | Req | Description |
|---|---|---|---|
| confirmation_nonce | string | — | Confirmation code the human read from the server console, if a prior call returned test='needs_confirmation'. Omit on the first call. |
No output schema declared.
No examples provided.
verify_l402_payment ~100
Verify an L402 token (macaroon + preimage) to confirm payment was made. Use this after receiving an L402 token from a payer to validate they paid before granting access to the resource. Requires LIGHTNING_ENABLE_API_KEY with an Agentic Commerce subscription.
| Name | Type | Req | Description |
|---|---|---|---|
| macaroon | string | yes | Base64-encoded macaroon from the L402 token |
| preimage | string | yes | Hex-encoded preimage (proof of payment) |
No output schema declared.
No examples provided.