# OpenNode MCP for AI Agents AI Agent Connect > OpenNode MCP lets you manage Bitcoin and Lightning Network payments directly through your AI agent. Create charges, initiate payouts, and track transaction history in one place. It connects your OpenNode account to your existing workflow so you can handle crypto payments without switching tabs. ## Overview - **Category:** payment-processing - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_wJLw8OVUYCT56VlfqAd0GktYrBFJhVlI0wOkQO7w/ai-agent-connect - **Tags:** bitcoin, lightning-network, crypto-payments, merchant-services, payouts ## Description Managing Bitcoin and Lightning payments usually means jumping between different dashboards, copying addresses, and manually verifying transactions. This Connector changes that by bringing your OpenNode account directly into your AI agent. You can ask your agent to generate Lightning invoices or initiate a Bitcoin withdrawal to a specific address without ever leaving your chat interface. It's built for anyone who needs to move money on the blockchain reliably. Whether you're a merchant taking payments or a business owner handling payouts, you can now treat your crypto wallet like a standard tool. You'll find this is a huge win when using the Vinkius catalog because it puts the heavy lifting of payment processing into a single, controllable interface. Instead of hunting for API keys or checking balances on a separate site, your agent handles the heavy lifting while you stay focused on your actual work. ## Tools ### create_charge Create a new Bitcoin payment request. You can use this to generate Lightning invoices or provide on-chain addresses. ### get_charge See the specific details of a payment request you've created. This is useful for checking invoice status. ### create_refund Issue a refund for a charge that was underpaid. This is a direct way to handle customer payment issues. ### set_scheduled_withdrawals Change the status of bank withdrawals that are currently scheduled. Use this to manage your pending bank moves. ### initiate_withdrawal Start a new payout to a Bitcoin address or a Lightning invoice. This tool lets you preview the payment first. ### get_account_balance Check how much money is currently in your account. This helps you keep an eye on your liquidity. ### list_activity View a list of recent account movements. It's a quick way to see what's happening with your funds. ### create_address Generate a new static on-chain Bitcoin address. Use this for customers who need a permanent place to send funds. ### list_addresses See all the static on-chain addresses you've created. This keeps your payment points organized. ### list_charges View a list of all the charges that have been paid. This gives you a clear view of your incoming revenue. ### initiate_exchange Start a process to swap between Bitcoin and fiat currency. Use this when you need to move money between types. ### create_lnurl_pay Create a static Lightning address for easy payments. This is perfect for recurring customer payments. ### list_lnurl_pay View all the static Lightning addresses you have set up. This helps you manage your various LNURL payment points. ### initiate_lnurl_withdrawal Start a withdrawal to a specific LNURL address. This makes it easy to pay other Lightning users. ### get_rates See the current exchange rates for Bitcoin and other currencies. Use this to know the value of your crypto in real time. ### list_withdrawals See a full history of all your previous withdrawals. It's great for auditing your past payouts. ### confirm_chain_withdrawal Finalize a Bitcoin withdrawal that you previously previewed. It's the final step for sending on-chain funds. ### confirm_ln_withdrawal Finalize a Lightning withdrawal after reviewing the details. This completes your Lightning payouts. ### get_withdrawal Look up the specific details of a single withdrawal. Use this to track a specific payout's progress. ### get_currencies Check which currencies your account can currently receive. This helps you see what payment types are active. ### get_refund Look up the details of a specific refund you've issued. Use this to verify a customer's refund status. ### list_refunds See a list of all refunds processed through your account. This helps you keep your refund history organized. ## Prompt Examples **Prompt:** ``` Create a charge for 10000 satoshis with the description 'Coffee purchase'. ``` **Response:** ``` I've created the charge for you. Here are the details: * **Lightning Invoice (BOLT11):** `lnbc100u...` * **On-chain Address:** `tb1q...` * **Charge ID:** `ch_123456` Let me know if you'd like me to send this to the customer! ``` **Prompt:** ``` List my paid charges on page 1. ``` **Response:** ``` I found 3 paid charges for your account: | Charge ID | Description | Amount | Status | | :--- | :--- | :--- | :--- | | `ch_abc123` | Order #1002 | 5000 satoshis | Paid | | `ch_xyz789` | Donation | 10000 satoshis | Paid | | `ch_999888` | API Access | 2500 satoshis | Paid | ``` **Prompt:** ``` Get the details of charge ID ch_abc123. ``` **Response:** ``` Here are the details for charge `ch_abc123`: * **Status:** Paid * **Amount:** 5000 satoshis * **Date:** 2023-10-27 * **Description:** API Access * **Type:** Bitcoin Payment ``` ## Capabilities ### Create Lightning invoices Generate BOLT11 invoices for instant payments from customers. ### Initiate crypto payouts Send Bitcoin or Lightning payments to specific addresses or invoices. ### Track paid charges View a list of all completed payments and their specific details. ### Generate static addresses Create and manage on-chain Bitcoin addresses for receiving funds. ### Check real-time balances Get your current account balance and current exchange rates instantly. ## Use Cases ### The Coffee Shop A merchant asks their agent to 'Create a Lightning invoice for $5.00.' The agent uses `create_charge` and gives the customer the BOLT11 code instantly. ### The Freelance Payout A project manager needs to pay three contractors. They ask the agent to 'Initiate a withdrawal to these three Bitcoin addresses.' The agent uses `initiate_withdrawal` for each. ### The Refund Request A customer says they were overcharged. The user tells the agent to 'Find charge ch_123 and issue a refund.' The agent uses `get_charge` then `create_refund`. ### The Balance Check A business owner wants to know their current position. They ask 'What is my current balance and what are the BTC rates?' The agent uses `get_account_balance` and `get_rates`. ## Benefits - Stop copying and pasting addresses by using `create_charge` to generate Lightning invoices on the fly. - Speed up your payout process by using `initiate_withdrawal` to send funds to multiple Bitcoin addresses. - Keep your books clean by using `list_withdrawals` and `list_charges` to see every transaction in one list. - Manage complex refunds easily with `create_refund` and `get_refund` to handle customer issues quickly. - Monitor your liquidity in real time with `get_account_balance` and `get_rates` to know exactly what your funds are worth. ## How It Works The bottom line is you get a direct line to your Bitcoin payments without the manual overhead. 1. Subscribe to the OpenNode MCP on the Vinkius Marketplace. 2. Enter your OpenNode API key into your AI client settings. 3. Ask your agent to create charges, send payouts, or check your balance. ## Frequently Asked Questions **Can I use OpenNode MCP to accept Bitcoin payments?** Yes, you can use it to create charges using either on-chain Bitcoin addresses or Lightning invoices for instant payments. **How does OpenNode MCP handle Lightning payments?** It supports creating Lightning invoices for receiving money and initiating withdrawals to Lightning invoices for sending it. **Can my agent send payouts with OpenNode MCP?** Your agent can initiate both Bitcoin and Lightning payouts and confirm them once you've reviewed the preview. **Can I check my balance using OpenNode MCP?** Yes, your agent can retrieve your current account balance and check real-time exchange rates at any time. **How do I handle refunds with OpenNode MCP?** You can ask your agent to issue a refund for an underpaid charge or look up the details of any refund you've already processed. **Does OpenNode MCP support static addresses?** Yes, it allows you to create, list, and use static on-chain Bitcoin addresses for your payment workflows. **How do I generate a new Bitcoin payment request?** Use the `create_charge` tool. Provide the amount in satoshis (or specify a currency like USD) and an optional description. The tool returns a BOLT11 Lightning invoice and an on-chain address. **Can I preview a withdrawal before confirming it?** Yes. Call `initiate_withdrawal` with `auto_confirm` set to false. This generates a preview. You can then finalize it using `confirm_chain_withdrawal` or `confirm_ln_withdrawal` depending on the type. **How do I check my past withdrawals?** You can use the `list_withdrawals` tool to retrieve a list of past withdrawals, with optional filters for page size, page number, and withdrawal type (like 'ln' or 'chain').