@guiie/buda-mcp 1.3.0 → 1.4.0

package/dist/tools/technical_indicators.js

@@ -0,0 +1,223 @@
+import { z } from "zod";
+import { BudaApiError } from "../client.js";
+import { validateMarketId } from "../validation.js";
+import { aggregateTradesToCandles } from "../utils.js";
+export const toolSchema = {
+    name: "get_technical_indicators",
+    description: "Computes RSI (14), MACD (12/26/9), Bollinger Bands (20, 2σ), SMA 20, and SMA 50 " +
+        "from Buda trade history — no external data or libraries. " +
+        "Uses at least 500 trades for reliable results (set limit=1000 for maximum depth). " +
+        "Returns latest indicator values and signal interpretations (overbought/oversold, crossover, band position). " +
+        "If fewer than 50 candles are available after aggregation, returns a structured warning instead. " +
+        "Example: 'Is BTC-CLP RSI overbought on the 4-hour chart?'",
+    inputSchema: {
+        type: "object",
+        properties: {
+            market_id: {
+                type: "string",
+                description: "Market ID (e.g. 'BTC-CLP', 'ETH-BTC').",
+            },
+            period: {
+                type: "string",
+                description: "Candle period: '1h', '4h', or '1d'. Default: '1h'.",
+            },
+            limit: {
+                type: "number",
+                description: "Number of raw trades to fetch (default: 500, max: 1000). " +
+                    "More trades = more candles = more reliable indicators.",
+            },
+        },
+        required: ["market_id"],
+    },
+};
+// ---- Pure math helpers ----
+function sma(values, n) {
+    const slice = values.slice(-n);
+    return slice.reduce((sum, v) => sum + v, 0) / slice.length;
+}
+function ema(values, period) {
+    if (values.length < period)
+        return [];
+    const k = 2 / (period + 1);
+    const result = [];
+    // Seed with SMA of first `period` values
+    result.push(values.slice(0, period).reduce((s, v) => s + v, 0) / period);
+    for (let i = period; i < values.length; i++) {
+        result.push(values[i] * k + result[result.length - 1] * (1 - k));
+    }
+    return result;
+}
+function rsi(closes, period = 14) {
+    if (closes.length < period + 1)
+        return null;
+    const gains = [];
+    const losses = [];
+    for (let i = 1; i < closes.length; i++) {
+        const diff = closes[i] - closes[i - 1];
+        gains.push(diff > 0 ? diff : 0);
+        losses.push(diff < 0 ? -diff : 0);
+    }
+    // Use simple average for initial, then Wilder's smoothing
+    let avgGain = gains.slice(0, period).reduce((s, v) => s + v, 0) / period;
+    let avgLoss = losses.slice(0, period).reduce((s, v) => s + v, 0) / period;
+    for (let i = period; i < gains.length; i++) {
+        avgGain = (avgGain * (period - 1) + gains[i]) / period;
+        avgLoss = (avgLoss * (period - 1) + losses[i]) / period;
+    }
+    if (avgLoss === 0)
+        return 100;
+    const rs = avgGain / avgLoss;
+    return parseFloat((100 - 100 / (1 + rs)).toFixed(2));
+}
+function macd(closes, fast = 12, slow = 26, signalPeriod = 9) {
+    if (closes.length < slow + signalPeriod)
+        return null;
+    const ema12 = ema(closes, fast);
+    const ema26 = ema(closes, slow);
+    // Align: ema26 starts at index (slow-1) of closes; ema12 starts at index (fast-1)
+    // The MACD line length = ema26.length (shorter)
+    const offset = slow - fast;
+    const macdLine = ema26.map((e26, i) => ema12[i + offset] - e26);
+    const signalLine = ema(macdLine, signalPeriod);
+    if (signalLine.length === 0)
+        return null;
+    const lastMacd = macdLine[macdLine.length - 1];
+    const lastSignal = signalLine[signalLine.length - 1];
+    const histogram = lastMacd - lastSignal;
+    const prevHistogram = macdLine.length > 1 && signalLine.length > 1
+        ? macdLine[macdLine.length - 2] - signalLine[signalLine.length - 2]
+        : null;
+    return {
+        line: parseFloat(lastMacd.toFixed(2)),
+        signal: parseFloat(lastSignal.toFixed(2)),
+        histogram: parseFloat(histogram.toFixed(2)),
+        prev_histogram: prevHistogram !== null ? parseFloat(prevHistogram.toFixed(2)) : null,
+    };
+}
+function bollingerBands(closes, period = 20, stdMult = 2) {
+    if (closes.length < period)
+        return null;
+    const slice = closes.slice(-period);
+    const mid = slice.reduce((s, v) => s + v, 0) / period;
+    const variance = slice.reduce((s, v) => s + (v - mid) ** 2, 0) / period;
+    const std = Math.sqrt(variance);
+    return {
+        upper: parseFloat((mid + stdMult * std).toFixed(2)),
+        mid: parseFloat(mid.toFixed(2)),
+        lower: parseFloat((mid - stdMult * std).toFixed(2)),
+    };
+}
+// ---- Tool handler ----
+const MIN_CANDLES = 50;
+export async function handleTechnicalIndicators(args, client) {
+    const { market_id, period, limit } = args;
+    const validationError = validateMarketId(market_id);
+    if (validationError) {
+        return {
+            content: [{ type: "text", text: JSON.stringify({ error: validationError, code: "INVALID_MARKET_ID" }) }],
+            isError: true,
+        };
+    }
+    try {
+        const id = market_id.toLowerCase();
+        const tradesLimit = Math.max(limit ?? 500, 500);
+        const data = await client.get(`/markets/${id}/trades`, { limit: tradesLimit });
+        const candles = aggregateTradesToCandles(data.trades.entries, period);
+        const closes = candles.map((c) => c.close);
+        if (candles.length < MIN_CANDLES) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            market_id: market_id.toUpperCase(),
+                            period,
+                            indicators: null,
+                            warning: "insufficient_data",
+                            candles_available: candles.length,
+                            minimum_required: MIN_CANDLES,
+                        }),
+                    },
+                ],
+            };
+        }
+        const rsiValue = rsi(closes, 14);
+        const macdResult = macd(closes, 12, 26, 9);
+        const bbResult = bollingerBands(closes, 20, 2);
+        const sma20 = parseFloat(sma(closes, 20).toFixed(2));
+        const sma50 = parseFloat(sma(closes, 50).toFixed(2));
+        const lastClose = closes[closes.length - 1];
+        // Signal interpretations
+        const rsiSignal = rsiValue !== null && rsiValue > 70
+            ? "overbought"
+            : rsiValue !== null && rsiValue < 30
+                ? "oversold"
+                : "neutral";
+        let macdSignal = "neutral";
+        if (macdResult && macdResult.prev_histogram !== null) {
+            if (macdResult.histogram > 0 && macdResult.prev_histogram <= 0) {
+                macdSignal = "bullish_crossover";
+            }
+            else if (macdResult.histogram < 0 && macdResult.prev_histogram >= 0) {
+                macdSignal = "bearish_crossover";
+            }
+        }
+        const bbSignal = bbResult && lastClose > bbResult.upper
+            ? "above_upper"
+            : bbResult && lastClose < bbResult.lower
+                ? "below_lower"
+                : "within_bands";
+        const result = {
+            market_id: market_id.toUpperCase(),
+            period,
+            candles_used: candles.length,
+            indicators: {
+                rsi: rsiValue,
+                macd: macdResult
+                    ? { line: macdResult.line, signal: macdResult.signal, histogram: macdResult.histogram }
+                    : null,
+                bollinger_bands: bbResult,
+                sma_20: sma20,
+                sma_50: sma50,
+            },
+            signals: {
+                rsi_signal: rsiSignal,
+                macd_signal: macdSignal,
+                bb_signal: bbSignal,
+            },
+            disclaimer: "Technical indicators are computed from Buda trade history. Not investment advice.",
+        };
+        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,
+        };
+    }
+}
+export function register(server, client) {
+    server.tool(toolSchema.name, toolSchema.description, {
+        market_id: z
+            .string()
+            .describe("Market ID (e.g. 'BTC-CLP', 'ETH-BTC')."),
+        period: z
+            .enum(["1h", "4h", "1d"])
+            .default("1h")
+            .describe("Candle period: '1h', '4h', or '1d'. Default: '1h'."),
+        limit: z
+            .number()
+            .int()
+            .min(500)
+            .max(1000)
+            .optional()
+            .describe("Number of raw trades to fetch (default: 500, max: 1000). " +
+            "More trades = more candles = more reliable indicators."),
+    }, (args) => handleTechnicalIndicators(args, client));
+}
+//# sourceMappingURL=technical_indicators.js.map

