MCP 服务器

wdk-wallet-rln-mcp

Exposes an RGB Lightning Node wallet to AI agents, enabling full wallet control including balances, RGB invoices, Lightning payments, channel management, and atomic swap taker support.

README

wdk-wallet-rln-mcp

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"
      }
    }
  }
}