Skip to main content
Glama
kaleidoswap

wdk-wallet-rln-mcp

Official
by kaleidoswap

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

Related MCP server: Alby Bitcoin Payments MCP Server

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

Install Server
F
license - not found
A
quality
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/kaleidoswap/wdk-wallet-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server