package/dist/types.d.ts

@@ -99,4 +99,13 @@ export interface OrdersResponse {
         total_pages: number;
     };
 }
+export interface OhlcvCandle {
+    time: string;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume: number;
+    trade_count: number;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/utils.d.ts

@@ -1,4 +1,4 @@
-import type { Amount } from "./types.js";
+import type { Amount, OhlcvCandle } from "./types.js";
 /**
  * Flattens a Buda API Amount tuple [value_string, currency] into a typed object.
  * All numeric strings are cast to float via parseFloat.
@@ -14,4 +14,10 @@ export declare function flattenAmount(amount: Amount): {
  * > 1%    → "low"
  */
 export declare function getLiquidityRating(spreadPct: number): "high" | "medium" | "low";
+/**
+ * Aggregates raw Buda trade entries (newest-first) into OHLCV candles for the given period.
+ * Entries must be in the format [timestamp_ms, amount, price, direction].
+ * Returns candles sorted ascending by bucket start time.
+ */
+export declare function aggregateTradesToCandles(entries: [string, string, string, string][], period: string): OhlcvCandle[];
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAEjF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAI/E"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEtD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAEjF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAI/E;AAQD;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,EAC3C,MAAM,EAAE,MAAM,GACb,WAAW,EAAE,CAoCf"}

