Lightning Enable MCP Server
AI agent Lightning payments: L402, invoices, wallets, API discovery, budgets, self-serve signup.
Connector by refined-element · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/refined-element-lightning-enable-mcp
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Use cases: payments-billing, crypto-web3
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.
- Tools
- 14 read · 12 write · 0 delete · 6 not yet classified
- Secrets
- 5 (API keys, tokens or passwords)
- Install scripts
- None found
- Runs as
- Python package
Tools by what they do 32
Read from the source code; the running server may list different tools.
Read 14 · Look things up without changing anything.
access_l402_resourcebudgetcheck_invoice_statusdiscover_agent_servicesdiscover_apiget_agent_reputationget_balanceget_btc_priceget_budget_statusget_payment_historyget_receiptsreceipts
Show 2 more tools
verify_confirmation_codeverify_l402_payment
Write 12 · Create, change, send or run things.
configure_budgetcreate_invoicecreate_l402_challengecreate_lightning_enable_accountl402_producerpay_invoicepay_l402_challengepublish_agent_attestationpublish_agent_capabilityrenew_lightning_enable_subscriptionrequest_agent_servicesend_onchain
Not yet classified 6 · We could not tell from the name and description.
agent_servicesexchange_currencysettle_agent_servicesetup_walletunpublish_agent_capabilitywallet_ops
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
LIGHTNING_ENABLE_API_KEYLND_MACAROON_HEXNWC_CONNECTION_STRINGOPENNODE_API_KEYSTRIKE_API_KEY
Other settings (environment variables or headers).
AGENT_RELAY_URLLIGHTNING_ENABLE_TOOL_PROFILELND_REST_HOSTOPENNODE_ENVIRONMENT
Network hosts it talks to 13
169.254.169.254· found in codeapi.coinbase.com· found in codeapi.coingecko.com· found in codeapi.kraken.com· found in codeapi.lightningenable.com· found in codeapi.opennode.com· found in codeapi.strike.me· found in codedashboard.strike.me· found in codedev-api.opennode.com· found in codedocs.lightningenable.com· found in codegithub.com· found in codeglama.ai· found in codelightningenable.com· found in code
Files it touches
- Your home directory (~)
~/.lightning-enable/config.json~/.lightning-enable/config.json.~/.lightning-enable/operations.jsonl~/.lightning-enable/receipts.jsonl- Any path the agent passes to its tools
Tools (32)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
access_l402_resourceFetch a URL with GET or HEAD, automatically paying any L402 challenge and retrying. Read-only: other HTTP methods are refused. Returns the response plus what was paid.
agent_servicesAgent Service Agreements over Nostr: discover, request, settle, publish and review agent services. Requires LIGHTNING_ENABLE_API_KEY.
budgetView or tighten this session's spending limits. Tightening is one-way - an agent can lower its caps but never raise the operator's config limits.
check_invoice_statusCheck whether an invoice from create_invoice has been paid.
configure_budgetSet spending limits for the session.
create_invoiceCreate a BOLT11 Lightning invoice to receive a payment.
create_l402_challengeCreate 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.
create_lightning_enable_accountSelf-bootstrapping signup: pay a ~100-sat activation fee for a Lightning Enable merchant API key. Needs only a wallet; the key is saved to ~/.lightning-enable/config.json.
discover_agent_servicesDiscover 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.
discover_apiDiscover L402 APIs: search the registry with query/category, or fetch one API's manifest with url.
exchange_currencyExchange currency within your wallet (USD to BTC or BTC to USD). Currently only available with Strike wallet.
get_agent_reputationGet an agent's reputation score and reviews. Queries kind 38403 attestation events for the given pubkey off the relay. Returns the average rating and individual reviews. Ratings are un-weighted on-relay attestations — apply your own proof/Web-of-Trust weighting before trusting them.
get_balanceGet the connected wallet's balance in sats, plus all currency balances and wallet info where the wallet reports them.
get_btc_priceGet the current Bitcoin price in USD. Only available with Strike wallet.
get_budget_statusView current budget status and spending limits (read-only). Edit ~/.lightning-enable/config.json to change limits.
Show 17 more tools
get_payment_historyList recent L402 payments made during this session.
get_receiptsRead the durable, append-only payment receipt log (~/.lightning-enable/receipts.jsonl). Unlike receipts(source="session") (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.
l402_producerSell access with L402: set up the seller account, monetize an API, mint challenges and verify payer tokens. Requires LIGHTNING_ENABLE_API_KEY.
pay_invoicePay a BOLT11 Lightning invoice directly and get the preimage as proof.
pay_l402_challengePay an L402 or MPP invoice yourself and get the authorization token. Omit macaroon for MPP; pass challenge_header for a draft-00 Payment challenge.
publish_agent_attestationPublish 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. NOTE: writing attestations is not yet available on the hosted API and returns an error. The platform holds a single signing key, so a platform-signed review would share one pubkey across all reviewers — worthless for reputation — so this is intentionally disabled until per-agent (client-side) signing exists. Reading reputation (agent_services action=reputation) works today.
publish_agent_capabilityPublish an agent capability advertisement to the Nostr network. Makes your agent discoverable by other agents as a kind 38400 listing, published via Lightning Enable's L402 proxy pipeline. Provide target_url — an L402 proxy is created to back the listing and handle payment. The event is signed by the Lightning Enable platform key. Each call creates a new listing, so publish once; to change a listing, unpublish it and publish again. Requires LIGHTNING_ENABLE_API_KEY.
receiptsList payments this wallet made. The durable log persists across restarts and says how to revoke the wallet; the session list is in-memory only.
renew_lightning_enable_subscriptionPay the L402 invoice that buys or extends 30 days of Lightning Enable Agentic Commerce for the configured API key. Needs a preimage-capable wallet.
request_agent_serviceSends a service request (kind 38401 event) referencing the provider's capability. The provider responds with agreement/settlement terms; settle via agent_services action=settle. If the provider has an L402 endpoint, you can skip this step and use agent_services action=settle directly. Requires LIGHTNING_ENABLE_API_KEY.
send_onchainSend an on-chain Bitcoin payment to a Bitcoin address. Currently only available with Strike wallet.
settle_agent_serviceSettle 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 an agent_services action=discover or action=request result. NOTE: If you are the PROVIDER (selling a service), use l402_producer action=create to generate a Lightning invoice at the agreed price, then l402_producer action=verify to confirm payment before delivering the service.
setup_walletReport the wallet this server pays from, or connect one. Call with no arguments first - it also returns the setup steps when no wallet is configured.
unpublish_agent_capabilityTake a published listing down. Retires the L402 proxy and publishes a NIP-09 kind 5 deletion plus a status=removed 38400 replacement, so other agents stop seeing a dead listing. Works for marketplace listings created via the L402 proxy/dashboard pipeline. Requires LIGHTNING_ENABLE_API_KEY.
verify_confirmation_codeCheck whether a payment confirmation code is still valid and what it authorizes. Verification ONLY - it never pays; to pay, re-call the payment tool with confirmation_nonce.
verify_l402_paymentVerify 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.
wallet_opsWallet operations beyond invoices: BTC price, currency exchange, on-chain sends. Strike only (send_onchain also works on LND).
Compare and alternatives
Featured in
Signals
- Stars
- 9
- Forks
- 2
- Open issues
- 22
- Weekly downloads
- 256
- Last commit
- Oct 22, 2026 (6 days ago)
- Last release
- Oct 22, 2026 (6 days ago)
- Last package publish
- Oct 22, 2026 (6 days ago)
From GitHub (fetched Oct 24, 2026) and the package registry.
Details
- Registry name
io.github.refined-element/lightning-enable-mcp- Version
- 2.1.1
- Auth
- API key
- Packages
- nuget LightningEnable.Mcppypi lightning-enable-mcpoci
docker.io/refinedelement/lightning-enable-mcp:2.1.1 - License
- MIT
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
Cite this page
Lightning Enable MCP Server. Agent Mart. https://agentmart.dev/connectors/refined-element-lightning-enable-mcp (last updated 2026-10-24)