@guiie/buda-mcp 1.2.2 → 1.4.0

package/dist/tools/balances.js

@@ -1,9 +1,12 @@
 import { BudaApiError } from "../client.js";
+import { flattenAmount } from "../utils.js";
 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.",
+    description: "Returns all currency balances for the authenticated Buda.com account as flat typed objects. " +
+        "Each currency entry includes total amount, available amount (not frozen), frozen amount, and " +
+        "pending withdrawal amount — all as floats with separate _currency fields. " +
+        "Requires BUDA_API_KEY and BUDA_API_SECRET. " +
+        "Example: 'How much BTC do I have available to trade right now?'",
     inputSchema: {
         type: "object",
         properties: {},
@@ -13,8 +16,25 @@ export function register(server, client) {
     server.tool(toolSchema.name, toolSchema.description, {}, async () => {
         try {
             const data = await client.get("/balances");
+            const result = data.balances.map((b) => {
+                const amount = flattenAmount(b.amount);
+                const available = flattenAmount(b.available_amount);
+                const frozen = flattenAmount(b.frozen_amount);
+                const pending = flattenAmount(b.pending_withdraw_amount);
+                return {
+                    id: b.id,
+                    amount: amount.value,
+                    amount_currency: amount.currency,
+                    available_amount: available.value,
+                    available_amount_currency: available.currency,
+                    frozen_amount: frozen.value,
+                    frozen_amount_currency: frozen.currency,
+                    pending_withdraw_amount: pending.value,
+                    pending_withdraw_amount_currency: pending.currency,
+                };
+            });
             return {
-                content: [{ type: "text", text: JSON.stringify(data.balances, null, 2) }],
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
             };
         }
         catch (err) {

package/dist/tools/calculate_position_size.d.ts

@@ -0,0 +1,48 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const toolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            market_id: {
+                type: string;
+                description: string;
+            };
+            capital: {
+                type: string;
+                description: string;
+            };
+            risk_pct: {
+                type: string;
+                description: string;
+            };
+            entry_price: {
+                type: string;
+                description: string;
+            };
+            stop_loss_price: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+type CalculatePositionSizeArgs = {
+    market_id: string;
+    capital: number;
+    risk_pct: number;
+    entry_price: number;
+    stop_loss_price: number;
+};
+export declare function handleCalculatePositionSize(args: CalculatePositionSizeArgs): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+};
+export declare function register(server: McpServer): void;
+export {};
+//# sourceMappingURL=calculate_position_size.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calculate_position_size.d.ts","sourceRoot":"","sources":["../../src/tools/calculate_position_size.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCtB,CAAC;AAEF,KAAK,yBAAyB,GAAG;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,yBAAyB,GAC9B;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,CA0DvE;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8BhD"}

package/dist/tools/calculate_position_size.js

@@ -0,0 +1,111 @@
+import { z } from "zod";
+import { validateMarketId } from "../validation.js";
+export const toolSchema = {
+    name: "calculate_position_size",
+    description: "Calculates position size based on your capital, risk tolerance, entry price, and stop-loss. " +
+        "Determines how many units to buy or sell so that a stop-loss hit costs exactly risk_pct% of capital. " +
+        "Fully client-side — no API call is made. " +
+        "Example: 'How many BTC can I buy on BTC-CLP if I have 1,000,000 CLP, risk 2%, entry 80,000,000 CLP, stop at 78,000,000 CLP?'",
+    inputSchema: {
+        type: "object",
+        properties: {
+            market_id: {
+                type: "string",
+                description: "Market ID (e.g. 'BTC-CLP', 'ETH-COP'). Used to derive the quote currency.",
+            },
+            capital: {
+                type: "number",
+                description: "Total available capital in the quote currency (e.g. CLP for BTC-CLP).",
+            },
+            risk_pct: {
+                type: "number",
+                description: "Percentage of capital to risk on this trade (0.1–10, e.g. 2 = 2%).",
+            },
+            entry_price: {
+                type: "number",
+                description: "Planned entry price in quote currency.",
+            },
+            stop_loss_price: {
+                type: "number",
+                description: "Stop-loss price in quote currency. Must be below entry for buys, above entry for sells.",
+            },
+        },
+        required: ["market_id", "capital", "risk_pct", "entry_price", "stop_loss_price"],
+    },
+};
+export function handleCalculatePositionSize(args) {
+    const { market_id, capital, risk_pct, entry_price, stop_loss_price } = args;
+    const validationError = validateMarketId(market_id);
+    if (validationError) {
+        return {
+            content: [{ type: "text", text: JSON.stringify({ error: validationError, code: "INVALID_MARKET_ID" }) }],
+            isError: true,
+        };
+    }
+    if (stop_loss_price === entry_price) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        error: "stop_loss_price must differ from entry_price.",
+                        code: "INVALID_STOP_LOSS",
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    const quoteCurrency = market_id.split("-")[1].toUpperCase();
+    const baseCurrency = market_id.split("-")[0].toUpperCase();
+    const side = stop_loss_price < entry_price ? "buy" : "sell";
+    const capitalAtRisk = capital * (risk_pct / 100);
+    const riskPerUnit = Math.abs(entry_price - stop_loss_price);
+    const units = capitalAtRisk / riskPerUnit;
+    const positionValue = units * entry_price;
+    const feeImpact = parseFloat((positionValue * 0.008).toFixed(8));
+    const riskRewardNote = `${side === "buy" ? "Buy" : "Sell"} ${units.toFixed(8)} ${baseCurrency} at ${entry_price} ${quoteCurrency} ` +
+        `with stop at ${stop_loss_price} ${quoteCurrency}. ` +
+        `Risking ${risk_pct}% of capital (${capitalAtRisk.toFixed(2)} ${quoteCurrency}) ` +
+        `on a ${riskPerUnit.toFixed(2)} ${quoteCurrency}/unit move. ` +
+        `Estimated entry fee: ${feeImpact.toFixed(2)} ${quoteCurrency} (0.8% taker, conservative estimate).`;
+    const result = {
+        market_id: market_id.toUpperCase(),
+        side,
+        units: parseFloat(units.toFixed(8)),
+        base_currency: baseCurrency,
+        capital_at_risk: parseFloat(capitalAtRisk.toFixed(2)),
+        position_value: parseFloat(positionValue.toFixed(2)),
+        fee_impact: feeImpact,
+        fee_currency: quoteCurrency,
+        risk_reward_note: riskRewardNote,
+    };
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+}
+export function register(server) {
+    server.tool(toolSchema.name, toolSchema.description, {
+        market_id: z
+            .string()
+            .describe("Market ID (e.g. 'BTC-CLP', 'ETH-COP'). Used to derive the quote currency."),
+        capital: z
+            .number()
+            .positive()
+            .describe("Total available capital in the quote currency (e.g. CLP for BTC-CLP)."),
+        risk_pct: z
+            .number()
+            .min(0.1)
+            .max(10)
+            .describe("Percentage of capital to risk on this trade (0.1–10, e.g. 2 = 2%)."),
+        entry_price: z
+            .number()
+            .positive()
+            .describe("Planned entry price in quote currency."),
+        stop_loss_price: z
+            .number()
+            .positive()
+            .describe("Stop-loss price in quote currency. Must be below entry for buys, above entry for sells."),
+    }, (args) => handleCalculatePositionSize(args));
+}
+//# sourceMappingURL=calculate_position_size.js.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,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAiBtB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAyExF"}
+{"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;;;;;;;;;;;;;CAkBtB,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

@@ -3,9 +3,10 @@ import { BudaApiError } from "../client.js";
 import { CACHE_TTL } from "../cache.js";
 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.",
+    description: "Returns side-by-side ticker data for all trading pairs of a given base currency across Buda.com's " +
+        "supported quote currencies (CLP, COP, PEN, BTC, USDC, ETH). All prices are floats; " +
+        "price_change_24h and price_change_7d are floats in percent (e.g. 1.23 means +1.23%). " +
+        "Example: 'In which country is Bitcoin currently most expensive on Buda?'",
     inputSchema: {
         type: "object",
         properties: {
@@ -48,16 +49,16 @@ export function register(server, client, cache) {
                 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,
+                    last_price: parseFloat(t.last_price[0]),
+                    last_price_currency: t.last_price[1],
+                    best_bid: t.max_bid ? parseFloat(t.max_bid[0]) : null,
+                    best_ask: t.min_ask ? parseFloat(t.min_ask[0]) : null,
+                    volume_24h: t.volume ? parseFloat(t.volume[0]) : null,
                     price_change_24h: t.price_variation_24h
-                        ? (parseFloat(t.price_variation_24h) * 100).toFixed(2) + "%"
+                        ? parseFloat((parseFloat(t.price_variation_24h) * 100).toFixed(4))
                         : null,
                     price_change_7d: t.price_variation_7d
-                        ? (parseFloat(t.price_variation_7d) * 100).toFixed(2) + "%"
+                        ? parseFloat((parseFloat(t.price_variation_7d) * 100).toFixed(4))
                         : null,
                 })),
             };

package/dist/tools/dead_mans_switch.d.ts

@@ -0,0 +1,84 @@
+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;
+            };
+            ttl_seconds: {
+                type: string;
+                description: string;
+            };
+            confirmation_token: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const renewToolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            market_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const disarmToolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            market_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+type ScheduleArgs = {
+    market_id: string;
+    ttl_seconds: number;
+    confirmation_token: string;
+};
+export declare function handleScheduleCancelAll(args: ScheduleArgs, client: BudaClient): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+type MarketOnlyArgs = {
+    market_id: string;
+};
+export declare function handleRenewCancelTimer({ market_id }: MarketOnlyArgs, client: BudaClient): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+};
+export declare function handleDisarmCancelTimer({ market_id }: MarketOnlyArgs): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+};
+export declare function register(server: McpServer, client: BudaClient): void;
+export {};
+//# sourceMappingURL=dead_mans_switch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dead_mans_switch.d.ts","sourceRoot":"","sources":["../../src/tools/dead_mans_switch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AAiDxD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;CA2BtB,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;;;;CAgB3B,CAAC;AAEF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;CAgB5B,CAAC;AAIF,KAAK,YAAY,GAAG;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,YAAY,EAClB,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,CA+ChF;AAED,KAAK,cAAc,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5C,wBAAgB,sBAAsB,CACpC,EAAE,SAAS,EAAE,EAAE,cAAc,EAC7B,MAAM,EAAE,UAAU,GACjB;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,CA0CvE;AAED,wBAAgB,uBAAuB,CACrC,EAAE,SAAS,EAAE,EAAE,cAAc,GAC5B;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,CAwCvE;AAID,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CA0CpE"}

package/dist/tools/dead_mans_switch.js

@@ -0,0 +1,236 @@
+import { z } from "zod";
+import { validateMarketId } from "../validation.js";
+const timers = new Map();
+async function cancelAllOrdersForMarket(marketId, client) {
+    try {
+        const data = await client.get(`/markets/${marketId}/orders`, { state: "pending", per: 300 });
+        const orders = data.orders ?? [];
+        await Promise.allSettled(orders.map((order) => client.put(`/orders/${order.id}`, { state: "canceling" })));
+        timers.delete(marketId);
+    }
+    catch {
+        // Swallow errors — the timer has fired; we cannot surface them to the caller
+        timers.delete(marketId);
+    }
+}
+function armTimer(marketId, ttlSeconds, client) {
+    const existing = timers.get(marketId);
+    if (existing)
+        clearTimeout(existing.timeout);
+    const expiresAt = Date.now() + ttlSeconds * 1000;
+    const timeout = setTimeout(() => {
+        void cancelAllOrdersForMarket(marketId, client);
+    }, ttlSeconds * 1000);
+    const entry = { timeout, expiresAt, ttlSeconds };
+    timers.set(marketId, entry);
+    return entry;
+}
+// ---- Tool schemas ----
+export const toolSchema = {
+    name: "schedule_cancel_all",
+    description: "WARNING: timer state is lost on server restart. Not suitable as a production dead man's switch " +
+        "on hosted deployments (e.g. Railway). Use only on locally-run instances.\n\n" +
+        "Arms an in-memory dead man's switch: if not renewed within ttl_seconds, all open orders for the " +
+        "market are automatically cancelled. Requires confirmation_token='CONFIRM' to activate. " +
+        "Use renew_cancel_timer to reset the countdown, or disarm_cancel_timer to cancel without touching orders. " +
+        "Requires BUDA_API_KEY and BUDA_API_SECRET environment variables.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            market_id: {
+                type: "string",
+                description: "Market ID to protect (e.g. 'BTC-CLP').",
+            },
+            ttl_seconds: {
+                type: "number",
+                description: "Seconds before all orders are cancelled if not renewed (10–300).",
+            },
+            confirmation_token: {
+                type: "string",
+                description: "Must equal exactly 'CONFIRM' (case-sensitive) to arm the switch.",
+            },
+        },
+        required: ["market_id", "ttl_seconds", "confirmation_token"],
+    },
+};
+export const renewToolSchema = {
+    name: "renew_cancel_timer",
+    description: "Resets the dead man's switch TTL for a market, preventing automatic order cancellation. " +
+        "No confirmation required. Requires an active timer set by schedule_cancel_all. " +
+        "Requires BUDA_API_KEY and BUDA_API_SECRET environment variables.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            market_id: {
+                type: "string",
+                description: "Market ID whose timer should be renewed (e.g. 'BTC-CLP').",
+            },
+        },
+        required: ["market_id"],
+    },
+};
+export const disarmToolSchema = {
+    name: "disarm_cancel_timer",
+    description: "Disarms the dead man's switch for a market without cancelling any orders. " +
+        "No confirmation required. Safe to call even if no timer is active. " +
+        "Requires BUDA_API_KEY and BUDA_API_SECRET environment variables.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            market_id: {
+                type: "string",
+                description: "Market ID whose timer should be disarmed (e.g. 'BTC-CLP').",
+            },
+        },
+        required: ["market_id"],
+    },
+};
+export async function handleScheduleCancelAll(args, client) {
+    const { market_id, ttl_seconds, confirmation_token } = args;
+    if (confirmation_token !== "CONFIRM") {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        error: "Dead man's switch not armed. confirmation_token must equal 'CONFIRM' to activate. " +
+                            "Review the parameters and set confirmation_token='CONFIRM' to proceed.",
+                        code: "CONFIRMATION_REQUIRED",
+                        market_id,
+                        ttl_seconds,
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    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 entry = armTimer(id, ttl_seconds, client);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    active: true,
+                    market_id: market_id.toUpperCase(),
+                    expires_at: new Date(entry.expiresAt).toISOString(),
+                    ttl_seconds,
+                    warning: "in-memory only — timer is lost on server restart. Not suitable for hosted deployments.",
+                }),
+            },
+        ],
+    };
+}
+export function handleRenewCancelTimer({ market_id }, client) {
+    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 existing = timers.get(id);
+    if (!existing) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        error: `No active dead man's switch for market ${market_id.toUpperCase()}. Arm one first with schedule_cancel_all.`,
+                        code: "NO_ACTIVE_TIMER",
+                        market_id: market_id.toUpperCase(),
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    const entry = armTimer(id, existing.ttlSeconds, client);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    active: true,
+                    market_id: market_id.toUpperCase(),
+                    expires_at: new Date(entry.expiresAt).toISOString(),
+                    ttl_seconds: entry.ttlSeconds,
+                }),
+            },
+        ],
+    };
+}
+export function handleDisarmCancelTimer({ 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 existing = timers.get(id);
+    if (!existing) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        disarmed: false,
+                        market_id: market_id.toUpperCase(),
+                        note: "No active timer for this market.",
+                    }),
+                },
+            ],
+        };
+    }
+    clearTimeout(existing.timeout);
+    timers.delete(id);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    disarmed: true,
+                    market_id: market_id.toUpperCase(),
+                }),
+            },
+        ],
+    };
+}
+// ---- Registration ----
+export function register(server, client) {
+    server.tool(toolSchema.name, toolSchema.description, {
+        market_id: z
+            .string()
+            .describe("Market ID to protect (e.g. 'BTC-CLP')."),
+        ttl_seconds: z
+            .number()
+            .int()
+            .min(10)
+            .max(300)
+            .describe("Seconds before all orders are cancelled if not renewed (10–300)."),
+        confirmation_token: z
+            .string()
+            .describe("Must equal exactly 'CONFIRM' (case-sensitive) to arm the switch."),
+    }, (args) => handleScheduleCancelAll(args, client));
+    server.tool(renewToolSchema.name, renewToolSchema.description, {
+        market_id: z
+            .string()
+            .describe("Market ID whose timer should be renewed (e.g. 'BTC-CLP')."),
+    }, (args) => handleRenewCancelTimer(args, client));
+    server.tool(disarmToolSchema.name, disarmToolSchema.description, {
+        market_id: z
+            .string()
+            .describe("Market ID whose timer should be disarmed (e.g. 'BTC-CLP')."),
+    }, (args) => handleDisarmCancelTimer(args));
+}
+//# sourceMappingURL=dead_mans_switch.js.map

package/dist/tools/market_sentiment.d.ts

@@ -0,0 +1,30 @@
+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[];
+    };
+};
+type MarketSentimentArgs = {
+    market_id: string;
+};
+export declare function handleMarketSentiment({ market_id }: MarketSentimentArgs, client: BudaClient, cache: MemoryCache): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare function register(server: McpServer, client: BudaClient, cache: MemoryCache): void;
+export {};
+//# sourceMappingURL=market_sentiment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"market_sentiment.d.ts","sourceRoot":"","sources":["../../src/tools/market_sentiment.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;;;;;;;;;;;;;CAiBtB,CAAC;AAUF,KAAK,mBAAmB,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,wBAAsB,qBAAqB,CACzC,EAAE,SAAS,EAAE,EAAE,mBAAmB,EAClC,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,WAAW,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,CAuFhF;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAWxF"}