@xlmtools/cli 0.1.2 → 0.2.1

package/README.md

@@ -1,99 +1,152 @@
 # @xlmtools/cli
 
-XLMTools CLI — the MCP server that runs locally on the user's machine. Handles tool registration, payment signing, budget tracking, and response caching.
+Standalone CLI for XLMTools — 21 pay-per-call tools for AI agents on Stellar. Install it, type `xlm`, and go.
 
-## How it works
+## Install
 
-This package is an MCP stdio server. It's started automatically by Claude, Cursor, or any MCP-compatible host when a user calls a XLMTools tool.
+```bash
+npm install -g @xlmtools/cli
+```
+
+On first run, XLMTools auto-generates a Stellar testnet wallet, funds it with XLM via friendbot, and adds a USDC trustline. The only manual step is grabbing testnet USDC from [faucet.circle.com](https://faucet.circle.com) to use paid tools.
+
+## Usage
 
+```bash
+xlm <tool> [args] [--flag value]
 ```
-MCP Host (Claude, Cursor, Windsurf)
-    |  stdio
-    v
-@xlmtools/cli (this package)
-    |  - 21 tools registered via @modelcontextprotocol/sdk
-    |  - mppx polyfills fetch to auto-handle 402 payments
-    |  - budget enforcement (withBudget)
-    |  - response caching (withCache, 5-min TTL)
-    |
-    |  HTTPS
-    v
-@xlmtools/api (hosted API server)
+
+### Quick examples
+
+```bash
+# Free tools — no cost
+xlm crypto bitcoin,ethereum,stellar
+xlm weather Lagos
+xlm wallet
+xlm oracle-price BTC
+xlm dex-orderbook XLM/USDC --limit 5
+xlm swap-quote XLM USDC 100
+xlm stellar-asset USDC
+xlm domain xlmtools.com
+xlm tools
+
+# Paid tools — USDC charged per call via Stellar MPP
+xlm search "Stellar x402 micropayments" --count 5
+xlm stocks AAPL
+xlm research "Soroban smart contracts" --num-results 3
+xlm youtube "Stellar blockchain"
+xlm scrape https://stellar.org
+xlm screenshot https://xlmtools.com --format png
+xlm image "a stingray gliding over a coral reef at dusk" --size 1024x1024
 ```
 
-## Install (for users)
+Output is JSON. Pipe to `jq` for filtering:
 
 ```bash
-claude mcp add xlmtools npx @xlmtools/cli
+xlm crypto bitcoin | jq '.bitcoin.usd'
 ```
 
-On first run, the CLI:
-1. Generates a Stellar keypair at `~/.xlmtools/config.json`
-2. Funds the wallet with testnet XLM via friendbot (testnet only)
-3. Adds a USDC trustline so the wallet can receive payments
+### All commands
 
-## Development
+**Paid** ($0.001–$0.04 USDC per call, settled on Stellar testnet):
 
-```bash
-# From the monorepo root
-pnpm dev:cli
+| Command | Price | What it does |
+| --- | --- | --- |
+| `xlm search <query> [--count N]` | $0.003 | Web + news search |
+| `xlm research <query> [--num-results N]` | $0.010 | Multi-source deep research |
+| `xlm youtube <query>` or `--id <id>` | $0.002 | Video search or lookup |
+| `xlm screenshot <url> [--format png]` | $0.010 | Capture a URL screenshot |
+| `xlm scrape <url>` | $0.002 | Extract clean text from a URL |
+| `xlm image <prompt> [--size 1024x1024]` | $0.040 | AI image generation |
+| `xlm stocks <symbol>` | $0.001 | Real-time stock quotes |
+
+**Free** (no cost):
+
+| Command | What it does |
+| --- | --- |
+| `xlm crypto <ids> [--vs-currency usd]` | Crypto prices from CoinGecko |
+| `xlm weather <location>` | Current weather for any city |
+| `xlm domain <name>` | Domain availability check |
+| `xlm dex-orderbook <pair> [--limit N]` | Stellar DEX orderbook |
+| `xlm dex-candles <pair> [--resolution 1h] [--limit N]` | OHLCV candlesticks |
+| `xlm dex-trades <pair> [--limit N]` | Recent DEX trades |
+| `xlm swap-quote <from> <to> <amount>` | Best swap path between assets |
+| `xlm stellar-asset <asset>` | Asset info, supply, trustlines |
+| `xlm stellar-account <address>` | Account balances and signers |
+| `xlm stellar-pools [--asset X] [--limit N]` | Liquidity pool data |
+| `xlm oracle-price <asset> [--feed crypto]` | Reflector oracle prices |
+| `xlm wallet` | Your Stellar wallet address + balance |
+| `xlm tools` | List all 21 tools and prices |
+| `xlm --help` | Full help text |
+
+## Payment
+
+Every paid tool call produces a real Stellar testnet transaction. The receipt shows at the bottom of the output:
 
-# Or directly
-cd packages/cli
-pnpm dev
 ```
+Payment: $0.003 USDC · tx/a3f9c28d71e0... · stellar testnet
+```
+
+Verify any payment at [stellar.expert/explorer/testnet](https://stellar.expert/explorer/testnet).
 
-The dev script uses `tsx watch` for hot-reload during development.
+## Wallet
 
-## Build
+Your wallet is at `~/.xlmtools/config.json`. The private key never leaves your machine. Check your balance:
 
 ```bash
-pnpm build
+xlm wallet
 ```
 
-Compiles TypeScript to `dist/`. The compiled entry point is `dist/index.js`.
+Fund with testnet USDC: visit [faucet.circle.com](https://faucet.circle.com), select Stellar, paste your wallet address.
 
-## Architecture
+## Also available as
 
-### Tools (21 total)
+- **MCP server**: `claude mcp add xlmtools npx @xlmtools/mcp` — for Claude Code, Cursor, Cline, VS Code Copilot, Windsurf, and 7+ other MCP hosts. Same wallet, same tools.
+- **Agent Skill**: `pnpm dlx skills add github:Blockchain-Oracle/xlmtools --skill xlmtools` — teaches agents when and how to use each tool.
 
-**Paid** (7) — wrapped with `withCache` + `withBudget`:
-search, research, youtube, screenshot, scrape, image, stocks
+## Links
 
-**Free** (14):
-crypto, weather, domain, wallet, tools, budget, dex-orderbook, dex-candles, dex-trades, swap-quote, stellar-asset, stellar-account, stellar-pools, oracle-price
+- [xlmtools.com](https://xlmtools.com) — website
+- [docs.xlmtools.com](https://docs.xlmtools.com) — full documentation
+- [api.xlmtools.com](https://api.xlmtools.com) — hosted API
+- [GitHub](https://github.com/Blockchain-Oracle/xlmtools) — source code
+- [`@xlmtools/mcp`](https://www.npmjs.com/package/@xlmtools/mcp) — MCP server package
 
-### Key modules
+---
 
-| File | Purpose |
-| --- | --- |
-| `src/index.ts` | Entry point, registers all 21 tools |
-| `src/lib/wallet.ts` | Wallet creation, auto-funding on testnet |
-| `src/lib/budget.ts` | Session budget state, `withBudget()` wrapper |
-| `src/lib/cache.ts` | Response cache, `withCache()` wrapper |
-| `src/lib/format.ts` | `ok()`, `okPaid()`, `err()` response formatters |
-| `src/lib/config.ts` | Tool prices and free tool list |
-| `src/lib/logger.ts` | pino logger (stderr) |
-| `src/tools/*.ts` | One file per tool |
-
-### Payment flow
-
-1. Tool handler calls `fetch(apiUrl/toolname)` with params
-2. API returns `402 Payment Required`
-3. mppx (global fetch polyfill) intercepts the 402
-4. Builds a Soroban SAC USDC transfer using the local Stellar keypair
-5. Signs and retries the request with payment proof
-6. API verifies, executes the tool, returns result with receipt
-7. `okPaid()` strips the receipt and appends a human-readable payment footer
-
-### Budget flow
+## For contributors
+
+This package provides two things:
+
+1. The `xlm` binary (standalone CLI) at `dist/cli.js`
+2. A `createMcpServer()` factory at `dist/server.js` — imported by [`@xlmtools/mcp`](https://www.npmjs.com/package/@xlmtools/mcp) to power the MCP stdio server
 
+### Development
+
+```bash
+pnpm dev:cli    # from monorepo root
+# or
+cd packages/cli && pnpm dev
 ```
-withCache(tool, params, () =>
-  withBudget(tool, async () => {
-    // API call
-  })
-)
+
+### Build
+
+```bash
+pnpm build
 ```
 
-Cache is checked first (hit = free). Budget is checked second (over limit = blocked). API call happens last. Only successful calls are charged and cached.
+### Key files
+
+| File | Purpose |
+| --- | --- |
+| `src/cli.ts` | Standalone `xlm` binary — arg parsing, URL building, response printing |
+| `src/server.ts` | `createMcpServer()` factory — registers all 21 tools on a fresh McpServer |
+| `src/lib/wallet.ts` | Wallet creation, testnet auto-funding |
+| `src/lib/api-fetch.ts` | Shared fetch with `X-XLMTools-Client` header for stats attribution |
+| `src/lib/budget.ts` | Session budget cap (`withBudget()` wrapper) |
+| `src/lib/cache.ts` | 5-min response cache (`withCache()` wrapper) |
+| `src/tools/*.ts` | One file per tool — each calls `server.registerTool(...)` |
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/{src/lib/api-fetch.ts → dist/lib/api-fetch.d.ts}

@@ -12,19 +12,8 @@
  *   const config = loadOrCreateWallet();
  *   const res = await apiFetch(config, `/crypto?ids=${ids}`);
  */
-
 export interface ClientConfig {
-  apiUrl: string;
-  stellarPublicKey: string;
-}
-
-export async function apiFetch(
-  config: ClientConfig,
-  path: string,
-  init?: RequestInit,
-): Promise<Response> {
-  const url = path.startsWith("http") ? path : `${config.apiUrl}${path}`;
-  const headers = new Headers(init?.headers);
-  headers.set("X-XLMTools-Client", config.stellarPublicKey);
-  return fetch(url, { ...init, headers });
+    apiUrl: string;
+    stellarPublicKey: string;
 }
+export declare function apiFetch(config: ClientConfig, path: string, init?: RequestInit): Promise<Response>;

package/dist/lib/budget.d.ts

@@ -0,0 +1,14 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+export declare function setBudget(max: number): void;
+export declare function clearBudget(): void;
+export declare function getStatus(): {
+    max: number | null;
+    spent: number;
+    remaining: number | null;
+};
+/**
+ * Wrap a paid tool call with budget checking.
+ * If budget would be exceeded, returns an error without calling the API.
+ * On success, records the spend.
+ */
+export declare function withBudget(toolName: string, fn: () => Promise<CallToolResult>): Promise<CallToolResult>;

package/dist/lib/cache.d.ts

@@ -0,0 +1,7 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+/**
+ * Wrap a tool call with response caching.
+ * Identical tool+params within the TTL return the cached result
+ * with no API call and no payment.
+ */
+export declare function withCache(toolName: string, params: Record<string, unknown>, fn: () => Promise<CallToolResult>): Promise<CallToolResult>;

package/dist/lib/config.d.ts

@@ -0,0 +1,2 @@
+export declare const TOOL_PRICES: Record<string, string>;
+export declare const FREE_TOOLS: Set<string>;

package/dist/lib/format.d.ts

@@ -0,0 +1,15 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+export interface ReceiptInfo {
+    tx_hash: string;
+    amount: string;
+    currency: string;
+    network: string;
+}
+export declare function ok(data: unknown): CallToolResult;
+/**
+ * Format a paid tool response, appending a receipt line if present.
+ * Strips the receipt from the data to avoid cluttering the JSON output,
+ * then appends a human-readable payment line.
+ */
+export declare function okPaid(data: Record<string, unknown>): CallToolResult;
+export declare function err(message: string): CallToolResult;

package/dist/lib/logger.d.ts

@@ -0,0 +1,2 @@
+import pino from "pino";
+export declare const logger: pino.Logger<never, boolean>;

package/dist/lib/wallet.d.ts

@@ -0,0 +1,9 @@
+import { Keypair } from "@stellar/stellar-sdk";
+interface XLMToolsConfig {
+    stellarPrivateKey: string;
+    stellarPublicKey: string;
+    apiUrl: string;
+}
+export declare function loadOrCreateWallet(): XLMToolsConfig;
+export declare function getKeypair(config: XLMToolsConfig): Keypair;
+export {};

package/dist/server.d.ts

@@ -0,0 +1,22 @@
+/**
+ * XLMTools MCP server factory.
+ *
+ * Builds and returns a fully-registered `McpServer` instance —
+ * without connecting any transport. Consumers are responsible for
+ * choosing the transport and calling `server.connect(transport)`.
+ *
+ * Currently used by `@xlmtools/mcp` (stdio transport wrapper).
+ * Could also be used to host over HTTP/SSE in the future by wiring
+ * a different transport.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Build a fully-configured XLMTools MCP server with all 21 tools
+ * registered. The caller must connect a transport.
+ *
+ * Side effects on first call:
+ *   - Loads or creates the user's Stellar wallet at ~/.xlmtools/config.json
+ *   - Initializes Mppx with a Stellar charge method (polyfills fetch
+ *     to auto-handle 402 payment challenges)
+ */
+export declare function createMcpServer(): McpServer;

package/dist/server.js

@@ -0,0 +1,89 @@
+/**
+ * XLMTools MCP server factory.
+ *
+ * Builds and returns a fully-registered `McpServer` instance —
+ * without connecting any transport. Consumers are responsible for
+ * choosing the transport and calling `server.connect(transport)`.
+ *
+ * Currently used by `@xlmtools/mcp` (stdio transport wrapper).
+ * Could also be used to host over HTTP/SSE in the future by wiring
+ * a different transport.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { Mppx } from "mppx/client";
+import { stellar } from "@stellar/mpp/charge/client";
+import { loadOrCreateWallet, getKeypair } from "./lib/wallet.js";
+import { logger } from "./lib/logger.js";
+import { registerCryptoTool } from "./tools/crypto.js";
+import { registerWeatherTool } from "./tools/weather.js";
+import { registerDomainTool } from "./tools/domain.js";
+import { registerToolsListTool } from "./tools/tools-list.js";
+import { registerWalletTool } from "./tools/wallet-tool.js";
+import { registerSearchTool } from "./tools/search.js";
+import { registerResearchTool } from "./tools/research.js";
+import { registerYoutubeTool } from "./tools/youtube.js";
+import { registerScreenshotTool } from "./tools/screenshot.js";
+import { registerScrapeTool } from "./tools/scrape.js";
+import { registerImageTool } from "./tools/image.js";
+import { registerStocksTool } from "./tools/stocks.js";
+import { registerDexOrderbookTool } from "./tools/dex-orderbook.js";
+import { registerDexCandlesTool } from "./tools/dex-candles.js";
+import { registerDexTradesTool } from "./tools/dex-trades.js";
+import { registerSwapQuoteTool } from "./tools/swap-quote.js";
+import { registerStellarAssetTool } from "./tools/stellar-asset.js";
+import { registerStellarAccountTool } from "./tools/stellar-account.js";
+import { registerStellarPoolsTool } from "./tools/stellar-pools.js";
+import { registerOraclePriceTool } from "./tools/oracle-price.js";
+import { registerBudgetTool } from "./tools/budget.js";
+/**
+ * Build a fully-configured XLMTools MCP server with all 21 tools
+ * registered. The caller must connect a transport.
+ *
+ * Side effects on first call:
+ *   - Loads or creates the user's Stellar wallet at ~/.xlmtools/config.json
+ *   - Initializes Mppx with a Stellar charge method (polyfills fetch
+ *     to auto-handle 402 payment challenges)
+ */
+export function createMcpServer() {
+    const config = loadOrCreateWallet();
+    const keypair = getKeypair(config);
+    // Mppx polyfills global fetch to auto-handle 402 payments
+    Mppx.create({
+        methods: [
+            stellar.charge({
+                keypair,
+                mode: "pull",
+                onProgress(event) {
+                    logger.debug({ eventType: event.type }, "MPP payment event");
+                },
+            }),
+        ],
+    });
+    // { logging: {} } enables ctx.mcpReq.log() in tool handlers
+    const server = new McpServer({ name: "xlmtools", version: "0.2.0" }, { capabilities: { tools: {}, logging: {} } });
+    // Free tools
+    registerCryptoTool(server);
+    registerWeatherTool(server);
+    registerDomainTool(server);
+    registerToolsListTool(server);
+    registerWalletTool(server);
+    registerBudgetTool(server);
+    // Paid tools
+    registerSearchTool(server);
+    registerResearchTool(server);
+    registerYoutubeTool(server);
+    registerScreenshotTool(server);
+    registerScrapeTool(server);
+    registerImageTool(server);
+    registerStocksTool(server);
+    // Stellar-native tools (free)
+    registerDexOrderbookTool(server);
+    registerDexCandlesTool(server);
+    registerDexTradesTool(server);
+    registerSwapQuoteTool(server);
+    registerStellarAssetTool(server);
+    registerStellarAccountTool(server);
+    registerStellarPoolsTool(server);
+    registerOraclePriceTool(server);
+    return server;
+}

package/dist/tools/budget.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerBudgetTool(server: McpServer): void;

package/dist/tools/crypto.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerCryptoTool(server: McpServer): void;

package/dist/tools/dex-candles.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerDexCandlesTool(server: McpServer): void;

package/dist/tools/dex-orderbook.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerDexOrderbookTool(server: McpServer): void;

package/dist/tools/dex-trades.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerDexTradesTool(server: McpServer): void;

package/dist/tools/domain.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerDomainTool(server: McpServer): void;

package/dist/tools/image.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerImageTool(server: McpServer): void;

package/dist/tools/oracle-price.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerOraclePriceTool(server: McpServer): void;

package/dist/tools/research.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerResearchTool(server: McpServer): void;

package/dist/tools/scrape.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerScrapeTool(server: McpServer): void;

package/dist/tools/screenshot.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerScreenshotTool(server: McpServer): void;

package/dist/tools/search.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSearchTool(server: McpServer): void;

package/dist/tools/stellar-account.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerStellarAccountTool(server: McpServer): void;

package/dist/tools/stellar-asset.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerStellarAssetTool(server: McpServer): void;

package/dist/tools/stellar-pools.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerStellarPoolsTool(server: McpServer): void;

package/dist/tools/stocks.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerStocksTool(server: McpServer): void;

package/dist/tools/swap-quote.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSwapQuoteTool(server: McpServer): void;

package/dist/tools/tools-list.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerToolsListTool(server: McpServer): void;

package/dist/tools/wallet-tool.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerWalletTool(server: McpServer): void;

package/dist/tools/weather.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerWeatherTool(server: McpServer): void;

package/dist/tools/youtube.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerYoutubeTool(server: McpServer): void;

package/package.json

@@ -1,16 +1,17 @@
 {
   "name": "@xlmtools/cli",
-  "version": "0.1.2",
+  "version": "0.2.1",
+  "description": "XLMTools standalone CLI — the `xlm` command plus the `createMcpServer` factory used by the @xlmtools/mcp wrapper package.",
   "type": "module",
   "bin": {
-    "xlmtools": "dist/index.js",
     "xlm": "dist/cli.js"
   },
-  "scripts": {
-    "dev": "tsx watch src/index.ts",
-    "build": "tsc",
-    "test": "vitest run"
-  },
+  "main": "./dist/server.js",
+  "types": "./dist/server.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@stellar/mpp": "^0.4.0",
@@ -24,5 +25,28 @@
     "tsx": "^4.21.0",
     "typescript": "^6.0.2",
     "vitest": "^4.1.2"
+  },
+  "keywords": [
+    "stellar",
+    "xlm",
+    "cli",
+    "soroban",
+    "mpp",
+    "x402",
+    "agent-tools"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Blockchain-Oracle/xlmtools.git",
+    "directory": "packages/cli"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "dev": "tsx watch src/cli.ts",
+    "build": "tsc",
+    "test": "vitest run"
   }
-}
+}

