wdk-wallet-liquid-mcp

MCP server exposing a Liquid network wallet to AI agents, backed by @kaleidorg/wdk-wallet-liquid (an in-process LWK wallet). No external daemon is required.

Tools

Tool	Description
`liquid_get_node_info`	Network, policy asset, receive address, chain tip.
`liquid_get_address`	A confidential (CT) receive address.
`liquid_get_balance`	Spendable L-BTC balance (satoshis).
`liquid_get_asset_balance`	Balance of a specific Liquid asset.
`liquid_list_assets`	All assets held with balances.
`liquid_list_transactions`	Transaction history.
`liquid_list_unspents`	Wallet UTXOs.
`liquid_send_btc`	Send L-BTC to a CT address.
`liquid_send_asset`	Send a Liquid asset (e.g. USDt-Liquid).
`liquid_get_fee_rates`	Suggested fee rates (sat/vB).

Configuration

Env var	Default	Description
`LIQUID_MNEMONIC`	— (required)	BIP-39 mnemonic for the wallet.
`LIQUID_NETWORK`	`testnet`	`mainnet`, `testnet` or `regtest`.
`LIQUID_ESPLORA_URL`	network default	Esplora API base URL.
`PORT`	—	If set, serve over StreamableHTTP instead of stdio.
`MCP_AUTH_TOKEN`	—	Optional bearer token for HTTP mode.

Run

npm install
npm run build

# stdio (Claude Desktop, kaleidoagent, …)
LIQUID_MNEMONIC="word word ..." node dist/index.js

# HTTP
PORT=3013 LIQUID_MNEMONIC="word word ..." node dist/index.js

License

Apache-2.0