kaleido-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,17 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   Copyright 2026 KaleidoSwap
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,55 @@
+# kaleido-mcp
+
+Unified MCP server for the Kaleidoswap stack.
+
+This repo is the **composition layer** that exposes the focused MCP domains through one connection:
+
+- Spark wallet tools
+- RLN wallet tools
+- KaleidoSwap DEX tools
+- MPP / L402 payment-gated API tools
+- market data tools
+
+The canonical tool contracts mirror the focused servers:
+
+- `kaleidoswap_*`
+- `wdk_*`
+- `spark_*`
+- `mpp_*`
+- `l402_*`
+
+Legacy `rln_*` and generic `get_*` market aliases are still present for compatibility during migration.
+
+## Required Environment
+
+| Env var | Required | Description |
+| --- | --- | --- |
+| `WDK_SEED` | yes | BIP-39 mnemonic for the Spark wallet |
+| `SPARK_NETWORK` | no | `MAINNET` or `REGTEST` |
+| `SPARK_SCAN_API_KEY` | no | SparkScan API key |
+| `SPARK_USDT_TOKEN` | no | Default Spark token identifier |
+| `RLN_NODE_URL` | no | RLN daemon URL, default `http://localhost:3001` |
+| `KALEIDOSWAP_API_URL` | no | KaleidoSwap API URL, default `https://api.kaleidoswap.com` |
+| `PORT` | no | Enable Streamable HTTP transport |
+| `MCP_AUTH_TOKEN` | no | Bearer token for HTTP mode |
+
+## Installation
+
+```bash
+npm install
+npm run build
+```
+
+## Usage
+
+```bash
+# stdio
+WDK_SEED="word1 word2 ..." node dist/index.js
+
+# HTTP
+PORT=3010 WDK_SEED="word1 word2 ..." node dist/index.js
+```
+
+## Repo Role
+
+`kaleido-mcp` is intended to stay thin. Domain logic should live in the focused MCP packages or shared libraries, not be reimplemented here.

package/dist/clients/market-client.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Market data client — CoinGecko free tier + alternative.me Fear&Greed.
+ * Ported from mpp-gateway-mcp/src/market-client.ts.
+ */
+export interface PriceResult {
+    asset: string;
+    vs_currency: string;
+    price: number;
+    change_24h_pct: number | null;
+    market_cap_usd: number | null;
+    volume_24h_usd: number | null;
+    last_updated: string;
+}
+export interface OhlcvCandle {
+    timestamp: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+}
+export interface SentimentResult {
+    index_value: number;
+    classification: string;
+    timestamp: string;
+}
+export declare class MarketClient {
+    getPrice(asset: string, vsCurrency?: string): Promise<PriceResult>;
+    getMarketData(assets: string[]): Promise<PriceResult[]>;
+    getOhlcv(asset: string, days: number): Promise<OhlcvCandle[]>;
+    getFearGreedIndex(): Promise<SentimentResult>;
+    private coinId;
+    private fetch;
+}

package/dist/clients/market-client.js

