@guiie/buda-mcp 1.2.0 → 1.2.2

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"}

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"}