@xlmtools/cli 0.1.2 → 0.2.0

package/src/tools/search.ts

@@ -1,49 +0,0 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z } from "zod";
-import { loadOrCreateWallet } from "../lib/wallet.js";
-import { apiFetch } from "../lib/api-fetch.js";
-import { okPaid, err } from "../lib/format.js";
-import { logger } from "../lib/logger.js";
-import { TOOL_PRICES } from "../lib/config.js";
-import { withBudget } from "../lib/budget.js";
-import { withCache } from "../lib/cache.js";
-
-export function registerSearchTool(server: McpServer): void {
-  server.registerTool(
-    "search",
-    {
-      title: "Web Search",
-      description: `Search the web and news in real-time. Returns results with source URLs.\nCost: $${TOOL_PRICES.search} USDC per search (paid via Stellar MPP).`,      inputSchema: z.object({
-        query: z.string().describe("Search query"),
-        count: z.coerce.number()
-          .int()
-          .min(1)
-          .max(20)
-          .default(10)
-          .describe("Number of results (1-20)"),
-      }),
-    },
-    async ({ query, count }) => {
-      logger.debug({ query, count }, "search tool invoked");
-      return withCache("search", { query, count }, () =>
-        withBudget("search", async () => {
-          try {
-            const config = loadOrCreateWallet();
-            const res = await apiFetch(
-              config,
-              `/search?q=${encodeURIComponent(query)}&count=${count}`,
-            );
-            if (!res.ok) {
-              const body = await res.text();
-              return err(`Search API error ${res.status}: ${body}`);
-            }
-            return okPaid(await res.json());
-          } catch (e: unknown) {
-            logger.error({ err: e }, "search tool error");
-            return err(`Search failed: ${String(e)}`);
-          }
-        }),
-      );
-    },
-  );
-}

package/src/tools/stellar-account.ts

@@ -1,40 +0,0 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z } from "zod";
-import { loadOrCreateWallet } from "../lib/wallet.js";
-import { apiFetch } from "../lib/api-fetch.js";
-import { ok, err } from "../lib/format.js";
-import { logger } from "../lib/logger.js";
-
-export function registerStellarAccountTool(server: McpServer): void {
-  server.registerTool(
-    "stellar-account",
-    {
-      title: "Stellar Account Lookup",
-      description:
-        `Look up any Stellar account: balances, trustlines, signers, and status.\n` +
-        `Provide a Stellar public key (starts with G, 56 characters).\nFree.`,      inputSchema: z.object({
-        address: z
-          .string()
-          .describe("Stellar public key (G-address)"),
-      }),
-    },
-    async ({ address }) => {
-      logger.debug({ address }, "stellar-account invoked");
-      try {
-        const config = loadOrCreateWallet();
-        const res = await apiFetch(
-          config,
-          `/stellar-account?address=${encodeURIComponent(address)}`,
-        );
-        if (!res.ok) {
-          const body = await res.text();
-          return err(`Account lookup error ${res.status}: ${body}`);
-        }
-        return ok(await res.json());
-      } catch (e) {
-        logger.error({ err: e }, "stellar-account error");
-        return err(`Account lookup failed: ${String(e)}`);
-      }
-    }
-  );
-}

package/src/tools/stellar-asset.ts