package/dist/index.js

@@ -1,77 +0,0 @@
-#!/usr/bin/env node
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { Mppx } from "mppx/client";
-import { stellar } from "@stellar/mpp/charge/client";
-import { loadOrCreateWallet, getKeypair } from "./lib/wallet.js";
-import { logger } from "./lib/logger.js";
-import { registerCryptoTool } from "./tools/crypto.js";
-import { registerWeatherTool } from "./tools/weather.js";
-import { registerDomainTool } from "./tools/domain.js";
-import { registerToolsListTool } from "./tools/tools-list.js";
-import { registerWalletTool } from "./tools/wallet-tool.js";
-import { registerSearchTool } from "./tools/search.js";
-import { registerResearchTool } from "./tools/research.js";
-import { registerYoutubeTool } from "./tools/youtube.js";
-import { registerScreenshotTool } from "./tools/screenshot.js";
-import { registerScrapeTool } from "./tools/scrape.js";
-import { registerImageTool } from "./tools/image.js";
-import { registerStocksTool } from "./tools/stocks.js";
-import { registerDexOrderbookTool } from "./tools/dex-orderbook.js";
-import { registerDexCandlesTool } from "./tools/dex-candles.js";
-import { registerDexTradesTool } from "./tools/dex-trades.js";
-import { registerSwapQuoteTool } from "./tools/swap-quote.js";
-import { registerStellarAssetTool } from "./tools/stellar-asset.js";
-import { registerStellarAccountTool } from "./tools/stellar-account.js";
-import { registerStellarPoolsTool } from "./tools/stellar-pools.js";
-import { registerOraclePriceTool } from "./tools/oracle-price.js";
-import { registerBudgetTool } from "./tools/budget.js";
-const config = loadOrCreateWallet();
-const keypair = getKeypair(config);
-// Mppx polyfills global fetch to auto-handle 402 payments
-Mppx.create({
-    methods: [
-        stellar.charge({
-            keypair,
-            mode: "pull",
-            onProgress(event) {
-                logger.debug({ eventType: event.type }, "MPP payment event");
-            },
-        }),
-    ],
-});
-// { logging: {} } enables ctx.mcpReq.log() in tool handlers
-const server = new McpServer({ name: "xlmtools", version: "0.1.0" }, { capabilities: { tools: {}, logging: {} } });
-// Free tools
-registerCryptoTool(server);
-registerWeatherTool(server);
-registerDomainTool(server);
-registerToolsListTool(server);
-registerWalletTool(server);
-registerBudgetTool(server);
-// Paid tools
-registerSearchTool(server);
-registerResearchTool(server);
-registerYoutubeTool(server);
-registerScreenshotTool(server);
-registerScrapeTool(server);
-registerImageTool(server);
-registerStocksTool(server);
-// Stellar-native tools (free)
-registerDexOrderbookTool(server);
-registerDexCandlesTool(server);
-registerDexTradesTool(server);
-registerSwapQuoteTool(server);
-registerStellarAssetTool(server);
-registerStellarAccountTool(server);
-registerStellarPoolsTool(server);
-registerOraclePriceTool(server);
-async function main() {
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-    logger.info("XLMTools MCP server running");
-}
-main().catch((error) => {
-    logger.error({ err: error }, "Fatal error");
-    process.exit(1);
-});