@guiie/buda-mcp 1.2.0 → 1.2.1

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

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guiie/buda-mcp",
-  "version": "1.2.0",
+  "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",