@@ -1,41 +0,0 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z } from "zod";
-import { loadOrCreateWallet } from "../lib/wallet.js";
-import { apiFetch } from "../lib/api-fetch.js";
-import { ok, err } from "../lib/format.js";
-import { logger } from "../lib/logger.js";
-
-export function registerStellarAssetTool(server: McpServer): void {
-  server.registerTool(
-    "stellar-asset",
-    {
-      title: "Stellar Asset Info",
-      description:
-        `Look up any Stellar asset: supply, trustlines, rating, issuer org, and more.\n` +
-        `Combines on-chain data (Horizon) with analytics (StellarExpert).\n` +
-        `Examples: "USDC", "AQUA", "yUSDC", or "CODE:ISSUER".\nFree.`,      inputSchema: z.object({
-        asset: z
-          .string()
-          .describe('Asset to look up (e.g. "USDC", "XLM", "AQUA", "CODE:ISSUER")'),
-      }),
-    },
-    async ({ asset }) => {
-      logger.debug({ asset }, "stellar-asset invoked");
-      try {
-        const config = loadOrCreateWallet();
-        const res = await apiFetch(
-          config,
-          `/stellar-asset?asset=${encodeURIComponent(asset)}`,
-        );
-        if (!res.ok) {
-          const body = await res.text();
-          return err(`Asset lookup error ${res.status}: ${body}`);
-        }
-        return ok(await res.json());
-      } catch (e) {
-        logger.error({ err: e }, "stellar-asset error");
-        return err(`Asset lookup failed: ${String(e)}`);
-      }
-    }
-  );
-}

package/src/tools/stellar-pools.ts

@@ -1,46 +0,0 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z } from "zod";
-import { loadOrCreateWallet } from "../lib/wallet.js";
-import { apiFetch } from "../lib/api-fetch.js";
-import { ok, err } from "../lib/format.js";
-import { logger } from "../lib/logger.js";
-
-export function registerStellarPoolsTool(server: McpServer): void {
-  server.registerTool(
-    "stellar-pools",
-    {
-      title: "Stellar Liquidity Pools",
-      description:
-        `Browse Stellar liquidity pools. Optionally filter by asset.\n` +
-        `Shows reserves, shares, trustlines, and fees.\nFree.`,      inputSchema: z.object({
-        asset: z
-          .string()
-          .optional()
-          .describe('Filter by asset (e.g. "XLM", "USDC"). Omit for all pools.'),
-        limit: z.coerce.number()
-          .int()
-          .min(1)
-          .max(200)
-          .default(10)
-          .describe("Number of pools (1-200)"),
-      }),
-    },
-    async ({ asset, limit }) => {
-      logger.debug({ asset, limit }, "stellar-pools invoked");
-      try {
-        const config = loadOrCreateWallet();
-        const params = new URLSearchParams({ limit: String(limit) });
-        if (asset) params.set("asset", asset);
-        const res = await apiFetch(config, `/stellar-pools?${params}`);
-        if (!res.ok) {
-          const body = await res.text();
-          return err(`Pools error ${res.status}: ${body}`);
-        }
-        return ok(await res.json());
-      } catch (e) {
-        logger.error({ err: e }, "stellar-pools error");
-        return err(`Pools failed: ${String(e)}`);
-      }
-    }
-  );
-}

package/src/tools/stocks.ts

@@ -1,45 +0,0 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z } from "zod";
-import { loadOrCreateWallet } from "../lib/wallet.js";
-import { apiFetch } from "../lib/api-fetch.js";
-import { okPaid, err } from "../lib/format.js";
-import { logger } from "../lib/logger.js";
-import { TOOL_PRICES } from "../lib/config.js";
-import { withBudget } from "../lib/budget.js";
-import { withCache } from "../lib/cache.js";
-
-export function registerStocksTool(server: McpServer): void {
-  server.registerTool(
-    "stocks",
-    {
-      title: "Stock Quotes",
-      description: `Get real-time stock price and market data for any ticker symbol.\nCost: $${TOOL_PRICES.stocks} USDC per query (paid via Stellar MPP).`,      inputSchema: z.object({
-        symbol: z
-          .string()
-          .describe("Stock ticker symbol (e.g. AAPL, TSLA, MSFT)"),
-      }),
-    },
-    async ({ symbol }) => {
-      logger.debug({ symbol }, "stocks tool invoked");
-      return withCache("stocks", { symbol }, () =>
-        withBudget("stocks", async () => {
-          try {
-            const config = loadOrCreateWallet();
-            const res = await apiFetch(
-              config,
-              `/stocks?symbol=${encodeURIComponent(symbol)}`,
-            );
-            if (!res.ok) {
-              const body = await res.text();
-              return err(`Stocks API error ${res.status}: ${body}`);
-            }
-            return okPaid(await res.json());
-          } catch (e: unknown) {
-            logger.error({ err: e }, "stocks tool error");
-            return err(`Stocks query failed: ${String(e)}`);
-          }
-        }),
-      );
-    },
-  );
-}

