@guiie/buda-mcp 1.1.2 → 1.2.1

package/dist/tools/orders.js

@@ -1,8 +1,35 @@
 import { z } from "zod";
 import { BudaApiError } from "../client.js";
+import { validateMarketId } from "../validation.js";
+export const toolSchema = {
+    name: "get_orders",
+    description: "Get orders for a given Buda.com market. Filter by state (pending, active, traded, canceled). " +
+        "Requires BUDA_API_KEY and BUDA_API_SECRET environment variables.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            market_id: {
+                type: "string",
+                description: "Market ID (e.g. 'BTC-CLP', 'ETH-BTC').",
+            },
+            state: {
+                type: "string",
+                description: "Filter by order state: 'pending', 'active', 'traded', 'canceled', 'canceled_and_traded'.",
+            },
+            per: {
+                type: "number",
+                description: "Results per page (default: 20, max: 300).",
+            },
+            page: {
+                type: "number",
+                description: "Page number (default: 1).",
+            },
+        },
+        required: ["market_id"],
+    },
+};
 export function register(server, client) {
-    server.tool("get_orders", "Get orders for a given Buda.com market. Filter by state (pending, active, traded, canceled). " +
-        "Requires BUDA_API_KEY and BUDA_API_SECRET environment variables.", {
+    server.tool(toolSchema.name, toolSchema.description, {
         market_id: z
             .string()
             .describe("Market ID (e.g. 'BTC-CLP', 'ETH-BTC')."),
@@ -26,6 +53,13 @@ export function register(server, client) {
             .describe("Page number (default: 1)."),
     }, async ({ market_id, state, per, page }) => {
         try {
+            const validationError = validateMarketId(market_id);
+            if (validationError) {
+                return {
+                    content: [{ type: "text", text: JSON.stringify({ error: validationError, code: "INVALID_MARKET_ID" }) }],
+                    isError: true,
+                };
+            }
             const params = {};
             if (state)
                 params.state = state;

package/dist/tools/place_order.d.ts

@@ -1,4 +1,54 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { BudaClient } from "../client.js";
+export declare const toolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            market_id: {
+                type: string;
+                description: string;
+            };
+            type: {
+                type: string;
+                description: string;
+            };
+            price_type: {
+                type: string;
+                description: string;
+            };
+            amount: {
+                type: string;
+                description: string;
+            };
+            limit_price: {
+                type: string;
+                description: string;
+            };
+            confirmation_token: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+type PlaceOrderArgs = {
+    market_id: string;
+    type: "Bid" | "Ask";
+    price_type: "limit" | "market";
+    amount: number;
+    limit_price?: number;
+    confirmation_token: string;
+};
+export declare function handlePlaceOrder(args: PlaceOrderArgs, client: BudaClient): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
 export declare function register(server: McpServer, client: BudaClient): void;
+export {};
 //# sourceMappingURL=place_order.d.ts.map

package/dist/tools/place_order.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"place_order.d.ts","sourceRoot":"","sources":["../../src/tools/place_order.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AAGxD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAqGpE"}
+{"version":3,"file":"place_order.d.ts","sourceRoot":"","sources":["../../src/tools/place_order.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AAIxD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0CtB,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;IACpB,UAAU,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAwEhF;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAmCpE"}

package/dist/tools/place_order.js

@@ -1,11 +1,111 @@
 import { z } from "zod";
 import { BudaApiError } from "../client.js";
-export function register(server, client) {
-    server.tool("place_order", "Place a limit or market order on Buda.com. " +
+import { validateMarketId } from "../validation.js";
+export const toolSchema = {
+    name: "place_order",
+    description: "Place a limit or market order on Buda.com. " +
         "IMPORTANT: To prevent accidental execution from ambiguous prompts, you must pass " +
         "confirmation_token='CONFIRM' to execute the order. " +
         "Requires BUDA_API_KEY and BUDA_API_SECRET environment variables. " +
-        "WARNING: Only use this tool on a locally-run instance — never on a publicly exposed server.", {
+        "WARNING: Only use this tool on a locally-run instance — never on a publicly exposed server.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            market_id: {
+                type: "string",
+                description: "Market ID (e.g. 'BTC-CLP', 'ETH-BTC').",
+            },
+            type: {
+                type: "string",
+                description: "Order side: 'Bid' to buy, 'Ask' to sell.",
+            },
+            price_type: {
+                type: "string",
+                description: "Order type: 'limit' places at a specific price, 'market' executes immediately.",
+            },
+            amount: {
+                type: "number",
+                description: "Order size in the market's base currency (e.g. BTC amount for BTC-CLP).",
+            },
+            limit_price: {
+                type: "number",
+                description: "Limit price in quote currency. Required when price_type is 'limit'. " +
+                    "For Bid orders: highest price you will pay. For Ask orders: lowest price you will accept.",
+            },
+            confirmation_token: {
+                type: "string",
+                description: "Safety confirmation. Must equal exactly 'CONFIRM' (case-sensitive) to execute the order. " +
+                    "Any other value will reject the request without placing an order.",
+            },
+        },
+        required: ["market_id", "type", "price_type", "amount", "confirmation_token"],
+    },
+};
+export async function handlePlaceOrder(args, client) {
+    const { market_id, type, price_type, amount, limit_price, confirmation_token } = args;
+    if (confirmation_token !== "CONFIRM") {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        error: "Order not placed. confirmation_token must equal 'CONFIRM' to execute. " +
+                            "Review the order details and set confirmation_token='CONFIRM' to proceed.",
+                        code: "CONFIRMATION_REQUIRED",
+                        order_preview: { market_id, type, price_type, amount, limit_price },
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    const validationError = validateMarketId(market_id);
+    if (validationError) {
+        return {
+            content: [{ type: "text", text: JSON.stringify({ error: validationError, code: "INVALID_MARKET_ID" }) }],
+            isError: true,
+        };
+    }
+    try {
+        const payload = {
+            type,
+            price_type,
+            amount,
+        };
+        if (price_type === "limit") {
+            if (limit_price === undefined) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                error: "limit_price is required when price_type is 'limit'.",
+                                code: "VALIDATION_ERROR",
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            payload.limit = { price: limit_price, type: "gtc" };
+        }
+        const data = await client.post(`/markets/${market_id.toLowerCase()}/orders`, payload);
+        return {
+            content: [{ type: "text", text: JSON.stringify(data.order, null, 2) }],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof BudaApiError
+            ? { error: err.message, code: err.status, path: err.path }
+            : { error: String(err), code: "UNKNOWN" };
+        return {
+            content: [{ type: "text", text: JSON.stringify(msg) }],
+            isError: true,
+        };
+    }
+}
+export function register(server, client) {
+    server.tool(toolSchema.name, toolSchema.description, {
         market_id: z
             .string()
             .describe("Market ID (e.g. 'BTC-CLP', 'ETH-BTC')."),
@@ -29,60 +129,6 @@ export function register(server, client) {
             .string()
             .describe("Safety confirmation. Must equal exactly 'CONFIRM' (case-sensitive) to execute the order. " +
             "Any other value will reject the request without placing an order."),
-    }, async ({ market_id, type, price_type, amount, limit_price, confirmation_token }) => {
-        if (confirmation_token !== "CONFIRM") {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({
-                            error: "Order not placed. confirmation_token must equal 'CONFIRM' to execute. " +
-                                "Review the order details and set confirmation_token='CONFIRM' to proceed.",
-                            code: "CONFIRMATION_REQUIRED",
-                            order_preview: { market_id, type, price_type, amount, limit_price },
-                        }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        try {
-            const payload = {
-                type,
-                price_type,
-                amount,
-            };
-            if (price_type === "limit") {
-                if (limit_price === undefined) {
-                    return {
-                        content: [
-                            {
-                                type: "text",
-                                text: JSON.stringify({
-                                    error: "limit_price is required when price_type is 'limit'.",
-                                    code: "VALIDATION_ERROR",
-                                }),
-                            },
-                        ],
-                        isError: true,
-                    };
-                }
-                payload.limit = { price: limit_price, type: "gtc" };
-            }
-            const data = await client.post(`/markets/${market_id.toLowerCase()}/orders`, payload);
-            return {
-                content: [{ type: "text", text: JSON.stringify(data.order, null, 2) }],
-            };
-        }
-        catch (err) {
-            const msg = err instanceof BudaApiError
-                ? { error: err.message, code: err.status, path: err.path }
-                : { error: String(err), code: "UNKNOWN" };
-            return {
-                content: [{ type: "text", text: JSON.stringify(msg) }],
-                isError: true,
-            };
-        }
-    });
+    }, (args) => handlePlaceOrder(args, client));
 }
 //# sourceMappingURL=place_order.js.map

package/dist/tools/price_history.d.ts

@@ -1,5 +1,27 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { BudaClient } from "../client.js";
 import { MemoryCache } from "../cache.js";
+export declare const toolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            market_id: {
+                type: string;
+                description: string;
+            };
+            period: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
 export declare function register(server: McpServer, client: BudaClient, _cache: MemoryCache): void;
 //# sourceMappingURL=price_history.d.ts.map

package/dist/tools/price_history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"price_history.d.ts","sourceRoot":"","sources":["../../src/tools/price_history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAmB1C,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CA2GzF"}
+{"version":3,"file":"price_history.d.ts","sourceRoot":"","sources":["../../src/tools/price_history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAoB1C,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;CA4BtB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAsHzF"}

package/dist/tools/price_history.js

@@ -1,15 +1,40 @@
 import { z } from "zod";
 import { BudaApiError } from "../client.js";
+import { validateMarketId } from "../validation.js";
 const PERIOD_MS = {
     "1h": 60 * 60 * 1000,
     "4h": 4 * 60 * 60 * 1000,
     "1d": 24 * 60 * 60 * 1000,
 };
+export const toolSchema = {
+    name: "get_price_history",
+    description: "IMPORTANT: Candles are aggregated client-side from raw trades (Buda has no native candlestick " +
+        "endpoint) — fetching more trades via the 'limit' parameter gives deeper history but slower " +
+        "responses. Returns OHLCV (open/high/low/close/volume) price history for a Buda.com market. " +
+        "Candle timestamps are UTC bucket boundaries (e.g. '2026-04-10T12:00:00.000Z' for 1h). " +
+        "Supports 1h, 4h, and 1d candle periods.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            market_id: {
+                type: "string",
+                description: "Market ID (e.g. 'BTC-CLP', 'ETH-BTC').",
+            },
+            period: {
+                type: "string",
+                description: "Candle period: '1h' (1 hour), '4h' (4 hours), or '1d' (1 day). Default: '1h'.",
+            },
+            limit: {
+                type: "number",
+                description: "Raw trades to fetch before aggregation (default: 100, max: 1000). " +
+                    "More trades = deeper history but slower response.",
+            },
+        },
+        required: ["market_id"],
+    },
+};
 export function register(server, client, _cache) {
-    server.tool("get_price_history", "Get OHLCV (open/high/low/close/volume) price history for a Buda.com market, derived from " +
-        "recent trade history (up to 100 trades). Buda does not provide a native candlestick endpoint; " +
-        "candles are aggregated client-side from raw trades. Use the 'period' parameter to control " +
-        "candle size (1h, 4h, or 1d).", {
+    server.tool(toolSchema.name, toolSchema.description, {
         market_id: z
             .string()
             .describe("Market ID (e.g. 'BTC-CLP', 'ETH-BTC')."),
@@ -21,11 +46,19 @@ export function register(server, client, _cache) {
             .number()
             .int()
             .min(1)
-            .max(100)
+            .max(1000)
             .optional()
-            .describe("Number of raw trades to fetch before aggregation (default: 100, max: 100)."),
+            .describe("Raw trades to fetch before aggregation (default: 100, max: 1000). " +
+            "More trades = deeper history but slower response."),
     }, async ({ market_id, period, limit }) => {
         try {
+            const validationError = validateMarketId(market_id);
+            if (validationError) {
+                return {
+                    content: [{ type: "text", text: JSON.stringify({ error: validationError, code: "INVALID_MARKET_ID" }) }],
+                    isError: true,
+                };
+            }
             const id = market_id.toLowerCase();
             const tradesLimit = limit ?? 100;
             const data = await client.get(`/markets/${id}/trades`, { limit: tradesLimit });
@@ -79,7 +112,9 @@ export function register(server, client, _cache) {
                 market_id: market_id.toUpperCase(),
                 period,
                 candle_count: candles.length,
-                note: "Candles derived from trade history (up to 100 trades). For deeper history, use pagination via the get_trades tool.",
+                trades_fetched: entries.length,
+                note: "Candles derived from raw trade history. Candle timestamps are UTC bucket boundaries. " +
+                    "Increase 'limit' (max 1000) for deeper history.",
                 candles,
             };
             return {

package/dist/tools/spread.d.ts

@@ -1,5 +1,19 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { BudaClient } from "../client.js";
 import { MemoryCache } from "../cache.js";
+export declare const toolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            market_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
 export declare function register(server: McpServer, client: BudaClient, cache: MemoryCache): void;
 //# sourceMappingURL=spread.d.ts.map

package/dist/tools/spread.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spread.d.ts","sourceRoot":"","sources":["../../src/tools/spread.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAa,MAAM,aAAa,CAAC;AAGrD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAgExF"}
+{"version":3,"file":"spread.d.ts","sourceRoot":"","sources":["../../src/tools/spread.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAa,MAAM,aAAa,CAAC;AAIrD,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAetB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAuExF"}

package/dist/tools/spread.js

@@ -1,14 +1,36 @@
 import { z } from "zod";
 import { BudaApiError } from "../client.js";
 import { CACHE_TTL } from "../cache.js";
+import { validateMarketId } from "../validation.js";
+export const toolSchema = {
+    name: "get_spread",
+    description: "Calculate the bid/ask spread for a Buda.com market. " +
+        "Returns the best bid, best ask, absolute spread, and spread as a percentage of the ask price.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            market_id: {
+                type: "string",
+                description: "Market ID (e.g. 'BTC-CLP', 'ETH-BTC', 'BTC-COP').",
+            },
+        },
+        required: ["market_id"],
+    },
+};
 export function register(server, client, cache) {
-    server.tool("get_spread", "Calculate the bid/ask spread for a Buda.com market. " +
-        "Returns the best bid, best ask, absolute spread, and spread as a percentage of the ask price.", {
+    server.tool(toolSchema.name, toolSchema.description, {
         market_id: z
             .string()
             .describe("Market ID (e.g. 'BTC-CLP', 'ETH-BTC', 'BTC-COP')."),
     }, 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 id = market_id.toLowerCase();
             const data = await cache.getOrFetch(`ticker:${id}`, CACHE_TTL.TICKER, () => client.get(`/markets/${id}/ticker`));
             const ticker = data.ticker;

package/dist/tools/ticker.d.ts

@@ -1,5 +1,19 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { BudaClient } from "../client.js";
 import { MemoryCache } from "../cache.js";
+export declare const toolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            market_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
 export declare function register(server: McpServer, client: BudaClient, cache: MemoryCache): void;
 //# sourceMappingURL=ticker.d.ts.map

package/dist/tools/ticker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ticker.d.ts","sourceRoot":"","sources":["../../src/tools/ticker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAa,MAAM,aAAa,CAAC;AAGrD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAiCxF"}
+{"version":3,"file":"ticker.d.ts","sourceRoot":"","sources":["../../src/tools/ticker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAa,MAAM,aAAa,CAAC;AAIrD,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAetB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAwCxF"}

package/dist/tools/ticker.js

@@ -1,14 +1,36 @@
 import { z } from "zod";
 import { BudaApiError } from "../client.js";
 import { CACHE_TTL } from "../cache.js";
+import { validateMarketId } from "../validation.js";
+export const toolSchema = {
+    name: "get_ticker",
+    description: "Get the current ticker for a Buda.com market: last traded price, best bid/ask, " +
+        "24h volume, and price change over 24h and 7d.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            market_id: {
+                type: "string",
+                description: "Market ID (e.g. 'BTC-CLP', 'ETH-BTC', 'BTC-COP').",
+            },
+        },
+        required: ["market_id"],
+    },
+};
 export function register(server, client, cache) {
-    server.tool("get_ticker", "Get the current ticker for a Buda.com market: last traded price, best bid/ask, " +
-        "24h volume, and price change over 24h and 7d.", {
+    server.tool(toolSchema.name, toolSchema.description, {
         market_id: z
             .string()
             .describe("Market ID (e.g. 'BTC-CLP', 'ETH-BTC', 'BTC-COP')."),
     }, 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 id = market_id.toLowerCase();
             const data = await cache.getOrFetch(`ticker:${id}`, CACHE_TTL.TICKER, () => client.get(`/markets/${id}/ticker`));
             return {

package/dist/tools/trades.d.ts

@@ -1,5 +1,27 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { BudaClient } from "../client.js";
 import { MemoryCache } from "../cache.js";
+export declare const toolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            market_id: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            timestamp: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
 export declare function register(server: McpServer, client: BudaClient, _cache: MemoryCache): void;
 //# sourceMappingURL=trades.d.ts.map

package/dist/tools/trades.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trades.d.ts","sourceRoot":"","sources":["../../src/tools/trades.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAkDzF"}
+{"version":3,"file":"trades.d.ts","sourceRoot":"","sources":["../../src/tools/trades.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;CAwBtB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAyDzF"}

package/dist/tools/trades.js

@@ -1,8 +1,31 @@
 import { z } from "zod";
 import { BudaApiError } from "../client.js";
+import { validateMarketId } from "../validation.js";
+export const toolSchema = {
+    name: "get_trades",
+    description: "Get recent trade history for a Buda.com market. Each entry contains " +
+        "[timestamp_ms, amount, price, direction]. Direction is 'buy' or 'sell'.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            market_id: {
+                type: "string",
+                description: "Market ID (e.g. 'BTC-CLP', 'ETH-BTC').",
+            },
+            limit: {
+                type: "number",
+                description: "Number of trades to return (default: 50, max: 100).",
+            },
+            timestamp: {
+                type: "number",
+                description: "Unix timestamp (seconds) to paginate from. Returns trades older than this timestamp.",
+            },
+        },
+        required: ["market_id"],
+    },
+};
 export function register(server, client, _cache) {
-    server.tool("get_trades", "Get recent trade history for a Buda.com market. Each entry contains " +
-        "[timestamp_ms, amount, price, direction]. Direction is 'buy' or 'sell'.", {
+    server.tool(toolSchema.name, toolSchema.description, {
         market_id: z
             .string()
             .describe("Market ID (e.g. 'BTC-CLP', 'ETH-BTC')."),
@@ -20,6 +43,13 @@ export function register(server, client, _cache) {
             .describe("Unix timestamp (seconds) to paginate from. Returns trades older than this timestamp."),
     }, async ({ market_id, limit, timestamp }) => {
         try {
+            const validationError = validateMarketId(market_id);
+            if (validationError) {
+                return {
+                    content: [{ type: "text", text: JSON.stringify({ error: validationError, code: "INVALID_MARKET_ID" }) }],
+                    isError: true,
+                };
+            }
             const params = {};
             if (limit !== undefined)
                 params.limit = limit;

package/dist/tools/volume.d.ts

@@ -1,5 +1,19 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { BudaClient } from "../client.js";
 import { MemoryCache } from "../cache.js";
+export declare const toolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            market_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
 export declare function register(server: McpServer, client: BudaClient, _cache: MemoryCache): void;
 //# sourceMappingURL=volume.d.ts.map

package/dist/tools/volume.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"volume.d.ts","sourceRoot":"","sources":["../../src/tools/volume.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CA8BzF"}
+{"version":3,"file":"volume.d.ts","sourceRoot":"","sources":["../../src/tools/volume.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAetB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAqCzF"}