package/dist/utils.js

@@ -18,4 +18,51 @@ export function getLiquidityRating(spreadPct) {
         return "medium";
     return "low";
 }
+const PERIOD_MS = {
+    "1h": 60 * 60 * 1000,
+    "4h": 4 * 60 * 60 * 1000,
+    "1d": 24 * 60 * 60 * 1000,
+};
+/**
+ * Aggregates raw Buda trade entries (newest-first) into OHLCV candles for the given period.
+ * Entries must be in the format [timestamp_ms, amount, price, direction].
+ * Returns candles sorted ascending by bucket start time.
+ */
+export function aggregateTradesToCandles(entries, period) {
+    const periodMs = PERIOD_MS[period];
+    if (!periodMs)
+        throw new Error(`Unknown period: ${period}`);
+    const sorted = [...entries].sort(([a], [b]) => parseInt(a, 10) - parseInt(b, 10));
+    const buckets = new Map();
+    for (const [tsMs, amount, price] of sorted) {
+        const ts = parseInt(tsMs, 10);
+        const bucketStart = Math.floor(ts / periodMs) * periodMs;
+        const p = parseFloat(price);
+        const v = parseFloat(amount);
+        if (!buckets.has(bucketStart)) {
+            buckets.set(bucketStart, {
+                time: new Date(bucketStart).toISOString(),
+                open: p,
+                high: p,
+                low: p,
+                close: p,
+                volume: v,
+                trade_count: 1,
+            });
+        }
+        else {
+            const candle = buckets.get(bucketStart);
+            if (p > candle.high)
+                candle.high = p;
+            if (p < candle.low)
+                candle.low = p;
+            candle.close = p;
+            candle.volume = parseFloat((candle.volume + v).toFixed(8));
+            candle.trade_count++;
+        }
+    }
+    return Array.from(buckets.entries())
+        .sort(([a], [b]) => a - b)
+        .map(([, candle]) => candle);
+}
 //# sourceMappingURL=utils.js.map

package/marketplace/README.md

@@ -1,4 +1,4 @@
-# Marketplace Submission Assets — v1.3.0
+# Marketplace Submission Assets — v1.4.0
 
 Ready-to-use assets for submitting buda-mcp to every major AI marketplace.
 Replace `gtorreal` / `gtorreal` with your actual handles before submitting.

package/marketplace/claude-listing.md

