Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    lightning gifts

    1

    Create, fund, and manage Bitcoin gifts over the Lightning Network using the lightning.gifts API.

    Free

    Security scanned
    lightning gifts

    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

    PropertyValue
    Gift IDa1b2c3d4-e5f6-7890-abcd-ef1234567890
    Gift Amount5,000 sats
    Total to Pay (inc. fee)5,100 sats
    StatusUNFUNDED
    Expiry2024-12-25T12:00:00.000Z

    Funding Invoice (BOLT11)

    lnbc5100n1pn...[truncated for example]...8qcpqzp0822
    

    Next steps

    1. Copy the BOLT11 invoice above and pay it using your Lightning wallet (e.g., Phoenix, Zeus, or Strike).
    2. Once paid, let me know so I can verify the UNSEEN status and mint your claim link.
    3. 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

    1. Preflight check verifies the deployment's capability to receive payments before you mint an invoice.
    2. Create gift initializes the gift with a specific satoshi amount, expiry date, and optional onboarding flow.
    3. Pay invoice requires the giver to pay the generated BOLT11 funding invoice using an external Lightning wallet.
    4. Mint link generates the actual claimUrl containing 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. 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. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 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

    Lightning
    Node.js

    Permissions

    Network Access
    Read Files

    Allowed Hosts

    lightning.gifts
    Listed6 days ago

    What's inside

    Frequently Asked Questions

    This skill simplifies Bitcoin gifting by automating the creation, funding, and management of Lightning Network gift links, removing the need for recipients to have a pre-configured wallet or technical knowledge.

    No, the skill generates a BOLT11 invoice that you must pay using your own external Lightning-enabled wallet (like Zeus, Phoenix, or Strike) to fund the gift.

    The skill handles the multi-step process of checking API health, calculating the 1% service fee, generating secure claim tokens, and monitoring gift status through a single automated workflow.

    Yes, the skill includes functionality to track gift lifecycles and 'sweep' or reclaim sats from expired or forgotten gifts back to your own wallet.

    You will need a valid API key from the Lightning Gifts service and an AI agent framework capable of making HTTP requests and storing environment variables securely.

    The skill supports real-time BTC to fiat exchange rate lookups, allowing you to specify gift amounts in your local currency while it calculates the exact satoshi value.

    New in APIs & Backend