@guiie/buda-mcp 1.0.0 → 1.1.0

package/dist/http.js

@@ -0,0 +1,262 @@
+import express from "express";
+import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { BudaClient } from "./client.js";
+import { MemoryCache, CACHE_TTL } from "./cache.js";
+import * as markets from "./tools/markets.js";
+import * as ticker from "./tools/ticker.js";
+import * as orderbook from "./tools/orderbook.js";
+import * as trades from "./tools/trades.js";
+import * as volume from "./tools/volume.js";
+import * as spread from "./tools/spread.js";
+import * as compareMarkets from "./tools/compare_markets.js";
+import * as priceHistory from "./tools/price_history.js";
+import * as balances from "./tools/balances.js";
+import * as orders from "./tools/orders.js";
+import * as placeOrder from "./tools/place_order.js";
+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();
+function createServer() {
+    const server = new McpServer({ name: "buda-mcp", version: "1.1.0" });
+    // Per-request cache so caching works correctly for stateless HTTP
+    const reqCache = new MemoryCache();
+    markets.register(server, client, reqCache);
+    ticker.register(server, client, reqCache);
+    orderbook.register(server, client, reqCache);
+    trades.register(server, client, reqCache);
+    volume.register(server, client, reqCache);
+    spread.register(server, client, reqCache);
+    compareMarkets.register(server, client, reqCache);
+    priceHistory.register(server, client, reqCache);
+    if (authEnabled) {
+        balances.register(server, client);
+        orders.register(server, client);
+        placeOrder.register(server, client);
+        cancelOrder.register(server, client);
+    }
+    // MCP Resources
+    server.resource("buda-markets", "buda://markets", async (uri) => {
+        const data = await reqCache.getOrFetch("markets", CACHE_TTL.MARKETS, () => client.get("/markets"));
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "application/json",
+                    text: JSON.stringify(data.markets, null, 2),
+                },
+            ],
+        };
+    });
+    server.resource("buda-ticker", new ResourceTemplate("buda://ticker/{market}", { list: undefined }), async (uri, params) => {
+        const marketId = params.market.toLowerCase();
+        const data = await reqCache.getOrFetch(`ticker:${marketId}`, CACHE_TTL.TICKER, () => client.get(`/markets/${marketId}/ticker`));
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "application/json",
+                    text: JSON.stringify(data.ticker, null, 2),
+                },
+            ],
+        };
+    });
+    return server;
+}
+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.0", auth_mode: authEnabled ? "authenticated" : "public" });
+});
+// Smithery static server card — lets Smithery scan tools without running the server
+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.0" },
+        authentication: { required: authEnabled },
+        tools: [...publicTools, ...authTools],
+        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" },
+        ],
+        prompts: [],
+    });
+});
+// Stateless StreamableHTTP — new server instance per request (no session state needed)
+app.post("/mcp", async (req, res) => {
+    const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: undefined,
+    });
+    res.on("close", () => {
+        transport.close();
+    });
+    const server = createServer();
+    await server.connect(transport);
+    await transport.handleRequest(req, res, req.body);
+});
+// SSE upgrade for clients that prefer streaming
+app.get("/mcp", async (req, res) => {
+    const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: undefined,
+    });
+    res.on("close", () => {
+        transport.close();
+    });
+    const server = createServer();
+    await server.connect(transport);
+    await transport.handleRequest(req, res);
+});
+app.delete("/mcp", async (_req, res) => {
+    res.status(405).json({ error: "Sessions not supported (stateless server)" });
+});
+app.listen(PORT, () => {
+    console.log(`buda-mcp HTTP server listening on port ${PORT}`);
+    console.log(`  MCP endpoint:  http://localhost:${PORT}/mcp`);
+    console.log(`  Health check:  http://localhost:${PORT}/health`);
+    console.log(`  Auth mode:     ${authEnabled ? "authenticated" : "public (no credentials)"}`);
+});
+//# sourceMappingURL=http.js.map

package/dist/index.js

@@ -1,23 +1,67 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 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 * as markets from "./tools/markets.js";
 import * as ticker from "./tools/ticker.js";
 import * as orderbook from "./tools/orderbook.js";
 import * as trades from "./tools/trades.js";
 import * as volume from "./tools/volume.js";