@@ -14,7 +14,7 @@ Real-time market data from [Buda.com](https://www.buda.com/), the leading crypto
 
 Use this server to query live prices, spreads, order books, OHLCV candles, trade history, volume, and cross-market arbitrage opportunities for all BTC, ETH, and altcoin markets quoted in CLP, COP, PEN, and USDC. Optional API credentials unlock account tools for balances and order management.
 
-**v1.3.0 output quality improvements:** All response schemas are now flat and fully typed — monetary amounts are returned as floats with separate `_currency` fields instead of `["amount", "currency"]` arrays, making responses directly usable by LLMs without parsing.
+**v1.4.0** adds 5 new tools: `simulate_order`, `calculate_position_size`, `get_market_sentiment`, `get_technical_indicators`, and a dead man's switch (`schedule_cancel_all` + `renew_cancel_timer` + `disarm_cancel_timer`). All response schemas are flat and fully typed.
 
 ---
 
@@ -62,6 +62,22 @@ OHLCV (open/high/low/close/volume) candles derived from recent trade history (Bu
 Detects cross-country price discrepancies for a given asset across Buda's CLP, COP, and PEN markets, normalized to USDC. Returns pairwise discrepancies above `threshold_pct` sorted by size. Includes a `fees_note` reminding that Buda's 0.8% taker fee per leg (~1.6% round-trip) must be deducted.  
 **Parameters:** `base_currency` *(required)* — e.g. `BTC`, `threshold_pct` *(optional, default 0.5)*.
 
+### `simulate_order`
+Simulates a buy or sell order using live ticker data — no order is ever placed. Returns `estimated_fill_price`, `fee_amount`, `fee_currency`, `total_cost`, and `slippage_vs_mid_pct`. All outputs include `simulation: true`. Uses actual taker fee from market data (0.8% crypto / 0.5% stablecoin).  
+**Parameters:** `market_id` *(required)*, `side` (`buy`|`sell`) *(required)*, `amount` *(required)*, `price` *(optional — omit for market order simulation)*.
+
+### `calculate_position_size`
+Calculates how many units to buy or sell so a stop-loss hit costs exactly `risk_pct`% of `capital`. Fully client-side — no API call. Returns `units`, `capital_at_risk`, `position_value`, `fee_impact`, and a plain-text `risk_reward_note`.  
+**Parameters:** `market_id`, `capital`, `risk_pct` (0.1–10), `entry_price`, `stop_loss_price` *(all required)*.
+
+### `get_market_sentiment`
+Composite sentiment score (−100 to +100) from three components: 24h price variation (40%), volume vs 7-day daily average (35%), spread vs market-type baseline (25%). Returns `score`, `label` (`bearish`/`neutral`/`bullish`), `component_breakdown`, and a `disclaimer`.  
+**Parameters:** `market_id` *(required)*.
+
+### `get_technical_indicators`
+RSI (14), MACD (12/26/9), Bollinger Bands (20, 2σ), SMA 20, and SMA 50 — computed server-side from Buda trade history (no external libraries). Returns latest values + signal interpretations. Returns a structured warning if fewer than 50 candles are available after aggregation. Includes `disclaimer`.  
+**Parameters:** `market_id` *(required)*, `period` (`1h`/`4h`/`1d`, default `1h`), `limit` *(optional, 500–1000)*.
+
 ### Authenticated tools (require `BUDA_API_KEY` + `BUDA_API_SECRET`)
 
 > **Important:** Authenticated instances must run locally only — never expose a server with API credentials publicly.
@@ -81,6 +97,19 @@ Place a limit or market order. Requires `confirmation_token="CONFIRM"` to preven
 Cancel an open order by ID. Requires `confirmation_token="CONFIRM"`.  
 **Parameters:** `order_id`, `confirmation_token`.
 
+### `schedule_cancel_all`
+**WARNING: timer state is lost on server restart. Use only on locally-run instances.**  
+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"`.  
+**Parameters:** `market_id`, `ttl_seconds` (10–300), `confirmation_token`.
+
+### `renew_cancel_timer`
+Resets the dead man's switch TTL for a market. No confirmation required. Must have an active timer.  
+**Parameters:** `market_id`.
+
+### `disarm_cancel_timer`
+Disarms the dead man's switch without cancelling any orders. Safe to call even with no active timer.  
+**Parameters:** `market_id`.
+
 ---
 
 ## MCP Resources
@@ -106,6 +135,11 @@ Cancel an open order by ID. Requires `confirmation_token="CONFIRM"`.
 - *"Show me hourly BTC-CLP candles."*
 - *"What's my available BTC balance?"* *(authenticated)*
 - *"Show my open orders on BTC-CLP."* *(authenticated)*
+- *"How much would it cost to buy 0.1 ETH on ETH-CLP right now?"*
+- *"How many BTC can I buy with 1M CLP if I risk 2% with a stop at 78M?"*
+- *"Is the BTC-CLP market bullish or bearish right now?"*
+- *"Is BTC-CLP RSI overbought on the 4-hour chart?"*
+- *"Arm a 60-second dead man's switch for my BTC-CLP orders."* *(authenticated)*
 
 ---
 

package/marketplace/gemini-tools.json

@@ -1,5 +1,5 @@
 {
-  "_comment": "Gemini function declarations for buda-mcp v1.3.0. Pass this array as the `tools[0].functionDeclarations` field when calling the Gemini API. See: https://ai.google.dev/gemini-api/docs/function-calling",
+  "_comment": "Gemini function declarations for buda-mcp v1.4.0. Pass this array as the `tools[0].functionDeclarations` field when calling the Gemini API. See: https://ai.google.dev/gemini-api/docs/function-calling",
   "functionDeclarations": [
     {
       "name": "get_markets",
@@ -164,6 +164,148 @@
         },
         "required": ["base_currency"]
       }
+    },
+    {
+      "name": "simulate_order",
+      "description": "Simulates a buy or sell order on Buda.com using live ticker data — no order is placed. Returns estimated fill price, fee, total cost, and slippage vs mid-price. Omit 'price' for a market order simulation; supply 'price' for a limit order simulation. All outputs are labelled simulation: true. Example: 'How much would it cost to buy 0.01 BTC on BTC-CLP right now?'",
+      "parameters": {
+        "type": "OBJECT",
+        "properties": {
+          "market_id": {
+            "type": "STRING",
+            "description": "Market identifier such as 'BTC-CLP' or 'ETH-BTC'. Case-insensitive."
+          },
+          "side": {
+            "type": "STRING",
+            "description": "'buy' or 'sell'."
+          },
+          "amount": {
+            "type": "NUMBER",
+            "description": "Order size in base currency (e.g. BTC for BTC-CLP)."
+          },
+          "price": {
+            "type": "NUMBER",
+            "description": "Limit price in quote currency. Omit for a market order simulation."
+          }
+        },
+        "required": ["market_id", "side", "amount"]
+      }
+    },
+    {
+      "name": "calculate_position_size",
+      "description": "Calculates position size based on capital, risk tolerance, entry price, and stop-loss. Determines units so that a stop-loss hit costs exactly risk_pct% of capital. Fully client-side — no API call. Example: 'How many BTC can I buy with 1M CLP at 2% risk, entry 80M, stop 78M?'",
+      "parameters": {
+        "type": "OBJECT",
+        "properties": {
+          "market_id": {
+            "type": "STRING",
+            "description": "Market identifier (e.g. 'BTC-CLP'). Used to derive the quote currency."
+          },
+          "capital": {
+            "type": "NUMBER",
+            "description": "Total available capital in the quote currency."
+          },
+          "risk_pct": {
+            "type": "NUMBER",
+            "description": "Percentage of capital to risk on this trade (0.1–10)."
+          },
+          "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 for sells."
+          }
+        },
+        "required": ["market_id", "capital", "risk_pct", "entry_price", "stop_loss_price"]
+      }
+    },
+    {
+      "name": "get_market_sentiment",
+      "description": "Computes a composite sentiment score (−100 to +100) for a Buda.com market based on 24h price variation (40%), volume vs 7-day average (35%), and bid/ask spread vs baseline (25%). Returns score, label (bearish/neutral/bullish), and full component breakdown. Example: 'Is the BTC-CLP market currently bullish or bearish?'",
+      "parameters": {
+        "type": "OBJECT",
+        "properties": {
+          "market_id": {
+            "type": "STRING",
+            "description": "Market identifier such as 'BTC-CLP', 'ETH-BTC', or 'BTC-USDT'. Case-insensitive."
+          }
+        },
+        "required": ["market_id"]
+      }
+    },
+    {
+      "name": "get_technical_indicators",
+      "description": "Computes RSI (14), MACD (12/26/9), Bollinger Bands (20, 2σ), SMA 20, and SMA 50 from Buda trade history. No external libraries. Returns latest indicator values and signal interpretations. Returns a structured warning if fewer than 50 candles are available. Example: 'Is BTC-CLP RSI overbought on the 4-hour chart?'",
+      "parameters": {
+        "type": "OBJECT",
+        "properties": {
+          "market_id": {
+            "type": "STRING",
+            "description": "Market identifier such as 'BTC-CLP' or 'ETH-BTC'. Case-insensitive."
+          },
+          "period": {
+            "type": "STRING",
+            "description": "Candle period: '1h', '4h', or '1d'. Default is '1h'."
+          },
+          "limit": {
+            "type": "INTEGER",
+            "description": "Number of raw trades to fetch (500–1000). Default is 500."
+          }
+        },
+        "required": ["market_id"]
+      }
+    },
+    {
+      "name": "schedule_cancel_all",
+      "description": "WARNING: timer state is lost on server restart. Use only on locally-run instances. 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'. Auth-gated.",
+      "parameters": {
+        "type": "OBJECT",
+        "properties": {
+          "market_id": {
+            "type": "STRING",
+            "description": "Market ID to protect (e.g. 'BTC-CLP')."
+          },
+          "ttl_seconds": {
+            "type": "INTEGER",
+            "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"]
+      }
+    },
+    {
+      "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. Auth-gated.",
+      "parameters": {
+        "type": "OBJECT",
+        "properties": {
+          "market_id": {
+            "type": "STRING",
+            "description": "Market ID whose timer should be renewed (e.g. 'BTC-CLP')."
+          }
+        },
+        "required": ["market_id"]
+      }
+    },
+    {
+      "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. Auth-gated.",
+      "parameters": {
+        "type": "OBJECT",
+        "properties": {
+          "market_id": {
+            "type": "STRING",
+            "description": "Market ID whose timer should be disarmed (e.g. 'BTC-CLP')."
+          }
+        },
+        "required": ["market_id"]
+      }
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guiie/buda-mcp",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "mcpName": "io.github.gtorreal/buda-mcp",
   "description": "MCP server for Buda.com's public cryptocurrency exchange API (Chile, Colombia, Peru)",
   "type": "module",

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/gtorreal/buda-mcp",
     "source": "github"
   },
-  "version": "1.3.0",
+  "version": "1.4.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@guiie/buda-mcp",
-      "version": "1.3.0",
+      "version": "1.4.0",
       "transport": {
         "type": "stdio"
       }

package/src/http.ts

@@ -19,6 +19,11 @@ 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";
+import * as simulateOrder from "./tools/simulate_order.js";
+import * as positionSize from "./tools/calculate_position_size.js";
+import * as marketSentiment from "./tools/market_sentiment.js";
+import * as technicalIndicators from "./tools/technical_indicators.js";
+import * as deadMansSwitch from "./tools/dead_mans_switch.js";
 import { handleMarketSummary } from "./tools/market_summary.js";
 
 const PORT = parseInt(process.env.PORT ?? "3000", 10);
@@ -44,6 +49,10 @@ const PUBLIC_TOOL_SCHEMAS = [
   priceHistory.toolSchema,
   arbitrage.toolSchema,
   marketSummary.toolSchema,
+  simulateOrder.toolSchema,
+  positionSize.toolSchema,
+  marketSentiment.toolSchema,
+  technicalIndicators.toolSchema,
 ];
 
 const AUTH_TOOL_SCHEMAS = [
@@ -51,6 +60,9 @@ const AUTH_TOOL_SCHEMAS = [
   orders.toolSchema,
   placeOrder.toolSchema,
   cancelOrder.toolSchema,
+  deadMansSwitch.toolSchema,
+  deadMansSwitch.renewToolSchema,
+  deadMansSwitch.disarmToolSchema,
 ];
 
 function createServer(): McpServer {
@@ -69,12 +81,17 @@ function createServer(): McpServer {
   priceHistory.register(server, client, reqCache);
   arbitrage.register(server, client, reqCache);
   marketSummary.register(server, client, reqCache);
+  simulateOrder.register(server, client, reqCache);
+  positionSize.register(server);
+  marketSentiment.register(server, client, reqCache);
+  technicalIndicators.register(server, client);
 
   if (authEnabled) {
     balances.register(server, client);
     orders.register(server, client);
     placeOrder.register(server, client);
     cancelOrder.register(server, client);
+    deadMansSwitch.register(server, client);
   }
 
   // MCP Resources

package/src/index.ts

@@ -20,6 +20,11 @@ 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";
+import * as simulateOrder from "./tools/simulate_order.js";
+import * as positionSize from "./tools/calculate_position_size.js";
+import * as marketSentiment from "./tools/market_sentiment.js";
+import * as technicalIndicators from "./tools/technical_indicators.js";
+import * as deadMansSwitch from "./tools/dead_mans_switch.js";
 import { handleMarketSummary } from "./tools/market_summary.js";
 
 const client = new BudaClient(
@@ -44,6 +49,10 @@ compareMarkets.register(server, client, cache);
 priceHistory.register(server, client, cache);
 arbitrage.register(server, client, cache);
 marketSummary.register(server, client, cache);
+simulateOrder.register(server, client, cache);
+positionSize.register(server);
+marketSentiment.register(server, client, cache);
+technicalIndicators.register(server, client);
 
 // Auth-gated tools — only registered when API credentials are present
 if (client.hasAuth()) {
@@ -51,6 +60,7 @@ if (client.hasAuth()) {
   orders.register(server, client);
   placeOrder.register(server, client);
   cancelOrder.register(server, client);
+  deadMansSwitch.register(server, client);
 }
 
 // MCP Resources