@@ -0,0 +1,72 @@
+/**
+ * Market data client — CoinGecko free tier + alternative.me Fear&Greed.
+ * Ported from mpp-gateway-mcp/src/market-client.ts.
+ */
+const COINGECKO = 'https://api.coingecko.com/api/v3';
+const COIN_IDS = {
+    BTC: 'bitcoin', USDT: 'tether', XAUT: 'tether-gold', ETH: 'ethereum',
+};
+export class MarketClient {
+    async getPrice(asset, vsCurrency = 'usd') {
+        const id = this.coinId(asset);
+        const data = await this.fetch(`${COINGECKO}/simple/price?ids=${id}&vs_currencies=${vsCurrency}&include_market_cap=true&include_24hr_vol=true&include_24hr_change=true&include_last_updated_at=true`);
+        const e = data[id];
+        if (!e)
+            throw new Error(`No price data for ${asset}`);
+        return {
+            asset: asset.toUpperCase(), vs_currency: vsCurrency.toUpperCase(),
+            price: e[vsCurrency] ?? 0,
+            change_24h_pct: e[`${vsCurrency}_24h_change`] ?? null,
+            market_cap_usd: e[`${vsCurrency}_market_cap`] ?? null,
+            volume_24h_usd: e[`${vsCurrency}_24h_vol`] ?? null,
+            last_updated: new Date((e['last_updated_at'] ?? 0) * 1000).toISOString(),
+        };
+    }
+    async getMarketData(assets) {
+        const ids = assets.map(a => this.coinId(a)).join(',');
+        const data = await this.fetch(`${COINGECKO}/simple/price?ids=${ids}&vs_currencies=usd&include_market_cap=true&include_24hr_vol=true&include_24hr_change=true&include_last_updated_at=true`);
+        return assets.map(asset => {
+            const e = data[this.coinId(asset)] ?? {};
+            return {
+                asset: asset.toUpperCase(), vs_currency: 'USD',
+                price: e['usd'] ?? 0,
+                change_24h_pct: e['usd_24h_change'] ?? null,
+                market_cap_usd: e['usd_market_cap'] ?? null,
+                volume_24h_usd: e['usd_24h_vol'] ?? null,
+                last_updated: new Date((e['last_updated_at'] ?? 0) * 1000).toISOString(),
+            };
+        });
+    }
+    async getOhlcv(asset, days) {
+        const id = this.coinId(asset);
+        const raw = await this.fetch(`${COINGECKO}/coins/${id}/ohlc?vs_currency=usd&days=${days}`);
+        return raw.map(([ts, o, h, l, c]) => ({ timestamp: ts, open: o, high: h, low: l, close: c }));
+    }
+    async getFearGreedIndex() {
+        const data = await this.fetch('https://api.alternative.me/fng/?limit=1');
+        const e = data.data?.[0];
+        if (!e)
+            throw new Error('No fear/greed data');
+        return {
+            index_value: parseInt(e.value, 10),
+            classification: e.value_classification,
+            timestamp: new Date(parseInt(e.timestamp, 10) * 1000).toISOString(),
+        };
+    }
+    coinId(asset) {
+        const id = COIN_IDS[asset.toUpperCase()];
+        if (!id)
+            throw new Error(`Unknown asset: ${asset}. Supported: ${Object.keys(COIN_IDS).join(', ')}`);
+        return id;
+    }
+    async fetch(url) {
+        const res = await fetch(url, { headers: { Accept: 'application/json' } });
+        if (!res.ok) {
+            if (res.status === 429)
+                throw new Error('Market data rate limit (HTTP 429). Wait 30s.');
+            throw new Error(`Market data failed: HTTP ${res.status}`);
+        }
+        return res.json();
+    }
+}
+//# sourceMappingURL=market-client.js.map