+import * as spread from "./tools/spread.js";
+import * as compareMarkets from "./tools/compare_markets.js";
+import * as priceHistory from "./tools/price_history.js";
+import * as balances from "./tools/balances.js";
+import * as orders from "./tools/orders.js";
+import * as placeOrder from "./tools/place_order.js";
+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.0.0",
+    version: "1.1.0",
+});
+// Public tools
+markets.register(server, client, cache);
+ticker.register(server, client, cache);
+orderbook.register(server, client, cache);
+trades.register(server, client, cache);
+volume.register(server, client, cache);
+spread.register(server, client, cache);
+compareMarkets.register(server, client, cache);
+priceHistory.register(server, client, cache);
+// Auth-gated tools — only registered when API credentials are present
+if (client.hasAuth()) {
+    balances.register(server, client);
+    orders.register(server, client);
+    placeOrder.register(server, client);
+    cancelOrder.register(server, client);
+}
+// MCP Resources
+server.resource("buda-markets", "buda://markets", async (uri) => {
+    const data = await cache.getOrFetch("markets", CACHE_TTL.MARKETS, () => client.get("/markets"));
+    return {
+        contents: [
+            {
+                uri: uri.href,
+                mimeType: "application/json",
+                text: JSON.stringify(data.markets, null, 2),
+            },
+        ],
+    };
+});
+server.resource("buda-ticker", new ResourceTemplate("buda://ticker/{market}", { list: undefined }), async (uri, params) => {
+    const marketId = params.market.toLowerCase();
+    const data = await cache.getOrFetch(`ticker:${marketId}`, CACHE_TTL.TICKER, () => client.get(`/markets/${marketId}/ticker`));
+    return {
+        contents: [
+            {
+                uri: uri.href,
+                mimeType: "application/json",
+                text: JSON.stringify(data.ticker, null, 2),
+            },
+        ],
+    };
 });
-const client = new BudaClient();
-// Register all public-endpoint tools
-markets.register(server, client);
-ticker.register(server, client);
-orderbook.register(server, client);
-trades.register(server, client);
-volume.register(server, client);
-// Start the server over stdio (standard MCP transport)
 const transport = new StdioServerTransport();
 await server.connect(transport);
 //# sourceMappingURL=index.js.map

package/dist/tools/balances.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BudaClient } from "../client.js";
+export declare function register(server: McpServer, client: BudaClient): void;
+//# sourceMappingURL=balances.d.ts.map

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

@@ -0,0 +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"}

package/dist/tools/balances.js

@@ -0,0 +1,23 @@
+import { BudaApiError } from "../client.js";
+export function register(server, client) {
+    server.tool("get_balances", "Get all currency balances for the authenticated Buda.com account. " +
+        "Returns total, available, frozen, and pending withdrawal amounts per currency. " +
+        "Requires BUDA_API_KEY and BUDA_API_SECRET environment variables.", {}, async () => {
+        try {
+            const data = await client.get("/balances");
+            return {
+                content: [{ type: "text", text: JSON.stringify(data.balances, 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,
+            };
+        }
+    });
+}
+//# sourceMappingURL=balances.js.map

package/dist/tools/cancel_order.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BudaClient } from "../client.js";
+export declare function register(server: McpServer, client: BudaClient): void;
+//# sourceMappingURL=cancel_order.d.ts.map

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

@@ -0,0 +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"}

package/dist/tools/cancel_order.js

@@ -0,0 +1,53 @@
+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. " +
+        "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.", {
+        order_id: z
+            .number()
+            .int()
+            .positive()
+            .describe("The numeric ID of the order to cancel."),
+        confirmation_token: z
+            .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,
+            };
+        }
+    });
+}
+//# sourceMappingURL=cancel_order.js.map

package/dist/tools/compare_markets.d.ts

@@ -0,0 +1,5 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BudaClient } from "../client.js";
+import { MemoryCache } from "../cache.js";
+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

@@ -0,0 +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"}

package/dist/tools/compare_markets.js

