@guiie/buda-mcp 1.1.2 → 1.2.1

package/dist/http.js

@@ -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 * as markets from "./tools/markets.js";
 import * as ticker from "./tools/ticker.js";
 import * as orderbook from "./tools/orderbook.js";
@@ -18,8 +19,26 @@ import * as cancelOrder from "./tools/cancel_order.js";
 const PORT = parseInt(process.env.PORT ?? "3000", 10);
 const client = new BudaClient(undefined, process.env.BUDA_API_KEY, process.env.BUDA_API_SECRET);
 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() {
-    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();
     markets.register(server, client, reqCache);
@@ -68,157 +87,20 @@ const app = express();
 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/dist/index.js

@@ -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 * as markets from "./tools/markets.js";
 import * as ticker from "./tools/ticker.js";
 import * as orderbook from "./tools/orderbook.js";
@@ -18,7 +19,7 @@ import * as cancelOrder from "./tools/cancel_order.js";
 const client = new BudaClient(undefined, process.env.BUDA_API_KEY, process.env.BUDA_API_SECRET);
 const server = new McpServer({
     name: "buda-mcp",
-    version: "1.1.2",
+    version: VERSION,
 });
 // Public tools
 markets.register(server, client, cache);

package/dist/tools/balances.d.ts

@@ -1,4 +1,12 @@
 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: {};
+    };
+};
 export declare function register(server: McpServer, client: BudaClient): void;
 //# sourceMappingURL=balances.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"balances.d.ts","sourceRoot":"","sources":["../../src/tools/balances.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AAGxD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAyBpE"}
