@xlmtools/cli 0.1.0 → 0.1.2

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 ──────────────────────────────────────────
@@ -106,8 +107,10 @@ function handleTools() {
         name,
         price: `$${price}`,
     }));
+    // Note: `budget` is MCP-only — the CLI is a fresh process per invocation
+    // so a session-scoped cap is meaningless. Excluded from the CLI's free list.
     const free = [
-        "crypto", "weather", "domain", "wallet", "tools", "budget",
+        "crypto", "weather", "domain", "wallet", "tools",
         "dex-orderbook", "dex-candles", "dex-trades", "swap-quote",
         "stellar-asset", "stellar-account", "stellar-pools", "oracle-price",
     ];
@@ -188,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.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.js

@@ -6,6 +6,10 @@ let maxBudget = null;
 let totalSpent = 0;
 export function setBudget(max) {
     maxBudget = max;
+    // Reset spent counter so the new cap starts fresh. Users expect
+    // "I just set a $1.00 budget" to mean they have $1.00 to spend
+    // from now — not "$1.00 minus whatever I spent before setting it".
+    totalSpent = 0;
     logger.info({ max }, "session budget set");
 }
 export function clearBudget() {

package/dist/lib/cache.js

@@ -13,12 +13,16 @@ export async function withCache(toolName, params, fn) {
         logger.debug({ toolName }, "cache hit");
         const original = cached.result;
         if (original.content[0]?.type === "text") {
+            // Strip the "---\nPayment: ..." footer from cached text — no
+            // payment happened on this call, so the original tx hash would
+            // contradict the [cached — no charge] prefix.
+            const stripped = original.content[0].text.replace(/\n---\nPayment: .*$/s, "");
             return {
                 ...original,
                 content: [
                     {
                         type: "text",
-                        text: `[cached — no charge]\n\n${original.content[0].text}`,
+                        text: `[cached — no charge]\n\n${stripped}`,
                     },
                 ],
             };

package/dist/lib/wallet.js

@@ -70,7 +70,7 @@ export function loadOrCreateWallet() {
     const config = {
         stellarPrivateKey: keypair.secret(),
         stellarPublicKey: keypair.publicKey(),
-        apiUrl: process.env.XLMTools_API_URL ?? "http://localhost:3000",
+        apiUrl: process.env.XLMTOOLS_API_URL ?? "https://api.xlmtools.com",
     };
     mkdirSync(CONFIG_DIR, { recursive: true });
     writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2), { mode: 0o600 });

package/dist/tools/budget.js

@@ -12,8 +12,7 @@ export function registerBudgetTool(server) {
             action: z
                 .enum(["set", "check", "clear"])
                 .describe("Action: set a limit, check status, or clear limit"),
-            amount: z
-                .number()
+            amount: z.coerce.number()
                 .positive()
                 .optional()
                 .describe("Budget amount in USD (required for 'set')"),

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.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) {
@@ -15,8 +16,7 @@ export function registerDexCandlesTool(server) {
                 .enum(["1m", "5m", "15m", "1h", "1d", "1w"])
                 .default("1h")
                 .describe("Candle interval"),
-            limit: z
-                .number()
+            limit: z.coerce.number()
                 .int()
                 .min(1)
                 .max(200)
@@ -32,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.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) {
@@ -11,8 +12,7 @@ export function registerDexOrderbookTool(server) {
             pair: z
                 .string()
                 .describe('Asset pair (e.g. "XLM/USDC", "USDC/EURC")'),
-            limit: z
-                .number()
+            limit: z.coerce.number()
                 .int()
                 .min(1)
                 .max(200)
@@ -23,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.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) {
@@ -10,8 +11,7 @@ export function registerDexTradesTool(server) {
             pair: z
                 .string()
                 .describe('Asset pair (e.g. "XLM/USDC")'),
-            limit: z
-                .number()
+            limit: z.coerce.number()
                 .int()
                 .min(1)
                 .max(200)
@@ -31,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.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.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.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.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";
@@ -10,8 +11,7 @@ export function registerResearchTool(server) {
         title: "Deep Research",
         description: `Deep research on any topic — returns summarized, sourced results from multiple web pages.\nCost: $${TOOL_PRICES.research} USDC per query (paid via Stellar MPP).`, inputSchema: z.object({
             query: z.string().describe("Research query"),
-            num_results: z
-                .number()
+            num_results: z.coerce.number()
                 .int()
                 .min(1)
                 .max(20)
@@ -23,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.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.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.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";
@@ -10,8 +11,7 @@ export function registerSearchTool(server) {
         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
-                .number()
+            count: z.coerce.number()
                 .int()
                 .min(1)
                 .max(20)
@@ -23,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.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.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.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) {
@@ -11,8 +12,7 @@ export function registerStellarPoolsTool(server) {
                 .string()
                 .optional()
                 .describe('Filter by asset (e.g. "XLM", "USDC"). Omit for all pools.'),
-            limit: z
-                .number()
+            limit: z.coerce.number()
                 .int()
                 .min(1)
                 .max(200)
@@ -26,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.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.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}`);

package/dist/tools/weather.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 registerWeatherTool(server) {
     server.registerTool("weather", {
@@ -10,7 +11,7 @@ export function registerWeatherTool(server) {
     }, async ({ location }) => {
         try {
             const config = loadOrCreateWallet();
-            const res = await fetch(`${config.apiUrl}/weather?location=${encodeURIComponent(location)}`);
+            const res = await apiFetch(config, `/weather?location=${encodeURIComponent(location)}`);
             if (!res.ok)
                 return err(`Weather API error: ${res.status}`);
             return ok(await res.json());

package/dist/tools/youtube.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";
@@ -26,7 +27,7 @@ export function registerYoutubeTool(server) {
                     qs.set("q", query);
                 if (id)
                     qs.set("id", id);
-                const res = await fetch(`${config.apiUrl}/youtube?${qs.toString()}`);
+                const res = await apiFetch(config, `/youtube?${qs.toString()}`);
                 if (!res.ok) {
                     const body = await res.text();
                     return err(`YouTube API error ${res.status}: ${body}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xlmtools/cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "bin": {
     "xlmtools": "dist/index.js",

package/src/cli.ts

@@ -4,6 +4,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";
 
@@ -211,7 +212,11 @@ async function main() {
     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();

package/src/lib/api-fetch.ts

@@ -0,0 +1,30 @@
+/**
+ * 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 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 });
+}

package/src/lib/wallet.ts

@@ -94,7 +94,7 @@ export function loadOrCreateWallet(): XLMToolsConfig {
   const config: XLMToolsConfig = {
     stellarPrivateKey: keypair.secret(),
     stellarPublicKey: keypair.publicKey(),
-    apiUrl: process.env.XLMTools_API_URL ?? "http://localhost:3000",
+    apiUrl: process.env.XLMTOOLS_API_URL ?? "https://api.xlmtools.com",
   };
 
   mkdirSync(CONFIG_DIR, { recursive: true });

package/src/tools/crypto.ts

@@ -1,6 +1,7 @@
 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 registerCryptoTool(server: McpServer): void {
@@ -16,7 +17,7 @@ export function registerCryptoTool(server: McpServer): void {
     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());
       } catch (e) { return err(String(e)); }

package/src/tools/dex-candles.ts

@@ -1,6 +1,7 @@
 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";
 
@@ -37,7 +38,7 @@ export function registerDexCandlesTool(server: McpServer): void {
           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/src/tools/dex-orderbook.ts

@@ -1,6 +1,7 @@
 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";
 
@@ -28,8 +29,9 @@ export function registerDexOrderbookTool(server: McpServer): void {
       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();

package/src/tools/dex-trades.ts

@@ -1,6 +1,7 @@
 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";
 
@@ -36,7 +37,7 @@ export function registerDexTradesTool(server: McpServer): void {
           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/src/tools/domain.ts

@@ -1,6 +1,7 @@
 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 registerDomainTool(server: McpServer): void {
@@ -15,7 +16,7 @@ export function registerDomainTool(server: McpServer): void {
     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());
       } catch (e) { return err(String(e)); }

package/src/tools/image.ts

@@ -1,6 +1,7 @@
 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";
@@ -28,7 +29,7 @@ export function registerImageTool(server: McpServer): void {
         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/src/tools/oracle-price.ts

@@ -1,6 +1,7 @@
 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";
 
@@ -27,7 +28,7 @@ export function registerOraclePriceTool(server: McpServer): void {
       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/src/tools/research.ts

@@ -1,6 +1,7 @@
 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";
@@ -28,8 +29,9 @@ export function registerResearchTool(server: McpServer): void {
         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();

package/src/tools/scrape.ts

@@ -1,6 +1,7 @@
 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";
@@ -22,8 +23,9 @@ export function registerScrapeTool(server: McpServer): void {
         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();

package/src/tools/screenshot.ts

@@ -1,6 +1,7 @@
 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";
@@ -27,8 +28,9 @@ export function registerScreenshotTool(server: McpServer): void {
           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();

package/src/tools/search.ts

@@ -1,6 +1,7 @@
 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";
@@ -28,8 +29,9 @@ export function registerSearchTool(server: McpServer): void {
         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();

package/src/tools/stellar-account.ts

@@ -1,6 +1,7 @@
 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";
 
@@ -21,8 +22,9 @@ export function registerStellarAccountTool(server: McpServer): void {
       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();

package/src/tools/stellar-asset.ts

@@ -1,6 +1,7 @@
 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";
 
@@ -22,8 +23,9 @@ export function registerStellarAssetTool(server: McpServer): void {
       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();

package/src/tools/stellar-pools.ts

@@ -1,6 +1,7 @@
 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";
 
@@ -30,7 +31,7 @@ export function registerStellarPoolsTool(server: McpServer): void {
         const config = loadOrCreateWallet();
         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/src/tools/stocks.ts

@@ -1,6 +1,7 @@
 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";
@@ -24,8 +25,9 @@ export function registerStocksTool(server: McpServer): void {
         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();

package/src/tools/swap-quote.ts

@@ -1,6 +1,7 @@
 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";
 
@@ -28,7 +29,7 @@ export function registerSwapQuoteTool(server: McpServer): void {
       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}`);

package/src/tools/weather.ts

@@ -1,6 +1,7 @@
 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 {
@@ -15,7 +16,7 @@ export function registerWeatherTool(server: McpServer): void {
     async ({ location }) => {
       try {
         const config = loadOrCreateWallet();
-        const res = await fetch(`${config.apiUrl}/weather?location=${encodeURIComponent(location)}`);
+        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,6 +1,7 @@
 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";
@@ -30,8 +31,9 @@ export function registerYoutubeTool(server: McpServer): void {
             const qs = new URLSearchParams();
             if (query) qs.set("q", query);
             if (id) qs.set("id", id);
-            const res = await fetch(
-              `${config.apiUrl}/youtube?${qs.toString()}`,
+            const res = await apiFetch(
+              config,
+              `/youtube?${qs.toString()}`,
             );
             if (!res.ok) {
               const body = await res.text();