@@ -0,0 +1,65 @@
+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 " +
+        "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.", {
+        base_currency: z
+            .string()
+            .describe("Base currency to compare across all available markets (e.g. 'BTC', 'ETH', 'XRP')."),
+    }, async ({ base_currency }) => {
+        try {
+            const base = base_currency.toUpperCase();
+            const data = await cache.getOrFetch("tickers:all", CACHE_TTL.TICKER, () => client.get("/tickers"));
+            const matching = data.tickers.filter((t) => {
+                const [tickerBase] = t.market_id.split("-");
+                return tickerBase === base;
+            });
+            if (matching.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                error: `No markets found for base currency '${base}'.`,
+                                code: "NOT_FOUND",
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const result = {
+                base_currency: base,
+                markets: matching.map((t) => ({
+                    market_id: t.market_id,
+                    last_price: t.last_price[0],
+                    currency: t.last_price[1],
+                    best_bid: t.max_bid ? t.max_bid[0] : null,
+                    best_ask: t.min_ask ? t.min_ask[0] : null,
+                    volume_24h: t.volume ? t.volume[0] : null,
+                    price_change_24h: t.price_variation_24h
+                        ? (parseFloat(t.price_variation_24h) * 100).toFixed(2) + "%"
+                        : null,
+                    price_change_7d: t.price_variation_7d
+                        ? (parseFloat(t.price_variation_7d) * 100).toFixed(2) + "%"
+                        : null,
+                })),
+            };
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, 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,
+            };
+        }
+    });
+}
+//# sourceMappingURL=compare_markets.js.map

package/dist/tools/markets.d.ts

@@ -1,4 +1,5 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { BudaClient } from "../client.js";
-export declare function register(server: McpServer, client: BudaClient): void;
+import { MemoryCache } from "../cache.js";
+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,EAAE,MAAM,cAAc,CAAC;AAG1C,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CA6BpE"}
+{"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"}

package/dist/tools/markets.js

@@ -1,5 +1,7 @@
 import { z } from "zod";
-export function register(server, client) {
+import { BudaApiError } from "../client.js";
+import { CACHE_TTL } from "../cache.js";
+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.", {
         market_id: z
@@ -7,16 +9,28 @@ export function register(server, client) {
             .optional()
             .describe("Optional market ID (e.g. 'BTC-CLP', 'ETH-BTC'). Omit to list all markets."),
     }, async ({ market_id }) => {
-        if (market_id) {
-            const data = await client.get(`/markets/${market_id.toLowerCase()}`);
+        try {
+            if (market_id) {
+                const id = market_id.toLowerCase();
+                const data = await cache.getOrFetch(`market:${id}`, CACHE_TTL.MARKETS, () => client.get(`/markets/${id}`));
+                return {
+                    content: [{ type: "text", text: JSON.stringify(data.market, null, 2) }],
+                };
+            }
+            const data = await cache.getOrFetch("markets", CACHE_TTL.MARKETS, () => client.get("/markets"));
             return {
-                content: [{ type: "text", text: JSON.stringify(data.market, null, 2) }],
+                content: [{ type: "text", text: JSON.stringify(data.markets, 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,
             };
         }
-        const data = await client.get("/markets");
-        return {
-            content: [{ type: "text", text: JSON.stringify(data.markets, null, 2) }],
-        };
     });
 }
 //# sourceMappingURL=markets.js.map

package/dist/tools/orderbook.d.ts

@@ -1,4 +1,5 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { BudaClient } from "../client.js";
-export declare function register(server: McpServer, client: BudaClient): void;
+import { MemoryCache } from "../cache.js";
+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,EAAE,MAAM,cAAc,CAAC;AAG1C,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAkCpE"}
+{"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"}

package/dist/tools/orderbook.js

@@ -1,6 +1,8 @@
 import { z } from "zod";
-export function register(server, client) {
-    server.tool("get_orderbook", "Get the current order book for a Buda.com market. Returns sorted arrays of " +
+import { BudaApiError } from "../client.js";
+import { CACHE_TTL } from "../cache.js";
+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.", {
         market_id: z
             .string()
@@ -12,17 +14,29 @@ export function register(server, client) {
             .optional()
             .describe("Maximum number of levels to return per side (default: all)."),
     }, async ({ market_id, limit }) => {
-        const data = await client.get(`/markets/${market_id.toLowerCase()}/order_book`);
-        const book = data.order_book;
-        const result = {
-            bids: limit ? book.bids.slice(0, limit) : book.bids,
-            asks: limit ? book.asks.slice(0, limit) : book.asks,
-            bid_count: book.bids.length,
-            ask_count: book.asks.length,
-        };
-        return {
-            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-        };
+        try {
+            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;
+            const result = {
+                bids: limit ? book.bids.slice(0, limit) : book.bids,
+                asks: limit ? book.asks.slice(0, limit) : book.asks,
+                bid_count: book.bids.length,
+                ask_count: book.asks.length,
+            };
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, 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,
+            };
+        }
     });
 }
 //# sourceMappingURL=orderbook.js.map

package/dist/tools/orders.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BudaClient } from "../client.js";
+export declare function register(server: McpServer, client: BudaClient): void;
+//# sourceMappingURL=orders.d.ts.map

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

@@ -0,0 +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"}