package/src/tools/swap-quote.ts

@@ -1,44 +0,0 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z } from "zod";
-import { loadOrCreateWallet } from "../lib/wallet.js";
-import { apiFetch } from "../lib/api-fetch.js";
-import { ok, err } from "../lib/format.js";
-import { logger } from "../lib/logger.js";
-
-export function registerSwapQuoteTool(server: McpServer): void {
-  server.registerTool(
-    "swap-quote",
-    {
-      title: "Stellar Swap Quote",
-      description:
-        `Find the best swap path between any two Stellar assets using the native DEX.\n` +
-        `Shows rate, path hops, and slippage tips.\n` +
-        `Examples: swap 100 XLM to USDC, swap 50 USDC to EURC.\n` +
-        `Well-known assets: XLM, USDC, EURC, AQUA, yUSDC, BLND, SHX.\nFree.`,      inputSchema: z.object({
-        from: z.string().describe('Source asset (e.g. "XLM", "USDC")'),
-        to: z.string().describe('Destination asset (e.g. "USDC", "EURC")'),
-        amount: z.string().describe("Amount to swap"),
-        mode: z
-          .enum(["send", "receive"])
-          .default("send")
-          .describe('"send" = you fix what you send; "receive" = you fix what you get'),
-      }),
-    },
-    async ({ from, to, amount, mode }) => {
-      logger.debug({ from, to, amount, mode }, "swap-quote invoked");
-      try {
-        const config = loadOrCreateWallet();
-        const params = new URLSearchParams({ from, to, amount, mode });
-        const res = await apiFetch(config, `/swap-quote?${params}`);
-        if (!res.ok) {
-          const body = await res.text();
-          return err(`Swap quote error ${res.status}: ${body}`);
-        }
-        return ok(await res.json());
-      } catch (e) {
-        logger.error({ err: e }, "swap-quote error");
-        return err(`Swap quote failed: ${String(e)}`);
-      }
-    }
-  );
-}

package/src/tools/tools-list.ts

@@ -1,22 +0,0 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z } from "zod";
-import { TOOL_PRICES, FREE_TOOLS } from "../lib/config.js";
-import { ok } from "../lib/format.js";
-
-export function registerToolsListTool(server: McpServer): void {
-  server.registerTool(
-    "tools",
-    {
-      title: "List Tools",
-      description: "List all XLMTools tools with their per-call cost in USDC.",      inputSchema: z.object({}),
-    },
-    async () => {
-      return ok({
-        paid: Object.entries(TOOL_PRICES).map(([tool, cost]) => ({ tool, cost_usdc: cost })),
-        free: Array.from(FREE_TOOLS),
-        network: "stellar:testnet",
-        payment: "MPP charge mode — USDC auto-deducted per call",
-      });
-    }
-  );
-}

package/src/tools/wallet-tool.ts

