Wdk Wallet Rln

MCP server that exposes an RGB Lightning Node (RLN) wallet to AI agents via the Model Context Protocol.

Provides full wallet control: balances, RGB invoices, Lightning payments, channel management, and atomic swap taker support.

Tools

Node & Balances

Tool	Description
wdk_get_node_info	Node pubkey, channel count, Lightning balance, connected peers
wdk_get_balances	BTC on-chain (vanilla + colored UTXOs) and Lightning balance
wdk_get_asset_balance	RGB asset balance by asset_id — settled, spendable, off-chain
wdk_list_assets	All RGB assets held by the node (NIA, UDA, CFA schemas)
wdk_get_address	On-chain BTC deposit address

Invoices & Payments

Tool	Description
wdk_create_rgb_invoice	Create an RGB invoice to receive an asset off-chain
wdk_create_ln_invoice	Create a BOLT11 Lightning invoice to receive BTC
wdk_pay_invoice	Pay a BOLT11 Lightning invoice
wdk_send_btc	Send BTC on-chain
wdk_send_asset	Send an RGB asset on-chain to a recipient ID

Channel Management

Tool	Description
wdk_list_channels	All channels: capacity, outbound/inbound balance, usability, RGB asset
wdk_open_channel	Open a new channel, optionally with RGB asset allocation

Transfers & Payments History

Tool	Description
wdk_list_payments	Recent Lightning payments (sent and received)
wdk_refresh_transfers	Flush pending RGB asset transfers

Atomic Swap Taker

Tool	Description
wdk_atomic_taker	Step 2 of atomic swap — whitelist HTLC on node before execute
wdk_list_swaps	List all atomic swaps on the node
wdk_get_swap	Get atomic swap state by payment_hash

Atomic Swap Flow

This server handles step 2 of the 5-step atomic swap flow:

kaleidoswap_atomic_init    → swapstring + payment_hash  (kaleidoswap-mcp)
wdk_atomic_taker           → whitelist HTLC on node     ← this server
wdk_get_node_info          → taker_pubkey               ← this server
kaleidoswap_atomic_execute → HTLC settlement            (kaleidoswap-mcp)

Installation

npm install
npm run build

Usage

# Stdio transport (use with any MCP host)
RLN_NODE_URL=http://localhost:3001 node dist/index.js

Claude Desktop

{
  "mcpServers": {
    "wdk_wallet": {
      "command": "node",
      "args": ["/path/to/wdk-wallet-rln-mcp/dist/index.js"],
      "env": {
        "RLN_NODE_URL": "http://localhost:3001"
      }
    }
  }
}

Configuration

Env var	Default	Description
RLN_NODE_URL	http://localhost:3001	RLN daemon HTTP API URL

Requirements

A running RGB Lightning Node daemon accessible at RLN_NODE_URL.

License

Apache-2.0