create_invoice
Create a Lightning invoice to receive payment. Use get_invoice_status to check if paid.
This record as markdown: /tools/io-github-lightningfaucet-lightning-wallet-mcp/create-invoice.md
What create_invoice does on Lightning Wallet
AI agents use create_invoice to commit financial operations through Lightning Wallet, usually the final step of a payment, billing, or trading workflow. A call moves real money.
Why create_invoice is rated Critical
Creating a Lightning invoice initiates a financial transaction request on the Bitcoin Lightning Network. While it is receiving rather than sending funds, it commits a financial obligation and is part of the payment flow. Misuse could involve generating fraudulent invoices or tricking parties into paying incorrect amounts. The Financial category applies as it directly involves moving money.
From the tool's definition Create a Lightning invoice to receive payment
Attacks that exploit this kind of access
The rule that runs create_invoice safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Lightning Wallet, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For create_invoice, this is the rule to start with:
Any call to create_invoice is blocked until a human approves it. The rest of the server keeps working.
The button opens the PolicyLayer dashboard: create your workspace, connect Lightning Wallet, apply this rule, and every create_invoice call is checked against it from then on.
Questions about create_invoice
Create a Lightning invoice to receive payment. Use get_invoice_status to check if paid. It is categorised as a Financial tool in the Lightning Wallet MCP Server, which means it involves financial transactions. Block by default and require explicit approval.
Register the Lightning Wallet MCP server in PolicyLayer and add a rule for create_invoice: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Lightning Wallet. Nothing to install.
create_invoice is a Financial tool with critical risk. Critical-risk tools should be blocked by default and only enabled with explicit human approval.
Yes. Add a rate_limit block to the create_invoice rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for create_invoice. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
create_invoice is provided by the Lightning Wallet MCP server (lightning-wallet-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Lightning Wallet, and thousands of servers like it.
Across the catalogue