@@ -1,51 +0,0 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z } from "zod";
-import { Horizon } from "@stellar/stellar-sdk";
-import { loadOrCreateWallet } from "../lib/wallet.js";
-import { ok, err } from "../lib/format.js";
-import { logger } from "../lib/logger.js";
-
-export function registerWalletTool(server: McpServer): void {
-  server.registerTool(
-    "wallet",
-    {
-      title: "XLMTools Wallet",
-      description:
-        "Show your Stellar wallet address, current USDC balance, and how to fund it. Free.",      inputSchema: z.object({}),
-    },
-    async () => {
-      logger.debug("wallet tool invoked");
-      try {
-        const config = loadOrCreateWallet();
-        const horizon = new Horizon.Server(
-          "https://horizon-testnet.stellar.org"
-        );
-        const account = await horizon.loadAccount(config.stellarPublicKey);
-
-        const xlm = account.balances.find(
-          (b) => b.asset_type === "native"
-        );
-        const usdc = account.balances.find(
-          (b) =>
-            b.asset_type === "credit_alphanum4" &&
-            (b as { asset_code?: string }).asset_code === "USDC"
-        );
-
-        return ok({
-          address: config.stellarPublicKey,
-          xlm_balance: xlm?.balance ?? "0",
-          usdc_balance:
-            usdc?.balance ?? "0 (no USDC trustline yet)",
-          fund_instructions: [
-            "1. Get testnet XLM: https://lab.stellar.org/account/fund",
-            "2. Get testnet USDC: https://faucet.circle.com (select Stellar Testnet)",
-            `3. Send USDC to: ${config.stellarPublicKey}`,
-          ],
-        });
-      } catch (e: unknown) {
-        logger.error({ err: e }, "wallet tool error");
-        return err(`Failed to load account: ${String(e)}`);
-      }
-    }
-  );
-}

package/src/tools/weather.ts

@@ -1,25 +0,0 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z } from "zod";
-import { loadOrCreateWallet } from "../lib/wallet.js";
-import { apiFetch } from "../lib/api-fetch.js";
-import { ok, err } from "../lib/format.js";
-
-export function registerWeatherTool(server: McpServer): void {
-  server.registerTool(
-    "weather",
-    {
-      title: "Weather",
-      description: "Current weather and conditions for any city. Free.",      inputSchema: z.object({
-        location: z.string().describe("City name (e.g. Lagos, London, New York)"),
-      }),
-    },
-    async ({ location }) => {
-      try {
-        const config = loadOrCreateWallet();
-        const res = await apiFetch(config, `/weather?location=${encodeURIComponent(location)}`);
-        if (!res.ok) return err(`Weather API error: ${res.status}`);
-        return ok(await res.json());
-      } catch (e) { return err(String(e)); }
-    }
-  );
-}

package/src/tools/youtube.ts

@@ -1,51 +0,0 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z } from "zod";
-import { loadOrCreateWallet } from "../lib/wallet.js";
-import { apiFetch } from "../lib/api-fetch.js";
-import { okPaid, err } from "../lib/format.js";
-import { logger } from "../lib/logger.js";
-import { TOOL_PRICES } from "../lib/config.js";
-import { withBudget } from "../lib/budget.js";
-import { withCache } from "../lib/cache.js";
-
-export function registerYoutubeTool(server: McpServer): void {
-  server.registerTool(
-    "youtube",
-    {
-      title: "YouTube Search / Lookup",
-      description: `Search YouTube videos or look up a specific video by ID. Provide either query or id.\nCost: $${TOOL_PRICES.youtube} USDC per call (paid via Stellar MPP).`,      inputSchema: z.object({
-        query: z.string().optional().describe("Search query to find videos"),
-        id: z.string().optional().describe("YouTube video ID for direct lookup"),
-      }),
-    },
-    async ({ query, id }) => {
-      logger.debug({ query, id }, "youtube tool invoked");
-      if (!query && !id) {
-        return err("Provide either query or id");
-      }
-      const params: Record<string, unknown> = { query, id };
-      return withCache("youtube", params, () =>
-        withBudget("youtube", async () => {
-          try {
-            const config = loadOrCreateWallet();
-            const qs = new URLSearchParams();
-            if (query) qs.set("q", query);
-            if (id) qs.set("id", id);
-            const res = await apiFetch(
-              config,
-              `/youtube?${qs.toString()}`,
-            );
-            if (!res.ok) {
-              const body = await res.text();
-              return err(`YouTube API error ${res.status}: ${body}`);
-            }
-            return okPaid(await res.json());
-          } catch (e: unknown) {
-            logger.error({ err: e }, "youtube tool error");
-            return err(`YouTube lookup failed: ${String(e)}`);
-          }
-        }),
-      );
-    },
-  );
-}

package/tsconfig.json

@@ -1,13 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "outDir": "dist",
-    "rootDir": "src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true
-  },
-  "include": ["src"]
-}