@guiie/buda-mcp 1.1.2 → 1.2.1

package/dist/tools/volume.js

@@ -1,13 +1,35 @@
 import { z } from "zod";
 import { BudaApiError } from "../client.js";
+import { validateMarketId } from "../validation.js";
+export const toolSchema = {
+    name: "get_market_volume",
+    description: "Get 24h and 7-day transacted volume for a Buda.com market. " +
+        "Returns ask (sell) and bid (buy) volumes in the market's base currency.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            market_id: {
+                type: "string",
+                description: "Market ID (e.g. 'BTC-CLP', 'ETH-BTC').",
+            },
+        },
+        required: ["market_id"],
+    },
+};
 export function register(server, client, _cache) {
-    server.tool("get_market_volume", "Get 24h and 7-day transacted volume for a Buda.com market. " +
-        "Returns ask (sell) and bid (buy) volumes in the market's base currency.", {
+    server.tool(toolSchema.name, toolSchema.description, {
         market_id: z
             .string()
             .describe("Market ID (e.g. 'BTC-CLP', 'ETH-BTC')."),
     }, async ({ market_id }) => {
         try {
+            const validationError = validateMarketId(market_id);
+            if (validationError) {
+                return {
+                    content: [{ type: "text", text: JSON.stringify({ error: validationError, code: "INVALID_MARKET_ID" }) }],
+                    isError: true,
+                };
+            }
             const data = await client.get(`/markets/${market_id.toLowerCase()}/volume`);
             return {
                 content: [{ type: "text", text: JSON.stringify(data.volume, null, 2) }],

package/dist/validation.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Validates a market ID against the expected BASE-QUOTE format.
+ * Returns an error message string if invalid, or null if valid.
+ */
+export declare function validateMarketId(id: string): string | null;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS1D"}

package/dist/validation.js

@@ -0,0 +1,14 @@
+const MARKET_ID_RE = /^[A-Z0-9]{2,10}-[A-Z0-9]{2,10}$/i;
+/**
+ * Validates a market ID against the expected BASE-QUOTE format.
+ * Returns an error message string if invalid, or null if valid.
+ */
+export function validateMarketId(id) {
+    if (!MARKET_ID_RE.test(id)) {
+        return (`Invalid market ID "${id}". ` +
+            `Expected format: BASE-QUOTE with 2–10 alphanumeric characters per part ` +
+            `(e.g. "BTC-CLP", "ETH-BTC").`);
+    }
+    return null;
+}
+//# sourceMappingURL=validation.js.map

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,OAAO,EAAE,MAEb,CAAC"}

package/dist/version.js

@@ -0,0 +1,6 @@
+import { readFileSync } from "fs";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+const _dir = dirname(fileURLToPath(import.meta.url));
+export const VERSION = JSON.parse(readFileSync(join(_dir, "../package.json"), "utf8")).version;
+//# sourceMappingURL=version.js.map

package/marketplace/README.md

@@ -1,4 +1,4 @@
-# Marketplace Submission Assets
+# Marketplace Submission Assets — v1.2.0
 
 Ready-to-use assets for submitting buda-mcp to every major AI marketplace.
 Replace `gtorreal` / `gtorreal` with your actual handles before submitting.

package/marketplace/claude-listing.md

@@ -50,8 +50,8 @@ Side-by-side ticker data for all trading pairs of a given base currency across a
 **Parameters:** `base_currency` *(required)* — e.g. `BTC`, `ETH`, `XRP`.
 
 ### `get_price_history`
-OHLCV (open/high/low/close/volume) candles derived from recent trade history. Supports `1h`, `4h`, and `1d` periods.  
-**Parameters:** `market_id` *(required)*, `period` *(optional: `1h`/`4h`/`1d`, default `1h`)*, `limit` *(optional, max 100 trades)*.
+OHLCV (open/high/low/close/volume) candles derived from recent trade history (Buda has no native candlestick endpoint). Supports `1h`, `4h`, and `1d` periods. Candle timestamps are UTC bucket boundaries.  
+**Parameters:** `market_id` *(required)*, `period` *(optional: `1h`/`4h`/`1d`, default `1h`)*, `limit` *(optional, default 100, max 1000 trades — more = deeper history)*.
 
 ### Authenticated tools (require `BUDA_API_KEY` + `BUDA_API_SECRET`)
 

package/marketplace/gemini-tools.json

@@ -1,5 +1,5 @@
 {
-  "_comment": "Gemini function declarations for buda-mcp v1.1.0. Pass this array as the `tools[0].functionDeclarations` field when calling the Gemini API. See: https://ai.google.dev/gemini-api/docs/function-calling",
+  "_comment": "Gemini function declarations for buda-mcp v1.2.0. Pass this array as the `tools[0].functionDeclarations` field when calling the Gemini API. See: https://ai.google.dev/gemini-api/docs/function-calling",
   "functionDeclarations": [
     {
       "name": "get_markets",
@@ -113,7 +113,7 @@
     },
     {
       "name": "get_price_history",
-      "description": "Get OHLCV (open/high/low/close/volume) price history for a Buda.com market, derived from recent trade history. Candles are aggregated client-side from up to 100 raw trades. Supports 1h, 4h, and 1d candle periods.",
+      "description": "IMPORTANT: Candles are aggregated client-side from raw trades (Buda has no native candlestick endpoint) — increase 'limit' for deeper history. Returns OHLCV (open/high/low/close/volume) price history for a Buda.com market. Candle timestamps are UTC bucket boundaries. Supports 1h, 4h, and 1d candle periods.",
       "parameters": {
         "type": "OBJECT",
         "properties": {
@@ -127,7 +127,7 @@
           },
           "limit": {
             "type": "INTEGER",
-            "description": "Number of raw trades to fetch before aggregation. Default is 100, maximum is 100."
+            "description": "Number of raw trades to fetch before aggregation. Default is 100, maximum is 1000. More trades = deeper history."
           }
         },
         "required": ["market_id"]

package/marketplace/openapi.yaml

@@ -11,7 +11,7 @@ info:
     stdio server. Deploy locally with mcp-proxy:
       mcp-proxy --port 8000 -- npx -y @guiie/buda-mcp
     Or point `servers[0].url` at your hosted instance.
-  version: 1.1.0
+  version: 1.2.0
   contact:
     url: https://github.com/gtorreal/buda-mcp
 
@@ -231,9 +231,10 @@ paths:
       operationId: getPriceHistory
       summary: OHLCV price history derived from trade history
       description: |
-        Returns OHLCV (open/high/low/close/volume) candles derived from recent trade history.
-        Buda.com has no native candlestick endpoint; candles are aggregated client-side from
-        up to 100 raw trades. Supports 1h, 4h, and 1d candle periods.
+        IMPORTANT: Candles are aggregated client-side from raw trades (Buda has no native
+        candlestick endpoint) — increase 'limit' for deeper history but expect slower responses.
+        Returns OHLCV (open/high/low/close/volume) candles. Candle timestamps are UTC bucket
+        boundaries. Supports 1h, 4h, and 1d candle periods.
       parameters:
         - name: market_id
           in: query
@@ -253,11 +254,11 @@ paths:
         - name: limit
           in: query
           required: false
-          description: Number of raw trades to fetch before aggregation (default 100, max 100).
+          description: Number of raw trades to fetch before aggregation (default 100, max 1000). More trades = deeper history.
           schema:
             type: integer
             minimum: 1
-            maximum: 100
+            maximum: 1000
       responses:
         "200":
           description: OHLCV candles

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guiie/buda-mcp",
-  "version": "1.1.2",
+  "version": "1.2.1",
   "mcpName": "io.github.gtorreal/buda-mcp",
   "description": "MCP server for Buda.com's public cryptocurrency exchange API (Chile, Colombia, Peru)",
   "type": "module",
@@ -14,7 +14,10 @@
     "start:stdio": "node dist/index.js",
     "dev:http": "tsx src/http.ts",
     "dev": "tsx src/index.ts",
-    "test": "tsx test/run-all.ts"
+    "test": "npm run test:unit && npm run test:integration",
+    "test:unit": "tsx test/unit.ts",
+    "test:integration": "tsx test/run-all.ts",
+    "sync-version": "node scripts/sync-version.mjs"
   },
   "engines": {
     "node": ">=18"

package/scripts/sync-version.mjs

@@ -0,0 +1,19 @@
+/**
+ * Reads the version from package.json and writes it into server.json.
+ * Run after bumping the version in package.json:
+ *   node scripts/sync-version.mjs
+ */
+import { readFileSync, writeFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+
+const root = join(dirname(fileURLToPath(import.meta.url)), "..");
+
+const pkg = JSON.parse(readFileSync(join(root, "package.json"), "utf8"));
+const server = JSON.parse(readFileSync(join(root, "server.json"), "utf8"));
+
+server.version = pkg.version;
+server.packages[0].version = pkg.version;
+
+writeFileSync(join(root, "server.json"), JSON.stringify(server, null, 2) + "\n");
+console.log(`server.json synced to v${pkg.version}`);

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/gtorreal/buda-mcp",
     "source": "github"
   },
-  "version": "1.1.2",
+  "version": "1.2.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@guiie/buda-mcp",
-      "version": "1.1.2",
+      "version": "1.2.0",
       "transport": {
         "type": "stdio"
       }

package/src/client.ts

@@ -1,4 +1,5 @@
 import { createHmac } from "crypto";
+import { VERSION } from "./version.js";
 
 const BASE_URL = "https://www.buda.com/api/v2";
 
@@ -7,6 +8,7 @@ export class BudaApiError extends Error {
     public readonly status: number,
     public readonly path: string,
     message: string,
+    public readonly retryAfterMs?: number,
   ) {
     super(message);
     this.name = "BudaApiError";
@@ -56,24 +58,51 @@ export class BudaClient {
     };
   }
 
-  async get<T>(path: string, params?: Record<string, string | number>): Promise<T> {
-    const url = new URL(`${this.baseUrl}${path}.json`);
+  /**
+   * Parses the Retry-After header value into milliseconds.
+   * Per RFC 7231, Retry-After is an integer number of seconds.
+   * Defaults to 1000ms (1 second) if absent or unparseable.
+   */
+  private parseRetryAfterMs(headers: Headers): number {
+    const raw = headers.get("Retry-After");
+    if (!raw) return 1000;
+    const secs = parseInt(raw, 10);
+    return isNaN(secs) ? 1000 : secs * 1000;
+  }
 
-    if (params) {
-      for (const [key, value] of Object.entries(params)) {
-        url.searchParams.set(key, String(value));
-      }
+  /**
+   * Executes a fetch call with a single 429 retry.
+   * On the first 429, waits for Retry-After seconds (default 1s), then retries once.
+   * If the retry also returns 429, throws a BudaApiError with retryAfterMs set.
+   */
+  private async fetchWithRetry(
+    url: URL,
+    options: RequestInit,
+    path: string,
+  ): Promise<Response> {
+    const response = await fetch(url.toString(), options);
+
+    if (response.status !== 429) return response;
+
+    const retryAfterMs = this.parseRetryAfterMs(response.headers);
+    await new Promise((r) => setTimeout(r, retryAfterMs));
+
+    const retry = await fetch(url.toString(), options);
+
+    if (retry.status === 429) {
+      const retryAgainMs = this.parseRetryAfterMs(retry.headers);
+      throw new BudaApiError(
+        429,
+        path,
+        `Buda API rate limit exceeded. Retry after ${retryAgainMs}ms.`,
+        retryAgainMs,
+      );
     }
 
-    const urlPath = url.pathname + url.search;
-    const headers: Record<string, string> = {
-      Accept: "application/json",
-      "User-Agent": "buda-mcp/1.1.1",
-      ...this.authHeaders("GET", urlPath),
-    };
-
-    const response = await fetch(url.toString(), { headers });
+    return retry;
+  }
 
+  private async handleResponse<T>(response: Response, path: string): Promise<T> {
     if (!response.ok) {
       let detail = response.statusText;
       try {
@@ -84,10 +113,29 @@ export class BudaClient {
       }
       throw new BudaApiError(response.status, path, `Buda API ${response.status}: ${detail}`);
     }
-
     return response.json() as Promise<T>;
   }
 
+  async get<T>(path: string, params?: Record<string, string | number>): Promise<T> {
+    const url = new URL(`${this.baseUrl}${path}.json`);
+
+    if (params) {
+      for (const [key, value] of Object.entries(params)) {
+        url.searchParams.set(key, String(value));
+      }
+    }
+
+    const urlPath = url.pathname + url.search;
+    const headers: Record<string, string> = {
+      Accept: "application/json",
+      "User-Agent": `buda-mcp/${VERSION}`,
+      ...this.authHeaders("GET", urlPath),
+    };
+
+    const response = await this.fetchWithRetry(url, { headers }, path);
+    return this.handleResponse<T>(response, path);
+  }
+
   async post<T>(path: string, payload: unknown): Promise<T> {
     const url = new URL(`${this.baseUrl}${path}.json`);
     const bodyStr = JSON.stringify(payload);
@@ -95,28 +143,16 @@ export class BudaClient {
     const headers: Record<string, string> = {
       Accept: "application/json",
       "Content-Type": "application/json",
-      "User-Agent": "buda-mcp/1.1.1",
+      "User-Agent": `buda-mcp/${VERSION}`,
       ...this.authHeaders("POST", urlPath, bodyStr),
     };
 
-    const response = await fetch(url.toString(), {
-      method: "POST",
-      headers,
-      body: bodyStr,
-    });
-
-    if (!response.ok) {
-      let detail = response.statusText;
-      try {
-        const body = (await response.json()) as { message?: string };
-        if (body.message) detail = body.message;
-      } catch {
-        // ignore parse error, use statusText
-      }
-      throw new BudaApiError(response.status, path, `Buda API ${response.status}: ${detail}`);
-    }
-
-    return response.json() as Promise<T>;
+    const response = await this.fetchWithRetry(
+      url,
+      { method: "POST", headers, body: bodyStr },
+      path,
+    );
+    return this.handleResponse<T>(response, path);
   }
 
   async put<T>(path: string, payload: unknown): Promise<T> {
@@ -126,27 +162,15 @@ export class BudaClient {
     const headers: Record<string, string> = {
       Accept: "application/json",
       "Content-Type": "application/json",
-      "User-Agent": "buda-mcp/1.1.1",
+      "User-Agent": `buda-mcp/${VERSION}`,
       ...this.authHeaders("PUT", urlPath, bodyStr),
     };
 
-    const response = await fetch(url.toString(), {
-      method: "PUT",
-      headers,
-      body: bodyStr,
-    });
-
-    if (!response.ok) {
-      let detail = response.statusText;
-      try {
-        const body = (await response.json()) as { message?: string };
-        if (body.message) detail = body.message;
-      } catch {
-        // ignore parse error, use statusText
-      }
-      throw new BudaApiError(response.status, path, `Buda API ${response.status}: ${detail}`);
-    }
-
-    return response.json() as Promise<T>;
+    const response = await this.fetchWithRetry(
+      url,
+      { method: "PUT", headers, body: bodyStr },
+      path,
+    );
+    return this.handleResponse<T>(response, path);
   }
 }

package/src/http.ts

@@ -3,6 +3,7 @@ import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mc
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { BudaClient } from "./client.js";
 import { MemoryCache, CACHE_TTL } from "./cache.js";
+import { VERSION } from "./version.js";
 import type { MarketsResponse, TickerResponse } from "./types.js";
 import * as markets from "./tools/markets.js";
 import * as ticker from "./tools/ticker.js";
@@ -27,8 +28,28 @@ const client = new BudaClient(
 
 const authEnabled = client.hasAuth();
 
+// Schemas for the Smithery server-card — assembled from the same definitions used in register().
+// Adding a new tool only requires exporting its toolSchema; no changes needed here.
+const PUBLIC_TOOL_SCHEMAS = [
+  markets.toolSchema,
+  ticker.toolSchema,
+  orderbook.toolSchema,
+  trades.toolSchema,
+  volume.toolSchema,
+  spread.toolSchema,
+  compareMarkets.toolSchema,
+  priceHistory.toolSchema,
+];
+
+const AUTH_TOOL_SCHEMAS = [
+  balances.toolSchema,
+  orders.toolSchema,
+  placeOrder.toolSchema,
+  cancelOrder.toolSchema,
+];
+
 function createServer(): McpServer {
-  const server = new McpServer({ name: "buda-mcp", version: "1.1.2" });
+  const server = new McpServer({ name: "buda-mcp", version: VERSION });
 
   // Per-request cache so caching works correctly for stateless HTTP
   const reqCache = new MemoryCache();
@@ -101,160 +122,21 @@ app.use(express.json());
 
 // Health check for Railway / uptime monitors
 app.get("/health", (_req, res) => {
-  res.json({ status: "ok", server: "buda-mcp", version: "1.1.2", auth_mode: authEnabled ? "authenticated" : "public" });
+  res.json({
+    status: "ok",
+    server: "buda-mcp",
+    version: VERSION,
+    auth_mode: authEnabled ? "authenticated" : "public",
+  });
 });
 
-// Smithery static server card — lets Smithery scan tools without running the server
+// Smithery static server card — assembled programmatically from tool definitions.
+// Adding a new tool only requires exporting its toolSchema; this handler needs no changes.
 app.get("/.well-known/mcp/server-card.json", (_req, res) => {
-  const publicTools = [
-    {
-      name: "get_markets",
-      description: "List all available trading pairs on Buda.com, or get details for a specific market.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          market_id: { type: "string", description: "Optional market ID (e.g. BTC-CLP)" },
-        },
-      },
-    },
-    {
-      name: "get_ticker",
-      description: "Get current price, bid/ask, volume, and price change for a Buda.com market.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          market_id: { type: "string", description: "Market ID (e.g. BTC-CLP)" },
-        },
-        required: ["market_id"],
-      },
-    },
-    {
-      name: "get_orderbook",
-      description: "Get the full order book (bids and asks) for a Buda.com market.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          market_id: { type: "string", description: "Market ID (e.g. BTC-CLP)" },
-          limit: { type: "number", description: "Max levels per side" },
-        },
-        required: ["market_id"],
-      },
-    },
-    {
-      name: "get_trades",
-      description: "Get recent trade history for a Buda.com market.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          market_id: { type: "string", description: "Market ID (e.g. BTC-CLP)" },
-          limit: { type: "number", description: "Number of trades (max 100)" },
-          timestamp: { type: "number", description: "Unix timestamp for pagination" },
-        },
-        required: ["market_id"],
-      },
-    },
-    {
-      name: "get_market_volume",
-      description: "Get 24h and 7-day transacted volume for a Buda.com market.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          market_id: { type: "string", description: "Market ID (e.g. BTC-CLP)" },
-        },
-        required: ["market_id"],
-      },
-    },
-    {
-      name: "get_spread",
-      description: "Calculate bid/ask spread (absolute and percentage) for a Buda.com market.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          market_id: { type: "string", description: "Market ID (e.g. BTC-CLP)" },
-        },
-        required: ["market_id"],
-      },
-    },
-    {
-      name: "compare_markets",
-      description: "Compare ticker data for all trading pairs of a given base currency side by side.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          base_currency: { type: "string", description: "Base currency (e.g. BTC, ETH)" },
-        },
-        required: ["base_currency"],
-      },
-    },
-    {
-      name: "get_price_history",
-      description: "Get OHLCV price history for a market, derived from recent trade history.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          market_id: { type: "string", description: "Market ID (e.g. BTC-CLP)" },
-          period: { type: "string", enum: ["1h", "4h", "1d"], description: "Candle period" },
-          limit: { type: "number", description: "Raw trades to fetch (max 100)" },
-        },
-        required: ["market_id"],
-      },
-    },
-  ];
-
-  const authTools = authEnabled
-    ? [
-        {
-          name: "get_balances",
-          description: "Get all currency balances for the authenticated account.",
-          inputSchema: { type: "object", properties: {} },
-        },
-        {
-          name: "get_orders",
-          description: "Get orders for a given market.",
-          inputSchema: {
-            type: "object",
-            properties: {
-              market_id: { type: "string" },
-              state: { type: "string" },
-            },
-            required: ["market_id"],
-          },
-        },
-        {
-          name: "place_order",
-          description: "Place a limit or market order. Requires confirmation_token='CONFIRM'.",
-          inputSchema: {
-            type: "object",
-            properties: {
-              market_id: { type: "string" },
-              type: { type: "string", enum: ["Bid", "Ask"] },
-              price_type: { type: "string", enum: ["limit", "market"] },
-              amount: { type: "number" },
-              limit_price: { type: "number" },
-              confirmation_token: { type: "string" },
-            },
-            required: ["market_id", "type", "price_type", "amount", "confirmation_token"],
-          },
-        },
-        {
-          name: "cancel_order",
-          description: "Cancel an order by ID. Requires confirmation_token='CONFIRM'.",
-          inputSchema: {
-            type: "object",
-            properties: {
-              order_id: { type: "number" },
-              confirmation_token: { type: "string" },
-            },
-            required: ["order_id", "confirmation_token"],
-          },
-        },
-      ]
-    : [];
-
   res.json({
-    serverInfo: { name: "buda-mcp", version: "1.1.2" },
+    serverInfo: { name: "buda-mcp", version: VERSION },
     authentication: { required: authEnabled },
-    tools: [...publicTools, ...authTools],
+    tools: [...PUBLIC_TOOL_SCHEMAS, ...(authEnabled ? AUTH_TOOL_SCHEMAS : [])],
     resources: [
       { uri: "buda://markets", name: "All Buda.com markets", mimeType: "application/json" },
       { uri: "buda://ticker/{market}", name: "Ticker for a specific market", mimeType: "application/json" },

package/src/index.ts

@@ -3,6 +3,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { BudaClient } from "./client.js";
 import { cache, CACHE_TTL } from "./cache.js";
+import { VERSION } from "./version.js";
 import type { MarketsResponse, TickerResponse } from "./types.js";
 import * as markets from "./tools/markets.js";
 import * as ticker from "./tools/ticker.js";
@@ -25,7 +26,7 @@ const client = new BudaClient(
 
 const server = new McpServer({
   name: "buda-mcp",
-  version: "1.1.2",
+  version: VERSION,
 });
 
 // Public tools

package/src/tools/balances.ts

@@ -2,12 +2,22 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { BudaClient, BudaApiError } from "../client.js";
 import type { BalancesResponse } from "../types.js";
 
+export const toolSchema = {
+  name: "get_balances",
+  description:
+    "Get all currency balances for the authenticated Buda.com account. " +
+    "Returns total, available, frozen, and pending withdrawal amounts per currency. " +
+    "Requires BUDA_API_KEY and BUDA_API_SECRET environment variables.",
+  inputSchema: {
+    type: "object" as const,
+    properties: {},
+  },
+};
+
 export function register(server: McpServer, client: BudaClient): void {
   server.tool(
-    "get_balances",
-    "Get all currency balances for the authenticated Buda.com account. " +
-      "Returns total, available, frozen, and pending withdrawal amounts per currency. " +
-      "Requires BUDA_API_KEY and BUDA_API_SECRET environment variables.",
+    toolSchema.name,
+    toolSchema.description,
     {},
     async () => {
       try {