+{"version":3,"file":"balances.d.ts","sourceRoot":"","sources":["../../src/tools/balances.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AAGxD,eAAO,MAAM,UAAU;;;;;;;CAUtB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAuBpE"}

package/dist/tools/balances.js

@@ -1,8 +1,16 @@
 import { BudaApiError } from "../client.js";
-export function register(server, client) {
-    server.tool("get_balances", "Get all currency balances for the authenticated Buda.com account. " +
+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.", {}, async () => {
+        "Requires BUDA_API_KEY and BUDA_API_SECRET environment variables.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+    },
+};
+export function register(server, client) {
+    server.tool(toolSchema.name, toolSchema.description, {}, async () => {
         try {
             const data = await client.get("/balances");
             return {

package/dist/tools/cancel_order.d.ts

@@ -1,4 +1,34 @@
 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: {
+            order_id: {
+                type: string;
+                description: string;
+            };
+            confirmation_token: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+type CancelOrderArgs = {
+    order_id: number;
+    confirmation_token: string;
+};
+export declare function handleCancelOrder(args: CancelOrderArgs, client: BudaClient): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
 export declare function register(server: McpServer, client: BudaClient): void;
+export {};
 //# sourceMappingURL=cancel_order.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"cancel_order.d.ts","sourceRoot":"","sources":["../../src/tools/cancel_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,CA2DpE"}
+{"version":3,"file":"cancel_order.d.ts","sourceRoot":"","sources":["../../src/tools/cancel_order.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AAGxD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;CAuBtB,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,eAAe,EACrB,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,CAuChF;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAmBpE"}

package/dist/tools/cancel_order.js

@@ -1,10 +1,65 @@
 import { z } from "zod";
 import { BudaApiError } from "../client.js";
-export function register(server, client) {
-    server.tool("cancel_order", "Cancel an open order by ID on Buda.com. " +
+export const toolSchema = {
+    name: "cancel_order",
+    description: "Cancel an open order by ID on Buda.com. " +
         "IMPORTANT: To prevent accidental cancellation from ambiguous prompts, you must pass " +
         "confirmation_token='CONFIRM' to execute. " +
-        "Requires BUDA_API_KEY and BUDA_API_SECRET environment variables.", {
+        "Requires BUDA_API_KEY and BUDA_API_SECRET environment variables.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            order_id: {
+                type: "number",
+                description: "The numeric ID of the order to cancel.",
+            },
+            confirmation_token: {
+                type: "string",
+                description: "Safety confirmation. Must equal exactly 'CONFIRM' (case-sensitive) to cancel the order. " +
+                    "Any other value will reject the request without canceling.",
+            },
+        },
+        required: ["order_id", "confirmation_token"],
+    },
+};
+export async function handleCancelOrder(args, client) {
+    const { order_id, confirmation_token } = args;
+    if (confirmation_token !== "CONFIRM") {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        error: "Order not canceled. confirmation_token must equal 'CONFIRM' to execute. " +
+                            "Verify the order ID and set confirmation_token='CONFIRM' to proceed.",
+                        code: "CONFIRMATION_REQUIRED",
+                        order_id,
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    try {
+        const data = await client.put(`/orders/${order_id}`, {
+            state: "canceling",
+        });
+        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, {
         order_id: z
             .number()
             .int()
@@ -14,40 +69,6 @@ export function register(server, client) {
             .string()
             .describe("Safety confirmation. Must equal exactly 'CONFIRM' (case-sensitive) to cancel the order. " +
             "Any other value will reject the request without canceling."),
-    }, async ({ order_id, confirmation_token }) => {
-        if (confirmation_token !== "CONFIRM") {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: JSON.stringify({
-                            error: "Order not canceled. confirmation_token must equal 'CONFIRM' to execute. " +
-                                "Verify the order ID and set confirmation_token='CONFIRM' to proceed.",
-                            code: "CONFIRMATION_REQUIRED",
-                            order_id,
-                        }),
-                    },
-                ],
-                isError: true,
-            };
-        }
-        try {
-            const data = await client.put(`/orders/${order_id}`, {
-                state: "canceling",
-            });
-            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) => handleCancelOrder(args, client));
 }
 //# sourceMappingURL=cancel_order.js.map

package/dist/tools/compare_markets.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: {
+            base_currency: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
 export declare function register(server: McpServer, client: BudaClient, cache: MemoryCache): void;
 //# sourceMappingURL=compare_markets.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"compare_markets.d.ts","sourceRoot":"","sources":["../../src/tools/compare_markets.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,CA2ExF"}
+{"version":3,"file":"compare_markets.d.ts","sourceRoot":"","sources":["../../src/tools/compare_markets.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,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAiBtB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAyExF"}

package/dist/tools/compare_markets.js

@@ -1,10 +1,24 @@
 import { z } from "zod";
 import { BudaApiError } from "../client.js";
 import { CACHE_TTL } from "../cache.js";
-export function register(server, client, cache) {
-    server.tool("compare_markets", "Compare ticker data for all trading pairs of a given base currency across Buda.com's " +
+export const toolSchema = {
+    name: "compare_markets",
+    description: "Compare ticker data for all trading pairs of a given base currency across Buda.com's " +
         "supported quote currencies (CLP, COP, PEN, BTC, USDC, ETH). " +
-        "For example, passing 'BTC' returns side-by-side data for BTC-CLP, BTC-COP, BTC-PEN, etc.", {
+        "For example, passing 'BTC' returns side-by-side data for BTC-CLP, BTC-COP, BTC-PEN, etc.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            base_currency: {
+                type: "string",
+                description: "Base currency to compare across all available markets (e.g. 'BTC', 'ETH', 'XRP').",
+            },
+        },
+        required: ["base_currency"],
+    },
+};
+export function register(server, client, cache) {
+    server.tool(toolSchema.name, toolSchema.description, {
         base_currency: z
             .string()
             .describe("Base currency to compare across all available markets (e.g. 'BTC', 'ETH', 'XRP')."),

package/dist/tools/markets.d.ts

@@ -1,5 +1,18 @@
 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;
+            };
+        };
+    };
+};
 export declare function register(server: McpServer, client: BudaClient, cache: MemoryCache): void;
 //# sourceMappingURL=markets.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"markets.d.ts","sourceRoot":"","sources":["../../src/tools/markets.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,CA+CxF"}
+{"version":3,"file":"markets.d.ts","sourceRoot":"","sources":["../../src/tools/markets.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;;;;;;;;;;;;CActB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAsDxF"}

package/dist/tools/markets.js

@@ -1,9 +1,23 @@
 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_markets",
+    description: "List all available trading pairs on Buda.com, or get details for a specific market. " +
+        "Returns base/quote currencies, fees, and minimum order sizes.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            market_id: {
+                type: "string",
+                description: "Optional market ID (e.g. 'BTC-CLP', 'ETH-BTC'). Omit to list all markets.",
+            },
+        },
+    },
+};
 export function register(server, client, cache) {
-    server.tool("get_markets", "List all available trading pairs on Buda.com, or get details for a specific market. " +
-        "Returns base/quote currencies, fees, and minimum order sizes.", {
+    server.tool(toolSchema.name, toolSchema.description, {
         market_id: z
             .string()
             .optional()
@@ -11,6 +25,13 @@ export function register(server, client, cache) {
     }, async ({ market_id }) => {
         try {
             if (market_id) {
+                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(`market:${id}`, CACHE_TTL.MARKETS, () => client.get(`/markets/${id}`));
                 return {

package/dist/tools/orderbook.d.ts

@@ -1,5 +1,23 @@
 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;
+            };
+        };
+        required: string[];
+    };
+};
 export declare function register(server: McpServer, client: BudaClient, cache: MemoryCache): void;
 //# sourceMappingURL=orderbook.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"orderbook.d.ts","sourceRoot":"","sources":["../../src/tools/orderbook.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,CAgDxF"}
+{"version":3,"file":"orderbook.d.ts","sourceRoot":"","sources":["../../src/tools/orderbook.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;;;;;;;;;;;;;;;;;CAmBtB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAuDxF"}

package/dist/tools/orderbook.js

@@ -1,9 +1,28 @@
 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_orderbook",
+    description: "Get the current order book (bids and asks) for a Buda.com market. Returns sorted arrays of " +
+        "bids (buy orders) and asks (sell orders), each as [price, amount] pairs.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            market_id: {
+                type: "string",
+                description: "Market ID (e.g. 'BTC-CLP', 'ETH-BTC').",
+            },
+            limit: {
+                type: "number",
+                description: "Maximum number of levels to return per side (default: all).",
+            },
+        },
+        required: ["market_id"],
+    },
+};
 export function register(server, client, cache) {
-    server.tool("get_orderbook", "Get the current order book (bids and asks) for a Buda.com market. Returns sorted arrays of " +
-        "bids (buy orders) and asks (sell orders), each as [price, amount] pairs.", {
+    server.tool(toolSchema.name, toolSchema.description, {
         market_id: z
             .string()
             .describe("Market ID (e.g. 'BTC-CLP', 'ETH-BTC')."),
@@ -15,6 +34,13 @@ export function register(server, client, cache) {
             .describe("Maximum number of levels to return per side (default: all)."),
     }, async ({ market_id, 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 data = await cache.getOrFetch(`orderbook:${id}`, CACHE_TTL.ORDERBOOK, () => client.get(`/markets/${id}/order_book`));
             const book = data.order_book;

package/dist/tools/orders.d.ts

@@ -1,4 +1,30 @@
 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;
+            };
+            state: {
+                type: string;
+                description: string;
+            };
+            per: {
+                type: string;
+                description: string;
+            };
+            page: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
 export declare function register(server: McpServer, client: BudaClient): void;
 //# sourceMappingURL=orders.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"orders.d.ts","sourceRoot":"","sources":["../../src/tools/orders.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,CA8DpE"}
+{"version":3,"file":"orders.d.ts","sourceRoot":"","sources":["../../src/tools/orders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AAIxD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;CA4BtB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAqEpE"}