@xlmtools/cli 0.1.1 → 0.2.0

package/README.md

@@ -1,30 +1,36 @@
 # @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.
+XLMTools CLI — the universal standalone CLI that runs on the user's machine. Provides the `xlm` binary for direct terminal use and exports the `createMcpServer()` factory that powers the `@xlmtools/mcp` stdio server. Handles tool registration, payment signing, budget tracking, and response caching.
 
 ## How it works
 
-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.
+This package ships two things:
+
+1. A standalone `xlm` binary — the universal path. Any agent host with a Bash tool can invoke XLMTools by shelling out to `xlm <tool> <args>`.
+2. A `createMcpServer()` factory exported from `main`/`types` — consumed by the sibling `@xlmtools/mcp` package, which wraps it in a thin stdio adapter for MCP-capable hosts.
 
 ```
-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)
+Agent host
     |
-    |  HTTPS
+    |--  Bash tool  --> xlm (this package's bin)
+    |
+    |--  MCP stdio  --> @xlmtools/mcp ──> imports createMcpServer() from @xlmtools/cli
     v
 @xlmtools/api (hosted API server)
+    - 21 tools registered via @modelcontextprotocol/sdk
+    - mppx polyfills fetch to auto-handle 402 payments
+    - budget enforcement (withBudget)
+    - response caching (withCache, 5-min TTL)
 ```
 
 ## Install (for users)
 
 ```bash
-claude mcp add xlmtools npx @xlmtools/cli
+# Standalone CLI (universal — works with any agent host that has Bash)
+npm install -g @xlmtools/cli
+
+# MCP server (optional fast-path — install the sibling package)
+claude mcp add xlmtools npx @xlmtools/mcp
 ```
 
 On first run, the CLI:

package/dist/cli.d.ts

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

package/dist/cli.js

@@ -3,6 +3,7 @@ import { Mppx } from "mppx/client";
 import { stellar } from "@stellar/mpp/charge/client";
 import { Horizon } from "@stellar/stellar-sdk";
 import { loadOrCreateWallet, getKeypair } from "./lib/wallet.js";
+import { apiFetch } from "./lib/api-fetch.js";
 import { TOOL_PRICES } from "./lib/config.js";
 import { logger } from "./lib/logger.js";
 // ── Arg parsing ──────────────────────────────────────────
@@ -190,7 +191,11 @@ async function main() {
     if (isPaid) {
         process.stderr.write(`  Tool: ${tool} · Cost: $${TOOL_PRICES[tool]} USDC\n`);
     }
-    const res = await fetch(url, init);
+    // Route through apiFetch so the X-XLMTools-Client header (and any
+    // future cross-cutting concerns like retries / user-agent) are
+    // applied consistently with the MCP tools. apiFetch detects the
+    // full-URL form and passes it straight through.
+    const res = await apiFetch(config, url, init);
     if (!res.ok) {
         const text = await res.text();
         process.stderr.write(`Error ${res.status}: ${text}\n`);

package/dist/lib/api-fetch.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Shared fetch helper for tool calls against the XLMTools API.
+ *
+ * Every API request gets stamped with `X-XLMTools-Client: <G-address>`
+ * so the server can attribute calls back to the user's wallet on the
+ * /stats/by-client endpoint. The header is self-declared (no signature)
+ * which is fine because:
+ *   - Paid calls are additionally verified by the Stellar tx receipt
+ *   - Free calls have no economic value to spoof
+ *
+ * Usage:
+ *   const config = loadOrCreateWallet();
+ *   const res = await apiFetch(config, `/crypto?ids=${ids}`);
+ */
+export interface ClientConfig {
+    apiUrl: string;
+    stellarPublicKey: string;
+}
+export declare function apiFetch(config: ClientConfig, path: string, init?: RequestInit): Promise<Response>;

package/dist/lib/api-fetch.js

@@ -0,0 +1,20 @@
+/**
+ * Shared fetch helper for tool calls against the XLMTools API.
+ *
+ * Every API request gets stamped with `X-XLMTools-Client: <G-address>`
+ * so the server can attribute calls back to the user's wallet on the
+ * /stats/by-client endpoint. The header is self-declared (no signature)
+ * which is fine because:
+ *   - Paid calls are additionally verified by the Stellar tx receipt
+ *   - Free calls have no economic value to spoof
+ *
+ * Usage:
+ *   const config = loadOrCreateWallet();
+ *   const res = await apiFetch(config, `/crypto?ids=${ids}`);
+ */
+export async function apiFetch(config, path, init) {
+    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 });
+}

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/crypto.js

