- Home
- Skills
- APIs & Backend
- lightning gifts
Works with the AI Agents you already use
lightning gifts
Create, fund, and manage Bitcoin gifts over the Lightning Network using the lightning.gifts API.
Free
lightning gifts
Example session with this skill installed
I want to send 5000 sats as a birthday gift to a friend. Please create the gift and give me the funding invoice.
- Read your context and instructions
- Compiled the lightning gifts
I have initialized a new Bitcoin gift. You need to pay the funding invoice below to activate the claim link.
Gift Funding Details
| Property | Value |
|---|---|
| Gift ID | a1b2c3d4-e5f6-7890-abcd-ef1234567890 |
| Gift Amount | 5,000 sats |
| Total to Pay (inc. fee) | 5,100 sats |
| Status | UNFUNDED |
| Expiry | 2024-12-25T12:00:00.000Z |
Funding Invoice (BOLT11)
lnbc5100n1pn...[truncated for example]...8qcpqzp0822
Next steps
- Copy the BOLT11 invoice above and pay it using your Lightning wallet (e.g., Phoenix, Zeus, or Strike).
- Once paid, let me know so I can verify the
UNSEENstatus and mint your claim link. - Do not share the Gift ID publicly; only the claim link generated in the next step should be shared with your friend.
Connects securely to your tools. The creator never sees your data.
About this skill
Sending Bitcoin as a gift often involves complex wallet setup or high fees for the recipient. Lightning Gifts simplifies this by allowing you to fund a gift over the Lightning Network that anyone can claim via a simple web link.
What it does
- Fund gifts by creating a gift record and generating a BOLT11 invoice for payment.
- Price conversion provides real-time BTC to fiat exchange rates to help calculate gift values.
- Claim link generation mints single-use, time-limited URLs that allow recipients to withdraw sats.
- Gift reclamation allows givers to sweep funds from expired, unclaimed gifts back to their own wallet.
- Status monitoring tracks gifts through their lifecycle from unfunded to terminal states like withdrawn or reclaimed.
How it works
- Preflight check verifies the deployment's capability to receive payments before you mint an invoice.
- Create gift initializes the gift with a specific satoshi amount, expiry date, and optional onboarding flow.
- Pay invoice requires the giver to pay the generated BOLT11 funding invoice using an external Lightning wallet.
- Mint link generates the actual
claimUrlcontaining a specific token required for the recipient to access the funds.
Frameworks & tools
This skill interacts with the Lightning Gifts HTTP API. It requires an external Lightning wallet to pay funding invoices and handles data formatted in ISO datetimes and BOLT11 strings.
Why this beats prompting it yourself
Managing gift states and calculating fee floors is error-prone. This skill handles the specific 1% fee logic, expiry constraints, and the multi-step authentication flow involving CSRF tokens and JWT extraction that standard LLMs miss.
Use cases
- Automate birthday or thank-you Bitcoin gifts via a script.
- Generate physical gift cards by minting claim links for printing.
- Recover sats from old, forgotten, or unclaimed promotional gifts.
- Integrate sat-based tipping into existing application workflows.
Known limitations
The API key must be treated as a password and stored securely. The skill does not act as a wallet, it requires an external Lightning-enabled wallet to fund the invoices.
Requires external Lightning wallet to fund invoices. 30-second rate limiting on withdrawals. API keys have no expiry or scopes.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Free forever
No account required to browse
Trust & safety
Security scan
Security scan passed 6 days ago
- Free with an Agensi account
Requires
Permissions
Allowed Hosts