package/dist/clients/market-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"market-client.js","sourceRoot":"","sources":["../../src/clients/market-client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+/**
+ * kaleido-mcp — Unified KaleidoSwap + WDK MCP Server
+ *
+ * Single MCP server for all KaleidoSwap agent operations:
+ *   • WDK Spark L2 wallet  (fee-free transfers, Lightning pay/receive, BTC bridge)
+ *   • RLN node             (RGB assets, Lightning channels, atomic HTLC swaps)
+ *   • KaleidoSwap DEX      (quotes, REST orders, atomic swaps, LSPS1 channels)
+ *   • MPP / L402           (payment-gated API access, challenge/credential flow)
+ *   • 402index.io          (discover paid APIs by protocol/category)
+ *   • Market data          (prices, OHLCV, Fear & Greed sentiment)
+ *
+ * ~60 tools, one process, one connection.
+ *
+ * Required env vars:
+ *   WDK_SEED          — BIP-39 mnemonic for Spark wallet
+ *
+ * Optional env vars:
+ *   SPARK_NETWORK           — MAINNET | REGTEST (default: MAINNET)
+ *   SPARK_SCAN_API_KEY      — SparkScan API key
+ *   SPARK_USDT_TOKEN        — Spark USDT token identifier (btkn1...)
+ *   RLN_NODE_URL            — RLN daemon URL (default: http://localhost:3001)
+ *   KALEIDOSWAP_API_URL     — KaleidoSwap API (default: https://api.kaleidoswap.com)
+ *   PORT                    — Enable StreamableHTTP on this port (default: stdio)
+ *   MCP_AUTH_TOKEN          — Bearer token for HTTP mode
+ *
+ * Usage:
+ *   WDK_SEED="word1 ... word12" node dist/index.js
+ *   PORT=3010 WDK_SEED="..." node dist/index.js
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+/**
+ * kaleido-mcp — Unified KaleidoSwap + WDK MCP Server
+ *
+ * Single MCP server for all KaleidoSwap agent operations:
+ *   • WDK Spark L2 wallet  (fee-free transfers, Lightning pay/receive, BTC bridge)
+ *   • RLN node             (RGB assets, Lightning channels, atomic HTLC swaps)
+ *   • KaleidoSwap DEX      (quotes, REST orders, atomic swaps, LSPS1 channels)
+ *   • MPP / L402           (payment-gated API access, challenge/credential flow)
+ *   • 402index.io          (discover paid APIs by protocol/category)
+ *   • Market data          (prices, OHLCV, Fear & Greed sentiment)
+ *
+ * ~60 tools, one process, one connection.
+ *
+ * Required env vars:
+ *   WDK_SEED          — BIP-39 mnemonic for Spark wallet
+ *
+ * Optional env vars:
+ *   SPARK_NETWORK           — MAINNET | REGTEST (default: MAINNET)
+ *   SPARK_SCAN_API_KEY      — SparkScan API key
+ *   SPARK_USDT_TOKEN        — Spark USDT token identifier (btkn1...)
+ *   RLN_NODE_URL            — RLN daemon URL (default: http://localhost:3001)
+ *   KALEIDOSWAP_API_URL     — KaleidoSwap API (default: https://api.kaleidoswap.com)
+ *   PORT                    — Enable StreamableHTTP on this port (default: stdio)
+ *   MCP_AUTH_TOKEN          — Bearer token for HTTP mode
+ *
+ * Usage:
+ *   WDK_SEED="word1 ... word12" node dist/index.js
+ *   PORT=3010 WDK_SEED="..." node dist/index.js
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { createServer } from './server.js';
+import { createServer as createHttpServer } from 'node:http';
+const WDK_SEED = process.env.WDK_SEED ?? '';
+const SPARK_NET = (process.env.SPARK_NETWORK ?? 'MAINNET');
+const RLN_URL = process.env.RLN_NODE_URL ?? 'http://localhost:3001';
+const KALEIDO_URL = process.env.KALEIDOSWAP_API_URL ?? 'https://api.kaleidoswap.com';
+const PORT = process.env.PORT ? parseInt(process.env.PORT, 10) : null;
+if (!WDK_SEED) {
+    process.stderr.write('[kaleido-mcp] WARNING: WDK_SEED not set — Spark wallet tools will be disabled\n');
+    process.stderr.write('[kaleido-mcp] Set WDK_SEED="word1 word2 ... word12" to enable Spark features\n');
+    // Continue without Spark — RLN, KaleidoSwap, MPP, and market tools still available
+}
+async function main() {
+    const server = createServer({
+        wdkSeed: WDK_SEED,
+        sparkNetwork: SPARK_NET,
+        sparkScanApiKey: process.env.SPARK_SCAN_API_KEY,
+        sparkUsdtToken: process.env.SPARK_USDT_TOKEN,
+        rlnNodeUrl: RLN_URL,
+        kaleidoswapApiUrl: KALEIDO_URL,
+    });
+    const label = `Spark(${SPARK_NET}) + RLN(${RLN_URL}) + KaleidoSwap(${KALEIDO_URL})`;
+    if (PORT) {
+        const AUTH_TOKEN = process.env.MCP_AUTH_TOKEN ?? null;
+        const httpServer = createHttpServer(async (req, res) => {
+            if (AUTH_TOKEN && req.headers['authorization'] !== `Bearer ${AUTH_TOKEN}`) {
+                res.writeHead(401, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ error: 'Unauthorized' }));
+                return;
+            }
+            const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
+            res.on('close', () => transport.close().catch(() => { }));
+            await server.connect(transport);
+            await transport.handleRequest(req, res);
+        });
+        httpServer.listen(PORT, '0.0.0.0', () => process.stderr.write(`[kaleido-mcp] HTTP on port ${PORT} — ${label}\n`));
+    }
+    else {
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        process.stderr.write(`[kaleido-mcp] stdio connected — ${label}\n`);
+    }
+}
+main().catch(err => {
+    process.stderr.write(`[kaleido-mcp] Fatal: ${err}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/mpp-client.d.ts

@@ -0,0 +1,80 @@
+/**
+ * MPP (Machine Payments Protocol) client.
+ * Implements the Challenge -> Credential -> Receipt flow over HTTP.
+ */
+export type MppMethod = 'lightning' | 'tempo' | 'stripe' | 'card' | (string & {});
+export type MppIntent = 'charge' | 'session' | (string & {});
+/**
+ * Parsed MPP challenge from an HTTP 402 `WWW-Authenticate` header.
+ */
+export interface MppChallenge {
+    id: string;
+    /** @deprecated alias for `id` kept for backwards compatibility */
+    challenge_id: string;
+    url: string;
+    method: MppMethod;
+    intent: MppIntent;
+    amount?: string;
+    currency?: string;
+    description?: string;
+    request?: string;
+    digest?: string;
+    invoice?: string;
+    macaroon?: string;
+    amount_msat?: number;
+    amount_sats?: number;
+    expires_at?: number;
+    raw_header?: string;
+}
+export interface MppCredential {
+    id: string;
+    /** @deprecated alias for `id` */
+    challenge_id?: string;
+    method: MppMethod;
+    intent?: MppIntent;
+    preimage?: string;
+    macaroon?: string;
+    session_id?: string;
+    session_voucher?: string;
+}
+export interface MppReceipt {
+    receipt_id?: string;
+    paid_at?: string;
+    method?: string;
+    amount?: string;
+    currency?: string;
+    amount_msat?: number;
+}
+export interface MppResourceResponse {
+    ok: boolean;
+    status: number;
+    data: unknown;
+    receipt?: MppReceipt;
+    raw_receipt_header?: string;
+}
+export interface MppProblemDetail {
+    type: string;
+    title: string;
+    status: number;
+    detail?: string;
+}
+export declare const MppErrorCode: {
+    readonly PaymentRequired: "payment-required";
+    readonly PaymentInsufficient: "payment-insufficient";
+    readonly PaymentExpired: "payment-expired";
+    readonly VerificationFailed: "verification-failed";
+    readonly MalformedCredential: "malformed-credential";
+    readonly InvalidChallenge: "invalid-challenge";
+};
+export declare class MppClient {
+    requestChallenge(url: string): Promise<MppChallenge>;
+    submitCredential(url: string, credential: MppCredential): Promise<MppResourceResponse>;
+    buildLightningCredential(challenge: MppChallenge, preimage: string): MppCredential;
+    serializeCredential(credential: MppCredential): string;
+    deserializeCredential(raw: string): MppCredential;
+    parseChallenge(url: string, header: string): MppChallenge;
+    private buildPaymentAuthHeader;
+    private parseReceipt;
+    private base64urlDecode;
+    private randomId;
+}

package/dist/mpp-client.js

@@ -0,0 +1,186 @@
+/**
+ * MPP (Machine Payments Protocol) client.
+ * Implements the Challenge -> Credential -> Receipt flow over HTTP.
+ */
+export const MppErrorCode = {
+    PaymentRequired: 'payment-required',
+    PaymentInsufficient: 'payment-insufficient',
+    PaymentExpired: 'payment-expired',
+    VerificationFailed: 'verification-failed',
+    MalformedCredential: 'malformed-credential',
+    InvalidChallenge: 'invalid-challenge',
+};
+export class MppClient {
+    async requestChallenge(url) {
+        let res;
+        try {
+            res = await fetch(url, {
+                method: 'GET',
+                headers: { Accept: 'application/json' },
+            });
+        }
+        catch (err) {
+            throw new Error(`Cannot reach ${url}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        if (res.status !== 402) {
+            throw new Error(`Expected HTTP 402 from ${url}, got ${res.status}. This resource may not be MPP-protected.`);
+        }
+        const authHeader = res.headers.get('WWW-Authenticate');
+        if (!authHeader) {
+            throw new Error(`HTTP 402 received but no WWW-Authenticate header at ${url}`);
+        }
+        return this.parseChallenge(url, authHeader);
+    }
+    async submitCredential(url, credential) {
+        const headers = {
+            Accept: 'application/json',
+            'Payment-Authorization': this.buildPaymentAuthHeader(credential),
+        };
+        if (credential.macaroon && credential.preimage) {
+            headers.Authorization = `L402 ${credential.macaroon}:${credential.preimage}`;
+        }
+        const res = await fetch(url, { method: 'GET', headers });
+        let data;
+        try {
+            const body = await res.text();
+            data = body ? JSON.parse(body) : {};
+        }
+        catch {
+            data = null;
+        }
+        const receiptHeader = res.headers.get('Payment-Receipt');
+        const receipt = receiptHeader ? this.parseReceipt(receiptHeader) : undefined;
+        return {
+            ok: res.ok,
+            status: res.status,
+            data,
+            receipt,
+            raw_receipt_header: receiptHeader ?? undefined,
+        };
+    }
+    buildLightningCredential(challenge, preimage) {
+        return {
+            id: challenge.id,
+            challenge_id: challenge.id,
+            method: 'lightning',
+            intent: challenge.intent,
+            preimage,
+            macaroon: challenge.macaroon,
+        };
+    }
+    serializeCredential(credential) {
+        return JSON.stringify(credential);
+    }
+    deserializeCredential(raw) {
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            throw new Error('Invalid credential format. Expected JSON string from wdk_mpp_pay.');
+        }
+    }
+    parseChallenge(url, header) {
+        const stripped = header.replace(/^Payment\s+/i, '').replace(/^L402\s+/i, '');
+        const params = {};
+        for (const match of stripped.matchAll(/(\w+)=(?:"([^"]*)"|([^\s,]+))/g)) {
+            params[match[1]] = match[2] ?? match[3];
+        }
+        const method = (params.method ?? 'lightning');
+        const intent = (params.intent ?? 'charge');
+        const id = params.id ?? params.challenge_id ?? params.nonce ?? this.randomId();
+        let invoice;
+        let macaroon;
+        let amountMsat;
+        if (params.request) {
+            try {
+                const decoded = JSON.parse(this.base64urlDecode(params.request));
+                invoice = (decoded.invoice ?? decoded.bolt11);
+                macaroon = (decoded.macaroon ?? decoded.token);
+                if (decoded.amount_msat)
+                    amountMsat = Number(decoded.amount_msat);
+            }
+            catch {
+                // Some servers use a non-JSON request payload.
+            }
+        }
+        invoice ??= params.invoice;
+        macaroon ??= params.macaroon ?? params.token;
+        if (!amountMsat && params.amount) {
+            const amount = parseFloat(params.amount);
+            const currency = (params.currency ?? 'sat').toLowerCase();
+            if (currency === 'sat' || currency === 'sats')
+                amountMsat = amount * 1_000;
+            else if (currency === 'msat' || currency === 'msats')
+                amountMsat = amount;
+            else if (currency === 'btc')
+                amountMsat = Math.round(amount * 1e11);
+        }
+        const amountSats = amountMsat ? Math.ceil(amountMsat / 1000) : undefined;
+        return {
+            id,
+            challenge_id: id,
+            url,
+            method,
+            intent,
+            amount: params.amount,
+            currency: params.currency,
+            description: params.description,
+            request: params.request,
+            digest: params.digest,
+            invoice,
+            macaroon,
+            amount_msat: amountMsat,
+            amount_sats: amountSats,
+            expires_at: params.expires_at ? parseInt(params.expires_at, 10) : undefined,
+            raw_header: header,
+        };
+    }
+    buildPaymentAuthHeader(credential) {
+        const id = credential.id ?? credential.challenge_id ?? '';
+        const parts = [
+            `Payment id="${id}"`,
+            `method="${credential.method}"`,
+        ];
+        if (credential.intent)
+            parts.push(`intent="${credential.intent}"`);
+        if (credential.preimage)
+            parts.push(`preimage="${credential.preimage}"`);
+        if (credential.macaroon)
+            parts.push(`macaroon="${credential.macaroon}"`);
+        if (credential.session_id)
+            parts.push(`session_id="${credential.session_id}"`);
+        if (credential.session_voucher)
+            parts.push(`voucher="${credential.session_voucher}"`);
+        return parts.join(', ');
+    }
+    parseReceipt(header) {
+        try {
+            if (header.trim().startsWith('{')) {
+                return JSON.parse(header);
+            }
+            const params = {};
+            for (const match of header.matchAll(/(\w+)=(?:"([^"]*)"|([^\s,]+))/g)) {
+                params[match[1]] = match[2] ?? match[3];
+            }
+            return {
+                receipt_id: params.receipt_id,
+                paid_at: params.paid_at,
+                method: params.method,
+                amount: params.amount,
+                currency: params.currency,
+            };
+        }
+        catch {
+            return {};
+        }
+    }
+    base64urlDecode(input) {
+        const base64 = input.replace(/-/g, '+').replace(/_/g, '/');
+        const padded = base64.padEnd(base64.length + (4 - (base64.length % 4)) % 4, '=');
+        return Buffer.from(padded, 'base64').toString('utf8');
+    }
+    randomId() {
+        return Math.random().toString(36).substring(2, 12);
+    }
+}
+//# sourceMappingURL=mpp-client.js.map

package/dist/mpp-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mpp-client.js","sourceRoot":"","sources":["../src/mpp-client.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,58 @@
+/**
+ * kaleido-mcp — Unified WDK MCP Server
+ *
+ * Assembles a single WdkMcpServer (from @tetherto/wdk-mcp-toolkit) that contains:
+ *
+ *  LAYER 1 — WDK built-in tools (via registerTools):
+ *    • WALLET_TOOLS  — getAddress, getBalance, sendTransaction, transfer,
+ *                      getTokenBalance, quoteSendTransaction, quoteTransfer,
+ *                      getFeeRates, sign, verify  (all scoped to 'spark' chain)
+ *    • PRICING_TOOLS — getCurrentPrice, getHistoricalPrice  (Bitfinex)
+ *
+ *  LAYER 2 — Custom Spark tools (Lightning invoices, BTC bridge, fee-free transfers):
+ *    spark_get_balance, spark_get_address, spark_create_lightning_invoice, spark_pay_lightning_invoice,
+ *    spark_quote_lightning_payment, spark_get_deposit_address,
+ *    spark_quote_withdraw, spark_withdraw, spark_get_transfers,
+ *    spark_send_sats, spark_transfer_token, spark_mpp_pay, spark_get_token_balance
+ *
+ *  LAYER 3 — RLN (RGB Lightning Node) tools:
+ *    wdk_get_node_info, wdk_get_balances, wdk_list_assets, wdk_get_asset_balance,
+ *    wdk_get_address, wdk_create_rgb_invoice, wdk_create_ln_invoice,
+ *    wdk_pay_invoice, wdk_send_btc, wdk_send_asset, wdk_list_channels,
+ *    wdk_connect_peer, wdk_open_channel, wdk_list_payments,
+ *    wdk_refresh_transfers, wdk_atomic_taker, wdk_list_swaps,
+ *    wdk_get_swap, wdk_mpp_pay
+ *
+ *  LAYER 4 — KaleidoSwap DEX tools:
+ *    kaleidoswap_get_assets, kaleidoswap_get_pairs, kaleidoswap_get_quote,
+ *    kaleidoswap_get_spreads, kaleidoswap_place_order, kaleidoswap_get_order_status,
+ *    kaleidoswap_get_open_orders, kaleidoswap_cancel_order, kaleidoswap_get_position,
+ *    kaleidoswap_atomic_init, kaleidoswap_atomic_execute, kaleidoswap_atomic_status,
+ *    kaleidoswap_lsp_get_info, kaleidoswap_lsp_estimate_fees,
+ *    kaleidoswap_lsp_create_order, kaleidoswap_lsp_get_order
+ *
+ *  LAYER 5 — MPP / L402 / 402index.io:
+ *    mpp_request_challenge, mpp_submit_credential, mpp_parse_challenge_header,
+ *    l402_request_challenge, l402_fetch_resource, search_paid_apis
+ *
+ *  LAYER 6 — Market data (CoinGecko / alternative.me):
+ *    l402_get_price, l402_get_market_data, l402_get_ohlcv, l402_get_sentiment
+ *
+ * Legacy aliases are retained temporarily for older `rln_*` and generic `get_*` callers.
+ */
+import { WdkMcpServer } from '@tetherto/wdk-mcp-toolkit';
+export interface KaleidoMcpConfig {
+    /** BIP-39 seed phrase for WDK Spark wallet */
+    wdkSeed: string;
+    /** Spark network (default: MAINNET) */
+    sparkNetwork: 'MAINNET' | 'REGTEST';
+    /** SparkScan API key (optional, for enhanced queries) */
+    sparkScanApiKey?: string;
+    /** Spark USDT token identifier (btkn1...) */
+    sparkUsdtToken?: string;
+    /** RLN node HTTP URL (e.g. http://localhost:3001) */
+    rlnNodeUrl: string;
+    /** KaleidoSwap API base URL */
+    kaleidoswapApiUrl: string;
+}
+export declare function createServer(config: KaleidoMcpConfig): WdkMcpServer;