@@ -1,5 +1,6 @@
 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 registerCryptoTool(server) {
     server.registerTool("crypto", {
@@ -11,7 +12,7 @@ export function registerCryptoTool(server) {
     }, async ({ ids, vs_currency }) => {
         try {
             const config = loadOrCreateWallet();
-            const res = await fetch(`${config.apiUrl}/crypto?ids=${encodeURIComponent(ids)}&vs_currency=${vs_currency}`);
+            const res = await apiFetch(config, `/crypto?ids=${encodeURIComponent(ids)}&vs_currency=${vs_currency}`);
             if (!res.ok)
                 return err(`Crypto API error: ${res.status}`);
             return ok(await res.json());

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-candles.js

@@ -1,5 +1,6 @@
 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 registerDexCandlesTool(server) {
@@ -31,7 +32,7 @@ export function registerDexCandlesTool(server) {
                 resolution,
                 limit: String(limit),
             });
-            const res = await fetch(`${config.apiUrl}/dex-candles?${params}`);
+            const res = await apiFetch(config, `/dex-candles?${params}`);
             if (!res.ok) {
                 const body = await res.text();
                 return err(`Candles error ${res.status}: ${body}`);

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-orderbook.js

@@ -1,5 +1,6 @@
 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 registerDexOrderbookTool(server) {
@@ -22,7 +23,7 @@ export function registerDexOrderbookTool(server) {
         logger.debug({ pair, limit }, "dex-orderbook invoked");
         try {
             const config = loadOrCreateWallet();
-            const res = await fetch(`${config.apiUrl}/dex-orderbook?pair=${encodeURIComponent(pair)}&limit=${limit}`);
+            const res = await apiFetch(config, `/dex-orderbook?pair=${encodeURIComponent(pair)}&limit=${limit}`);
             if (!res.ok) {
                 const body = await res.text();
                 return err(`Orderbook error ${res.status}: ${body}`);

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/dex-trades.js

@@ -1,5 +1,6 @@
 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 registerDexTradesTool(server) {
@@ -30,7 +31,7 @@ export function registerDexTradesTool(server) {
                 limit: String(limit),
                 trade_type,
             });
-            const res = await fetch(`${config.apiUrl}/dex-trades?${params}`);
+            const res = await apiFetch(config, `/dex-trades?${params}`);
             if (!res.ok) {
                 const body = await res.text();
                 return err(`Trades error ${res.status}: ${body}`);

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/domain.js

@@ -1,5 +1,6 @@
 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 registerDomainTool(server) {
     server.registerTool("domain", {
@@ -10,7 +11,7 @@ export function registerDomainTool(server) {
     }, async ({ name }) => {
         try {
             const config = loadOrCreateWallet();
-            const res = await fetch(`${config.apiUrl}/domain?name=${encodeURIComponent(name)}`);
+            const res = await apiFetch(config, `/domain?name=${encodeURIComponent(name)}`);
             if (!res.ok)
                 return err(`Domain API error: ${res.status}`);
             return ok(await res.json());

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/image.js

@@ -1,5 +1,6 @@
 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";
@@ -22,7 +23,7 @@ export function registerImageTool(server) {
         return withCache("image", { prompt, size }, () => withBudget("image", async () => {
             try {
                 const config = loadOrCreateWallet();
-                const res = await fetch(`${config.apiUrl}/image`, {
+                const res = await apiFetch(config, `/image`, {
                     method: "POST",
                     headers: { "Content-Type": "application/json" },
                     body: JSON.stringify({ prompt, size }),

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/oracle-price.js

@@ -1,5 +1,6 @@
 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 registerOraclePriceTool(server) {
@@ -21,7 +22,7 @@ export function registerOraclePriceTool(server) {
         try {
             const config = loadOrCreateWallet();
             const params = new URLSearchParams({ asset, feed });
-            const res = await fetch(`${config.apiUrl}/oracle-price?${params}`);
+            const res = await apiFetch(config, `/oracle-price?${params}`);
             if (!res.ok) {
                 const body = await res.text();
                 return err(`Oracle error ${res.status}: ${body}`);

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/research.js

@@ -1,5 +1,6 @@
 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";
@@ -22,7 +23,7 @@ export function registerResearchTool(server) {
         return withCache("research", { query, num_results }, () => withBudget("research", async () => {
             try {
                 const config = loadOrCreateWallet();
-                const res = await fetch(`${config.apiUrl}/research?q=${encodeURIComponent(query)}&num_results=${num_results}`);
+                const res = await apiFetch(config, `/research?q=${encodeURIComponent(query)}&num_results=${num_results}`);
                 if (!res.ok) {
                     const body = await res.text();
                     return err(`Research API error ${res.status}: ${body}`);

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/scrape.js

@@ -1,5 +1,6 @@
 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";
@@ -16,7 +17,7 @@ export function registerScrapeTool(server) {
         return withCache("scrape", { url }, () => withBudget("scrape", async () => {
             try {
                 const config = loadOrCreateWallet();
-                const res = await fetch(`${config.apiUrl}/scrape?url=${encodeURIComponent(url)}`);
+                const res = await apiFetch(config, `/scrape?url=${encodeURIComponent(url)}`);
                 if (!res.ok) {
                     const body = await res.text();
                     return err(`Scrape API error ${res.status}: ${body}`);

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/screenshot.js

@@ -1,5 +1,6 @@
 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";
@@ -21,7 +22,7 @@ export function registerScreenshotTool(server) {
             try {
                 const config = loadOrCreateWallet();
                 const params = new URLSearchParams({ url, format });
-                const res = await fetch(`${config.apiUrl}/screenshot?${params.toString()}`);
+                const res = await apiFetch(config, `/screenshot?${params.toString()}`);
                 if (!res.ok) {
                     const body = await res.text();
                     return err(`Screenshot API error ${res.status}: ${body}`);

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/search.js

@@ -1,5 +1,6 @@
 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";
@@ -22,7 +23,7 @@ export function registerSearchTool(server) {
         return withCache("search", { query, count }, () => withBudget("search", async () => {
             try {
                 const config = loadOrCreateWallet();
-                const res = await fetch(`${config.apiUrl}/search?q=${encodeURIComponent(query)}&count=${count}`);
+                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}`);

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-account.js

@@ -1,5 +1,6 @@
 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) {
@@ -15,7 +16,7 @@ export function registerStellarAccountTool(server) {
         logger.debug({ address }, "stellar-account invoked");
         try {
             const config = loadOrCreateWallet();
-            const res = await fetch(`${config.apiUrl}/stellar-account?address=${encodeURIComponent(address)}`);
+            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}`);

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-asset.js

@@ -1,5 +1,6 @@
 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) {
@@ -16,7 +17,7 @@ export function registerStellarAssetTool(server) {
         logger.debug({ asset }, "stellar-asset invoked");
         try {
             const config = loadOrCreateWallet();
-            const res = await fetch(`${config.apiUrl}/stellar-asset?asset=${encodeURIComponent(asset)}`);
+            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}`);

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/stellar-pools.js

@@ -1,5 +1,6 @@
 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) {
@@ -25,7 +26,7 @@ export function registerStellarPoolsTool(server) {
             const params = new URLSearchParams({ limit: String(limit) });
             if (asset)
                 params.set("asset", asset);
-            const res = await fetch(`${config.apiUrl}/stellar-pools?${params}`);
+            const res = await apiFetch(config, `/stellar-pools?${params}`);
             if (!res.ok) {
                 const body = await res.text();
                 return err(`Pools error ${res.status}: ${body}`);

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/stocks.js

@@ -1,5 +1,6 @@
 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";
@@ -18,7 +19,7 @@ export function registerStocksTool(server) {
         return withCache("stocks", { symbol }, () => withBudget("stocks", async () => {
             try {
                 const config = loadOrCreateWallet();
-                const res = await fetch(`${config.apiUrl}/stocks?symbol=${encodeURIComponent(symbol)}`);
+                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}`);

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/swap-quote.js

@@ -1,5 +1,6 @@
 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) {
@@ -22,7 +23,7 @@ export function registerSwapQuoteTool(server) {
         try {
             const config = loadOrCreateWallet();
             const params = new URLSearchParams({ from, to, amount, mode });
-            const res = await fetch(`${config.apiUrl}/swap-quote?${params}`);
+            const res = await apiFetch(config, `/swap-quote?${params}`);
             if (!res.ok) {
                 const body = await res.text();
                 return err(`Swap quote error ${res.status}: ${body}`);