# OpenNode MCP for AI Agents AI Agent Connect

> OpenNode MCP lets you manage Bitcoin and Lightning Network payments directly through your AI agent. You can create charges, handle payouts, and track your transaction history without switching tabs. It connects your OpenNode account to your workflow so you can handle crypto payments with plain English commands.

## 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 crypto payments usually involves jumping between different dashboards, copy-pasting addresses, and double-checking invoice details. This Connector changes that by putting your OpenNode account inside your AI client. Instead of hunting for a specific Lightning BOLT11 invoice or checking a static on-chain address, you just ask your agent to do it. You can create new charges, initiate withdrawals to specific addresses, and check your balance in a single conversation. It turns a multi-step manual process into a few typed commands. By using the Vinkius catalog to host this connection, you get a reliable way to bridge your crypto merchant services with your daily operations. It's built for anyone who needs to move Bitcoin or Lightning funds without the friction of a traditional web interface.

## Tools

### create_charge
Create a new Bitcoin payment request for a customer. This makes it easy to generate invoices on demand.

### get_charge
See the specific details of a payment charge. Use this to check if a customer has paid their invoice.

### create_refund
Issue a refund for a charge that was underpaid. Use this to correct payment discrepancies quickly.

### set_scheduled_withdrawals
Update the status of your scheduled bank withdrawals. Use this to manage your planned bank movements.

### initiate_withdrawal
Start a new withdrawal or preview a payout to a Bitcoin address or Lightning invoice. It lets you check the details before you send funds.

### get_account_balance
Check your current account balance. This gives you an immediate look at your available funds.

### list_activity
See a list of recent activity on your account. Use this to monitor all recent movements and changes.

### create_address
Generate a new static on-chain address. This is useful for creating permanent addresses for receiving funds.

### list_addresses
View all your existing static on-chain addresses. Use this to manage your list of receiving addresses.

### list_charges
See a list of all your paid charges. This helps you keep a record of all completed transactions.

### initiate_exchange
Start a currency exchange between Bitcoin and fiat. This lets you swap currencies with a single command.

### create_lnurl_pay
Create a static LNURL-Pay address for recurring payments. This is great for setting up persistent payment links.

### list_lnurl_pay
See a list of all your static LNURL-Pay addresses. Use this to manage your recurring payment links.

### initiate_lnurl_withdrawal
Start a withdrawal using an LNURL. This lets you send funds to a specific LNURL-based destination.

### get_rates
Check the current exchange rates for different currencies. Use this to see the best conversion prices before trading.

### list_withdrawals
See a list of all your previous and current withdrawals. This is useful for auditing your payout history.

### confirm_chain_withdrawal
Finalize a withdrawal that was previously previewed on the chain. This completes the move of funds to an on-chain address.

### confirm_ln_withdrawal
Finalize a withdrawal that was previously previewed on the Lightning Network. This completes the move of funds to a Lightning invoice.

### get_withdrawal
Get the specific details of a single withdrawal. Use this to track the status of a specific payout.

### get_currencies
See which currencies you can use as an origin for payments. This helps you understand your funding options.

### get_refund
Get the specific details of a refund you've issued. Use this to verify that a customer received their money back.

### list_refunds
See a list of all refunds processed on your account. This helps you manage your refund history.

## Prompt Examples

**Prompt:** 
```
I need to create a charge for 20,000 satoshis for a 'Web Design' project. Give me the invoice.
```

**Response:** 
```
I've created that charge for you. Here is your Lightning BOLT11 invoice: `lnbc100u...`. The charge ID is `ch_9988`. Let me know if you need the on-chain address instead.
```

**Prompt:** 
```
What is my current balance and what were my last three withdrawals?
```

**Response:** 
```
Your current balance is 150,000 satoshis. Here are your last three withdrawals:

| Date | Amount | Status |
| :--- | :--- | :--- |
| 2023-10-01 | 5,000 | Completed |
| 2023-10-02 | 10,000 | Completed |
| 2023-10-03 | 2,500 | Completed |
```

**Prompt:** 
```
Can you show me the current exchange rates for BTC to USD?
```

**Response:** 
```
The current exchange rates are:

| Currency | Rate |
| :--- | :--- |
| USD | 63,450.20 |
| EUR | 58,900.10 |
```

## Capabilities

### Create payment requests
Generate Lightning invoices or on-chain addresses instantly.

### Initiate payouts
Send funds to Bitcoin addresses or Lightning invoices.

### Check account balances
Get your current holdings across different currencies.

### Track transaction history
View a list of your recent activities and paid charges.

### Manage refunds
Handle underpaid charges by issuing refunds directly.

### Set up static addresses
Create and list your permanent on-chain and LNURL addresses.

## Use Cases

### Quick merchant invoice generation
A merchant needs to collect a payment for a digital service. They ask the agent to create a charge for 5000 satoshis, and the agent provides a BOLT11 invoice.

### Bulk payout confirmation
A payout manager needs to send funds to 10 different addresses. They use `initiate_withdrawal` to preview the payouts and `confirm_chain_withdrawal` to finalize them.

### Instant refund verification
A customer service rep needs to check a refund status. They ask the agent to find the details of a specific refund using `get_refund`.

### Real-time balance monitoring
A user wants to know their current balance before making a trade. The agent uses `get_account_balance` to provide a real-time summary.

## Benefits

- Faster Payment Requests: Use `create_charge` to generate Lightning invoices or on-chain addresses in seconds instead of navigating a menu.
- Simplified Payouts: Use `initiate_withdrawal` and `confirm_ln_withdrawal` to send funds without manual address entry errors.
- Instant Balance Checks: Use `get_account_balance` to see your current holdings immediately during a conversation.
- Easy Audit Trails: Use `list_withdrawals` and `list_charges` to keep track of every transaction without opening a separate spreadsheet.
- Automated Refunds: Use `create_refund` to quickly handle underpaid charges when a customer requests a correction.
- Dynamic Rate Checking: Use `get_rates` to see current conversion values before you initiate an exchange.

## How It Works

The bottom line is you stop clicking through dashboards and start managing crypto payments through conversation.

1. Connect your OpenNode API key to the Connector through the Vinkius dashboard.
2. Open your AI client and give it a command like Create a charge for 50 satoshis.
3. The agent executes the request and gives you the payment details or confirmation.

## Frequently Asked Questions

**How does the OpenNode MCP help with my Bitcoin payments?**
It lets your AI agent handle the creation of invoices and the processing of charges directly. You can manage your merchant account through plain text instead of clicking through a dashboard.

**Can I use the OpenNode MCP to send payouts to my customers?**
Yes. You can initiate and confirm withdrawals to both Bitcoin addresses and Lightning invoices using your agent.

**Is it safe to manage my OpenNode account through an AI agent?**
This Connector uses your OpenNode API keys to perform actions securely. It acts as a bridge between your agent and the OpenNode infrastructure.

**Can the OpenNode MCP handle refunds for underpaid charges?**
Yes, it can. Your agent can use the tool to issue refunds for charges that didn't receive enough funds.

**How do I check my balance using the OpenNode MCP?**
You can simply ask your agent for your current balance. It will call the tool and give you a real-time update on your holdings.

**Does the OpenNode MCP support Lightning Network invoices?**
Yes, it fully supports creating and managing Lightning BOLT11 invoices for your payment requests.

**Can I see my transaction history with the OpenNode MCP?**
You can ask your agent to list your activity or withdrawals. It will pull a list of your recent history for you to review.

**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').