@guiie/buda-mcp 1.4.0 → 1.4.2

package/CHANGELOG.md

@@ -7,6 +7,26 @@ This project uses [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [1.4.2] – 2026-04-11
+
+### Added
+
+- **Shorter candle periods** (`5m`, `15m`, `30m`) now supported in both `get_price_history` and `get_technical_indicators`. Previously only `1h`, `4h`, `1d` were available.
+- **Lowered `MIN_CANDLES`** in `get_technical_indicators` from 50 to 20, matching the actual minimum required by the algorithms (RSI-14, MACD-26, BB-20). Individual indicators that still lack enough data return `null`.
+- **Integration tests** now cover the full `get_technical_indicators` indicators branch using `5m` period (42 live candles from BTC-CLP). Previously only the `insufficient_data` branch was tested live.
+
+---
+
+## [1.4.1] – 2026-04-11
+
+### Fixed
+
+- **`simulate_order`**: `taker_fee` returned by Buda API is already expressed as a percentage (`0.8` = 0.8%), not a decimal. Dividing by 100 before use gives correct fee calculations. Previously this caused fee_amount and total_cost to be ~100× too large.
+- Integration test (`test/run-all.ts`): added live checks for all 5 v1.4.0 tools; fixed field name `candles_available` (was `candles_used`).
+- Unit test mocks: updated `taker_fee` mock values from `"0.008"`/`"0.005"` to `"0.8"`/`"0.5"` to match the real Buda API format.
+
+---
+
 ## [1.4.0] – 2026-04-11
 
 ### Added

package/dist/tools/price_history.js

@@ -7,7 +7,7 @@ export const toolSchema = {
     description: "IMPORTANT: Candles are aggregated client-side from raw trades (Buda has no native candlestick " +
         "endpoint) — fetching more trades via the 'limit' parameter gives deeper history but slower " +
         "responses. Returns OHLCV candles (open/high/low/close as floats in quote currency; volume as float " +
-        "in base currency) for periods 1h, 4h, or 1d. Candle timestamps are UTC bucket boundaries. " +
+        "in base currency) for periods 5m, 15m, 30m, 1h, 4h, or 1d. Candle timestamps are UTC bucket boundaries. " +
         "Example: 'Show me the hourly BTC-CLP price chart for the past 24 hours.'",
     inputSchema: {
         type: "object",
@@ -18,7 +18,7 @@ export const toolSchema = {
             },
             period: {
                 type: "string",
-                description: "Candle period: '1h' (1 hour), '4h' (4 hours), or '1d' (1 day). Default: '1h'.",
+                description: "Candle period: '5m', '15m', '30m', '1h', '4h', or '1d'. Default: '1h'.",
             },
             limit: {
                 type: "number",
@@ -35,9 +35,9 @@ export function register(server, client, _cache) {
             .string()
             .describe("Market ID (e.g. 'BTC-CLP', 'ETH-BTC')."),
         period: z
-            .enum(["1h", "4h", "1d"])
+            .enum(["5m", "15m", "30m", "1h", "4h", "1d"])
             .default("1h")
-            .describe("Candle period: '1h' (1 hour), '4h' (4 hours), or '1d' (1 day). Default: '1h'."),
+            .describe("Candle period: '5m', '15m', '30m', '1h', '4h', or '1d'. Default: '1h'."),
         limit: z
             .number()
             .int()

package/dist/tools/simulate_order.js

@@ -67,7 +67,7 @@ export async function handleSimulateOrder(args, client, cache) {
             };
         }
         const mid = (minAsk + maxBid) / 2;
-        const takerFeeRate = parseFloat(market.taker_fee);
+        const takerFeeRate = parseFloat(market.taker_fee) / 100;
         const orderTypeAssumed = price !== undefined ? "limit" : "market";
         let estimatedFillPrice;
         if (orderTypeAssumed === "market") {

package/dist/tools/technical_indicators.d.ts

@@ -24,7 +24,7 @@ export declare const toolSchema: {
 };
 type TechnicalIndicatorsArgs = {
     market_id: string;
-    period: "1h" | "4h" | "1d";
+    period: "5m" | "15m" | "30m" | "1h" | "4h" | "1d";
     limit?: number;
 };
 export declare function handleTechnicalIndicators(args: TechnicalIndicatorsArgs, client: BudaClient): Promise<{

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

@@ -1 +1 @@
-{"version":3,"file":"technical_indicators.d.ts","sourceRoot":"","sources":["../../src/tools/technical_indicators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AAKxD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;CA6BtB,CAAC;AAsGF,KAAK,uBAAuB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,uBAAuB,EAC7B,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,CA2GhF;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAyBpE"}
+{"version":3,"file":"technical_indicators.d.ts","sourceRoot":"","sources":["../../src/tools/technical_indicators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AAKxD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;CA8BtB,CAAC;AAsGF,KAAK,uBAAuB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,uBAAuB,EAC7B,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,CA2GhF;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAyBpE"}

package/dist/tools/technical_indicators.js

@@ -6,9 +6,10 @@ 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. " +
+        "Supports periods: 5m, 15m, 30m, 1h, 4h, 1d. Use shorter periods (5m/15m) for intraday analysis. " +
         "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. " +
+        "If fewer than 20 candles are available after aggregation, returns a structured warning instead. " +
         "Example: 'Is BTC-CLP RSI overbought on the 4-hour chart?'",
     inputSchema: {
         type: "object",
@@ -19,7 +20,7 @@ export const toolSchema = {
             },
             period: {
                 type: "string",
-                description: "Candle period: '1h', '4h', or '1d'. Default: '1h'.",
+                description: "Candle period: '5m', '15m', '30m', '1h', '4h', or '1d'. Default: '1h'.",
             },
             limit: {
                 type: "number",
@@ -108,7 +109,7 @@ function bollingerBands(closes, period = 20, stdMult = 2) {
     };
 }
 // ---- Tool handler ----
-const MIN_CANDLES = 50;
+const MIN_CANDLES = 20;
 export async function handleTechnicalIndicators(args, client) {
     const { market_id, period, limit } = args;
     const validationError = validateMarketId(market_id);
@@ -207,9 +208,9 @@ export function register(server, client) {
             .string()
             .describe("Market ID (e.g. 'BTC-CLP', 'ETH-BTC')."),
         period: z
-            .enum(["1h", "4h", "1d"])
+            .enum(["5m", "15m", "30m", "1h", "4h", "1d"])
             .default("1h")
-            .describe("Candle period: '1h', '4h', or '1d'. Default: '1h'."),
+            .describe("Candle period: '5m', '15m', '30m', '1h', '4h', or '1d'. Default: '1h'."),
         limit: z
             .number()
             .int()

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,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"}
+{"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;AAWD;;;;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

@@ -19,6 +19,9 @@ export function getLiquidityRating(spreadPct) {
     return "low";
 }
 const PERIOD_MS = {
+    "5m": 5 * 60 * 1000,
+    "15m": 15 * 60 * 1000,
+    "30m": 30 * 60 * 1000,
     "1h": 60 * 60 * 1000,
     "4h": 4 * 60 * 60 * 1000,
     "1d": 24 * 60 * 60 * 1000,

package/marketplace/gemini-tools.json

@@ -306,6 +306,93 @@
         },
         "required": ["market_id"]
       }
+    },
+    {
+      "name": "get_balances",
+      "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. Auth-gated. Example: 'How much BTC do I have available to trade right now?'",
+      "parameters": {
+        "type": "OBJECT",
+        "properties": {},
+        "required": []
+      }
+    },
+    {
+      "name": "get_orders",
+      "description": "Returns orders for a given Buda.com market as flat typed objects. All monetary amounts are floats with separate _currency fields (e.g. amount + amount_currency). Filterable by state: pending, active, traded, canceled, canceled_and_traded. Supports pagination via per and page. Requires BUDA_API_KEY and BUDA_API_SECRET. Auth-gated. Example: 'Show my open limit orders on BTC-CLP.'",
+      "parameters": {
+        "type": "OBJECT",
+        "properties": {
+          "market_id": {
+            "type": "STRING",
+            "description": "Market identifier (e.g. 'BTC-CLP', 'ETH-BTC'). Case-insensitive."
+          },
+          "state": {
+            "type": "STRING",
+            "description": "Filter by order state: 'pending', 'active', 'traded', 'canceled', 'canceled_and_traded'. Omit to return all orders."
+          },
+          "per": {
+            "type": "INTEGER",
+            "description": "Results per page (default: 20, max: 300)."
+          },
+          "page": {
+            "type": "INTEGER",
+            "description": "Page number (default: 1)."
+          }
+        },
+        "required": ["market_id"]
+      }
+    },
+    {
+      "name": "place_order",
+      "description": "Places a limit or market order on Buda.com. IMPORTANT: Requires confirmation_token='CONFIRM' to execute — any other value rejects without placing an order, preventing accidental execution. Requires BUDA_API_KEY and BUDA_API_SECRET. Auth-gated. WARNING: Only use on locally-run instances — never on a publicly exposed server.",
+      "parameters": {
+        "type": "OBJECT",
+        "properties": {
+          "market_id": {
+            "type": "STRING",
+            "description": "Market identifier (e.g. 'BTC-CLP', 'ETH-BTC'). Case-insensitive."
+          },
+          "type": {
+            "type": "STRING",
+            "description": "Order side: 'Bid' to buy, 'Ask' to sell."
+          },
+          "price_type": {
+            "type": "STRING",
+            "description": "Order type: 'limit' places at a specific price, 'market' executes immediately at best available price."
+          },
+          "amount": {
+            "type": "NUMBER",
+            "description": "Order size in the market's base currency (e.g. BTC amount for BTC-CLP)."
+          },
+          "limit_price": {
+            "type": "NUMBER",
+            "description": "Limit price in quote currency. Required when price_type is 'limit'. For Bid orders: highest price you will pay. For Ask orders: lowest price you will accept."
+          },
+          "confirmation_token": {
+            "type": "STRING",
+            "description": "Safety confirmation. Must equal exactly 'CONFIRM' (case-sensitive) to place the order. Any other value rejects the request."
+          }
+        },
+        "required": ["market_id", "type", "price_type", "amount", "confirmation_token"]
+      }
+    },
+    {
+      "name": "cancel_order",
+      "description": "Cancels an open order by numeric ID on Buda.com. IMPORTANT: Requires confirmation_token='CONFIRM' to execute — any other value rejects without cancelling. Requires BUDA_API_KEY and BUDA_API_SECRET. Auth-gated.",
+      "parameters": {
+        "type": "OBJECT",
+        "properties": {
+          "order_id": {
+            "type": "INTEGER",
+            "description": "The numeric ID of the order to cancel."
+          },
+          "confirmation_token": {
+            "type": "STRING",
+            "description": "Safety confirmation. Must equal exactly 'CONFIRM' (case-sensitive) to cancel the order. Any other value rejects the request."
+          }
+        },
+        "required": ["order_id", "confirmation_token"]
+      }
     }
   ]
 }

package/marketplace/openapi.yaml

@@ -14,7 +14,7 @@ info:
     stdio server. Deploy locally with mcp-proxy:
       mcp-proxy --port 8000 -- npx -y @guiie/buda-mcp
     Or point `servers[0].url` at your hosted instance.
-  version: 1.3.0
+  version: 1.4.1
   contact:
     url: https://github.com/gtorreal/buda-mcp
 
@@ -350,6 +350,189 @@ paths:
         "404":
           $ref: "#/components/responses/NotFound"
 
+  /simulate_order:
+    get:
+      operationId: simulateOrder
+      summary: Simulate a buy or sell order without placing it
+      description: |
+        Simulates a buy or sell order using live ticker data — no order is ever placed.
+        Returns estimated fill price, fee amount, total cost, and slippage vs mid-price.
+        Omit 'price' for a market order simulation; supply 'price' for a limit order simulation.
+        All outputs include simulation: true.
+        Example: 'How much would it cost to buy 0.01 BTC on BTC-CLP right now?'
+      parameters:
+        - name: market_id
+          in: query
+          required: true
+          description: Market identifier (e.g. "BTC-CLP", "ETH-BTC"). Case-insensitive.
+          schema:
+            type: string
+            example: BTC-CLP
+        - name: side
+          in: query
+          required: true
+          description: Order side — "buy" or "sell".
+          schema:
+            type: string
+            enum: [buy, sell]
+        - name: amount
+          in: query
+          required: true
+          description: Order size in base currency (e.g. BTC for BTC-CLP).
+          schema:
+            type: number
+            minimum: 0
+            example: 0.01
+        - name: price
+          in: query
+          required: false
+          description: Limit price in quote currency. Omit for a market order simulation.
+          schema:
+            type: number
+            minimum: 0
+            example: 80000000
+      responses:
+        "200":
+          description: Order simulation result
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/SimulateOrderResponse"
+        "404":
+          $ref: "#/components/responses/NotFound"
+
+  /calculate_position_size:
+    get:
+      operationId: calculatePositionSize
+      summary: Calculate position size from capital and risk parameters
+      description: |
+        Calculates position size based on 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 with 1,000,000 CLP, risking 2%, entry 80,000,000 CLP, stop at 78,000,000 CLP?'
+      parameters:
+        - name: market_id
+          in: query
+          required: true
+          description: Market identifier (e.g. "BTC-CLP"). Used to derive base and quote currencies.
+          schema:
+            type: string
+            example: BTC-CLP
+        - name: capital
+          in: query
+          required: true
+          description: Total available capital in the quote currency (e.g. CLP for BTC-CLP).
+          schema:
+            type: number
+            minimum: 0
+            example: 1000000
+        - name: risk_pct
+          in: query
+          required: true
+          description: Percentage of capital to risk on this trade (0.1–10, e.g. 2 means 2%).
+          schema:
+            type: number
+            minimum: 0.1
+            maximum: 10
+            example: 2
+        - name: entry_price
+          in: query
+          required: true
+          description: Planned entry price in quote currency.
+          schema:
+            type: number
+            minimum: 0
+            example: 80000000
+        - name: stop_loss_price
+          in: query
+          required: true
+          description: Stop-loss price in quote currency. Must differ from entry_price.
+          schema:
+            type: number
+            minimum: 0
+            example: 78000000
+      responses:
+        "200":
+          description: Position sizing result
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/PositionSizeResponse"
+        "404":
+          $ref: "#/components/responses/NotFound"
+
+  /get_market_sentiment:
+    get:
+      operationId: getMarketSentiment
+      summary: Composite sentiment score for a market
+      description: |
+        Computes a composite sentiment score (−100 to +100) based on 24h price variation (40%),
+        volume vs 7-day average (35%), and bid/ask spread vs baseline (25%).
+        Returns a score, a label (bearish/neutral/bullish), and a full component breakdown.
+        Example: 'Is the BTC-CLP market currently bullish or bearish?'
+      parameters:
+        - name: market_id
+          in: query
+          required: true
+          description: Market identifier (e.g. "BTC-CLP", "ETH-BTC"). Case-insensitive.
+          schema:
+            type: string
+            example: BTC-CLP
+      responses:
+        "200":
+          description: Market sentiment result
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/MarketSentimentResponse"
+        "404":
+          $ref: "#/components/responses/NotFound"
+
+  /get_technical_indicators:
+    get:
+      operationId: getTechnicalIndicators
+      summary: RSI, MACD, Bollinger Bands, SMA20, SMA50 from trade history
+      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 required.
+        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?'
+      parameters:
+        - name: market_id
+          in: query
+          required: true
+          description: Market identifier (e.g. "BTC-CLP", "ETH-BTC"). Case-insensitive.
+          schema:
+            type: string
+            example: BTC-CLP
+        - name: period
+          in: query
+          required: false
+          description: Candle period. One of "1h", "4h", "1d". Default is "1h".
+          schema:
+            type: string
+            enum: ["1h", "4h", "1d"]
+            default: "1h"
+        - name: limit
+          in: query
+          required: false
+          description: Number of raw trades to fetch (default 500, max 1000). More trades = more candles = more reliable indicators.
+          schema:
+            type: integer
+            minimum: 500
+            maximum: 1000
+      responses:
+        "200":
+          description: Technical indicators result
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/TechnicalIndicatorsResponse"
+        "404":
+          $ref: "#/components/responses/NotFound"
+
 components:
   schemas:
     Market:
@@ -747,6 +930,197 @@ components:
           type: string
           example: "Buda taker fee is 0.8% per leg. A round-trip arbitrage costs approximately 1.6% in fees."
 
+    SimulateOrderResponse:
+      type: object
+      properties:
+        simulation:
+          type: boolean
+          example: true
+        market_id:
+          type: string
+          example: BTC-CLP
+        side:
+          type: string
+          enum: [buy, sell]
+        amount:
+          type: number
+          example: 0.01
+        order_type_assumed:
+          type: string
+          enum: [market, limit]
+        estimated_fill_price:
+          type: number
+          example: 80000000
+        price_currency:
+          type: string
+          example: CLP
+        fee_amount:
+          type: number
+          example: 6400
+        fee_currency:
+          type: string
+          example: CLP
+        fee_rate_pct:
+          type: number
+          example: 0.8
+        total_cost:
+          type: number
+          description: Total outlay for buys (gross + fee) or net proceeds for sells (gross − fee).
+          example: 806400
+        slippage_vs_mid_pct:
+          type: number
+          description: Percentage difference between estimated fill price and mid-price.
+          example: 0.0027
+        mid_price:
+          type: number
+          example: 79997840
+
+    PositionSizeResponse:
+      type: object
+      properties:
+        market_id:
+          type: string
+          example: BTC-CLP
+        side:
+          type: string
+          enum: [buy, sell]
+        units:
+          type: number
+          description: Number of base currency units to trade.
+          example: 0.01
+        base_currency:
+          type: string
+          example: BTC
+        capital_at_risk:
+          type: number
+          description: Amount of capital at risk (capital × risk_pct / 100) in quote currency.
+          example: 20000
+        position_value:
+          type: number
+          description: Total position value in quote currency (units × entry_price).
+          example: 800000
+        fee_impact:
+          type: number
+          description: Estimated entry fee at 0.8% taker rate in quote currency.
+          example: 6400
+        fee_currency:
+          type: string
+          example: CLP
+        risk_reward_note:
+          type: string
+          description: Human-readable summary of the trade setup.
+
+    MarketSentimentResponse:
+      type: object
+      properties:
+        market_id:
+          type: string
+          example: BTC-CLP
+        score:
+          type: number
+          description: Composite sentiment score from −100 (very bearish) to +100 (very bullish).
+          example: 23.5
+        label:
+          type: string
+          enum: [bearish, neutral, bullish]
+          example: bullish
+        component_breakdown:
+          type: object
+          properties:
+            price_variation_24h_pct:
+              type: number
+              example: 1.9
+            volume_ratio:
+              type: number
+              description: Today's volume vs 7-day daily average (1.0 = average).
+              example: 1.25
+            spread_pct:
+              type: number
+              example: 0.005
+            spread_baseline_pct:
+              type: number
+              example: 1.0
+            price_score:
+              type: number
+            volume_score:
+              type: number
+            spread_score:
+              type: number
+        data_timestamp:
+          type: string
+          format: date-time
+        disclaimer:
+          type: string
+
+    TechnicalIndicatorsResponse:
+      type: object
+      properties:
+        market_id:
+          type: string
+          example: BTC-CLP
+        period:
+          type: string
+          enum: ["1h", "4h", "1d"]
+        candles_used:
+          type: integer
+          example: 85
+        indicators:
+          type: object
+          nullable: true
+          properties:
+            rsi:
+              type: number
+              nullable: true
+              description: RSI(14). null if insufficient data.
+              example: 62.4
+            macd:
+              type: object
+              nullable: true
+              properties:
+                line:
+                  type: number
+                signal:
+                  type: number
+                histogram:
+                  type: number
+            bollinger_bands:
+              type: object
+              nullable: true
+              properties:
+                upper:
+                  type: number
+                mid:
+                  type: number
+                lower:
+                  type: number
+            sma_20:
+              type: number
+            sma_50:
+              type: number
+        signals:
+          type: object
+          properties:
+            rsi_signal:
+              type: string
+              enum: [overbought, oversold, neutral]
+            macd_signal:
+              type: string
+              enum: [bullish_crossover, bearish_crossover, neutral]
+            bb_signal:
+              type: string
+              enum: [above_upper, below_lower, within_bands]
+        warning:
+          type: string
+          description: Present only when candles_available < 50. Value is "insufficient_data".
+        candles_available:
+          type: integer
+          description: Present only when warning is set.
+        minimum_required:
+          type: integer
+          description: Present only when warning is set. Always 50.
+        disclaimer:
+          type: string
+
     Error:
       type: object
       properties:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guiie/buda-mcp",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "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.4.0",
+  "version": "1.4.2",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@guiie/buda-mcp",
-      "version": "1.4.0",
+      "version": "1.4.2",
       "transport": {
         "type": "stdio"
       }

package/src/tools/price_history.ts

@@ -12,7 +12,7 @@ export const toolSchema = {
     "IMPORTANT: Candles are aggregated client-side from raw trades (Buda has no native candlestick " +
     "endpoint) — fetching more trades via the 'limit' parameter gives deeper history but slower " +
     "responses. Returns OHLCV candles (open/high/low/close as floats in quote currency; volume as float " +
-    "in base currency) for periods 1h, 4h, or 1d. Candle timestamps are UTC bucket boundaries. " +
+    "in base currency) for periods 5m, 15m, 30m, 1h, 4h, or 1d. Candle timestamps are UTC bucket boundaries. " +
     "Example: 'Show me the hourly BTC-CLP price chart for the past 24 hours.'",
   inputSchema: {
     type: "object" as const,
@@ -23,7 +23,7 @@ export const toolSchema = {
       },
       period: {
         type: "string",
-        description: "Candle period: '1h' (1 hour), '4h' (4 hours), or '1d' (1 day). Default: '1h'.",
+        description: "Candle period: '5m', '15m', '30m', '1h', '4h', or '1d'. Default: '1h'.",
       },
       limit: {
         type: "number",
@@ -45,9 +45,9 @@ export function register(server: McpServer, client: BudaClient, _cache: MemoryCa
         .string()
         .describe("Market ID (e.g. 'BTC-CLP', 'ETH-BTC')."),
       period: z
-        .enum(["1h", "4h", "1d"])
+        .enum(["5m", "15m", "30m", "1h", "4h", "1d"])
         .default("1h")
-        .describe("Candle period: '1h' (1 hour), '4h' (4 hours), or '1d' (1 day). Default: '1h'."),
+        .describe("Candle period: '5m', '15m', '30m', '1h', '4h', or '1d'. Default: '1h'."),
       limit: z
         .number()
         .int()

package/src/tools/simulate_order.ts

@@ -99,7 +99,7 @@ export async function handleSimulateOrder(
     }
 
     const mid = (minAsk + maxBid) / 2;
-    const takerFeeRate = parseFloat(market.taker_fee);
+    const takerFeeRate = parseFloat(market.taker_fee) / 100;
     const orderTypeAssumed = price !== undefined ? "limit" : "market";
 
     let estimatedFillPrice: number;

package/src/tools/technical_indicators.ts

@@ -10,9 +10,10 @@ export const toolSchema = {
   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. " +
+    "Supports periods: 5m, 15m, 30m, 1h, 4h, 1d. Use shorter periods (5m/15m) for intraday analysis. " +
     "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. " +
+    "If fewer than 20 candles are available after aggregation, returns a structured warning instead. " +
     "Example: 'Is BTC-CLP RSI overbought on the 4-hour chart?'",
   inputSchema: {
     type: "object" as const,
@@ -23,7 +24,7 @@ export const toolSchema = {
       },
       period: {
         type: "string",
-        description: "Candle period: '1h', '4h', or '1d'. Default: '1h'.",
+        description: "Candle period: '5m', '15m', '30m', '1h', '4h', or '1d'. Default: '1h'.",
       },
       limit: {
         type: "number",
@@ -134,11 +135,11 @@ function bollingerBands(closes: number[], period: number = 20, stdMult: number =
 
 // ---- Tool handler ----
 
-const MIN_CANDLES = 50;
+const MIN_CANDLES = 20;
 
 type TechnicalIndicatorsArgs = {
   market_id: string;
-  period: "1h" | "4h" | "1d";
+  period: "5m" | "15m" | "30m" | "1h" | "4h" | "1d";
   limit?: number;
 };
 
@@ -263,9 +264,9 @@ export function register(server: McpServer, client: BudaClient): void {
         .string()
         .describe("Market ID (e.g. 'BTC-CLP', 'ETH-BTC')."),
       period: z
-        .enum(["1h", "4h", "1d"])
+        .enum(["5m", "15m", "30m", "1h", "4h", "1d"])
         .default("1h")
-        .describe("Candle period: '1h', '4h', or '1d'. Default: '1h'."),
+        .describe("Candle period: '5m', '15m', '30m', '1h', '4h', or '1d'. Default: '1h'."),
       limit: z
         .number()
         .int()

package/src/utils.ts

@@ -21,9 +21,12 @@ export function getLiquidityRating(spreadPct: number): "high" | "medium" | "low"
 }
 
 const PERIOD_MS: Record<string, number> = {
-  "1h": 60 * 60 * 1000,
-  "4h": 4 * 60 * 60 * 1000,
-  "1d": 24 * 60 * 60 * 1000,
+  "5m":  5 * 60 * 1000,
+  "15m": 15 * 60 * 1000,
+  "30m": 30 * 60 * 1000,
+  "1h":  60 * 60 * 1000,
+  "4h":  4 * 60 * 60 * 1000,
+  "1d":  24 * 60 * 60 * 1000,
 };
 
 /**

package/test/run-all.ts

@@ -18,6 +18,12 @@ try {
 }
 
 import { BudaClient } from "../src/client.js";
+import { MemoryCache } from "../src/cache.js";
+import { handleSimulateOrder } from "../src/tools/simulate_order.js";
+import { handleCalculatePositionSize } from "../src/tools/calculate_position_size.js";
+import { handleMarketSentiment } from "../src/tools/market_sentiment.js";
+import { handleTechnicalIndicators } from "../src/tools/technical_indicators.js";
+import { handleScheduleCancelAll, handleDisarmCancelTimer } from "../src/tools/dead_mans_switch.js";
 import type {
   MarketsResponse,
   TickerResponse,
@@ -225,6 +231,195 @@ try {
   failures++;
 }
 
+// ----------------------------------------------------------------
+// 9. simulate_order
+// ----------------------------------------------------------------
+section(`simulate_order — ${TEST_MARKET} market buy`);
+{
+  const cache = new MemoryCache();
+  try {
+    const result = await handleSimulateOrder(
+      { market_id: TEST_MARKET, side: "buy", amount: 0.001 },
+      client,
+      cache,
+    );
+    if (result.isError) throw new Error(result.content[0].text);
+    const parsed = JSON.parse(result.content[0].text) as {
+      simulation: boolean;
+      estimated_fill_price: number;
+      fee_amount: number;
+      fee_rate_pct: number;
+      total_cost: number;
+      slippage_vs_mid_pct: number;
+      order_type_assumed: string;
+    };
+    if (parsed.simulation !== true) throw new Error("simulation flag must be true");
+    pass("simulation: true", "✓");
+    pass("order_type_assumed", parsed.order_type_assumed);
+    pass("estimated_fill_price", `${parsed.estimated_fill_price.toLocaleString()} CLP`);
+    pass("fee_rate_pct", `${parsed.fee_rate_pct}%`);
+    pass("fee_amount", `${parsed.fee_amount.toFixed(2)} CLP`);
+    pass("total_cost", `${parsed.total_cost.toFixed(2)} CLP`);
+    pass("slippage_vs_mid_pct", `${parsed.slippage_vs_mid_pct}%`);
+  } catch (err) {
+    fail("simulate_order", err);
+    failures++;
+  }
+}
+
+// ----------------------------------------------------------------
+// 10. calculate_position_size
+// ----------------------------------------------------------------
+section(`calculate_position_size — ${TEST_MARKET}`);
+{
+  // Fetch live ticker to use real entry/stop prices
+  try {
+    const tickerData = await client.get<TickerResponse>(
+      `/markets/${TEST_MARKET.toLowerCase()}/ticker`,
+    );
+    const lastPrice = parseFloat(tickerData.ticker.last_price[0]);
+    const entryPrice = lastPrice;
+    const stopLossPrice = parseFloat((lastPrice * 0.97).toFixed(0)); // 3% below entry
+
+    const result = handleCalculatePositionSize({
+      market_id: TEST_MARKET,
+      capital: 1_000_000,
+      risk_pct: 2,
+      entry_price: entryPrice,
+      stop_loss_price: stopLossPrice,
+    });
+    if (result.isError) throw new Error(result.content[0].text);
+    const parsed = JSON.parse(result.content[0].text) as {
+      side: string;
+      units: number;
+      capital_at_risk: number;
+      position_value: number;
+      fee_impact: number;
+      fee_currency: string;
+    };
+    pass("side", parsed.side);
+    pass("units", `${parsed.units} BTC`);
+    pass("capital_at_risk", `${parsed.capital_at_risk.toLocaleString()} CLP`);
+    pass("position_value", `${parsed.position_value.toLocaleString()} CLP`);
+    pass("fee_impact", `${parsed.fee_impact.toFixed(2)} ${parsed.fee_currency}`);
+  } catch (err) {
+    fail("calculate_position_size", err);
+    failures++;
+  }
+}
+
+// ----------------------------------------------------------------
+// 11. get_market_sentiment
+// ----------------------------------------------------------------
+section(`get_market_sentiment — ${TEST_MARKET}`);
+{
+  const cache = new MemoryCache();
+  try {
+    const result = await handleMarketSentiment({ market_id: TEST_MARKET }, client, cache);
+    if (result.isError) throw new Error(result.content[0].text);
+    const parsed = JSON.parse(result.content[0].text) as {
+      score: number;
+      label: string;
+      component_breakdown: {
+        price_variation_24h_pct: number;
+        volume_ratio: number;
+        spread_pct: number;
+      };
+      disclaimer: string;
+    };
+    if (!["bearish", "neutral", "bullish"].includes(parsed.label)) {
+      throw new Error(`unexpected label: ${parsed.label}`);
+    }
+    if (typeof parsed.score !== "number" || parsed.score < -100 || parsed.score > 100) {
+      throw new Error(`score out of range: ${parsed.score}`);
+    }
+    pass("score", String(parsed.score));
+    pass("label", parsed.label);
+    pass("price_variation_24h_pct", `${parsed.component_breakdown.price_variation_24h_pct}%`);
+    pass("volume_ratio", String(parsed.component_breakdown.volume_ratio));
+    pass("spread_pct", `${parsed.component_breakdown.spread_pct}%`);
+    pass("disclaimer", parsed.disclaimer.length > 0 ? "present" : "MISSING");
+  } catch (err) {
+    fail("get_market_sentiment", err);
+    failures++;
+  }
+}
+
+// ----------------------------------------------------------------
+// 12. get_technical_indicators
+// ----------------------------------------------------------------
+
+type TechIndicatorsResponse = {
+  candles_used?: number;
+  candles_available?: number;
+  warning?: string;
+  indicators: {
+    rsi: number | null;
+    macd: { line: number; signal: number; histogram: number } | null;
+    bollinger_bands: { upper: number; mid: number; lower: number } | null;
+    sma_20: number;
+    sma_50: number;
+  } | null;
+  signals: { rsi_signal: string; macd_signal: string; bb_signal: string };
+  disclaimer: string;
+};
+
+// 12a. 1h period — expected to hit insufficient_data (BTC-CLP has ~8 candles/1h)
+section(`get_technical_indicators — ${TEST_MARKET} (1h, insufficient_data branch)`);
+{
+  try {
+    const result = await handleTechnicalIndicators(
+      { market_id: TEST_MARKET, period: "1h", limit: 1000 },
+      client,
+    );
+    if (result.isError) throw new Error(result.content[0].text);
+    const parsed = JSON.parse(result.content[0].text) as TechIndicatorsResponse;
+    if (parsed.warning !== "insufficient_data") {
+      pass("note", `got ${parsed.candles_used} candles — unexpectedly enough data, indicators returned`);
+    } else {
+      pass("warning", `insufficient_data — ${parsed.candles_available} candles available (need 50) ✓`);
+      pass("indicators", parsed.indicators === null ? "null ✓" : "SHOULD BE NULL");
+    }
+  } catch (err) {
+    fail("get_technical_indicators (1h)", err);
+    failures++;
+  }
+}
+
+// 12b. 5m period — enough candles to compute real indicators (~42 from last 100 trades)
+section(`get_technical_indicators — ${TEST_MARKET} (5m, indicators branch)`);
+{
+  try {
+    const result = await handleTechnicalIndicators(
+      { market_id: TEST_MARKET, period: "5m", limit: 1000 },
+      client,
+    );
+    if (result.isError) throw new Error(result.content[0].text);
+    const parsed = JSON.parse(result.content[0].text) as TechIndicatorsResponse;
+
+    if (parsed.warning === "insufficient_data") {
+      // Market too quiet right now — report but don't fail
+      pass("note", `insufficient_data with 1m period (${parsed.candles_available} candles) — market unusually quiet`);
+    } else {
+      if (!parsed.indicators) throw new Error("indicators is null without a warning");
+      pass("candles_used", String(parsed.candles_used));
+      pass("rsi", parsed.indicators.rsi !== null ? `${parsed.indicators.rsi} (${parsed.signals.rsi_signal})` : "null (insufficient RSI data)");
+      pass("macd_histogram", parsed.indicators.macd !== null
+        ? `${parsed.indicators.macd.histogram.toFixed(2)} (${parsed.signals.macd_signal})`
+        : "null (insufficient MACD data)");
+      pass("bb_upper", parsed.indicators.bollinger_bands !== null
+        ? `${parsed.indicators.bollinger_bands.upper.toLocaleString()} (${parsed.signals.bb_signal})`
+        : "null (insufficient BB data)");
+      pass("sma_20", String(parsed.indicators.sma_20?.toLocaleString()));
+      pass("sma_50", parsed.indicators.sma_50 !== null ? String(parsed.indicators.sma_50?.toLocaleString()) : "null (need 50 candles)");
+      pass("disclaimer", parsed.disclaimer?.length > 0 ? "present ✓" : "MISSING");
+    }
+  } catch (err) {
+    fail("get_technical_indicators (1m)", err);
+    failures++;
+  }
+}
+
 // ----------------------------------------------------------------
 // Auth tools: get_balances, get_orders, place_order, cancel_order
 // ----------------------------------------------------------------
@@ -263,6 +458,34 @@ if (!client.hasAuth()) {
   // cancel_order — confirmation guard test (must reject without CONFIRM)
   console.log("  Skipping: cancel_order live execution (destructive — requires confirmation_token=CONFIRM)");
   pass("cancel_order guard", "confirmation_token check enforced at tool layer (code-audited)");
+
+  // schedule_cancel_all — arm then immediately disarm (non-destructive)
+  try {
+    const armResult = await handleScheduleCancelAll(
+      { market_id: TEST_MARKET, ttl_seconds: 300, confirmation_token: "CONFIRM" },
+      client,
+    );
+    if (armResult.isError) throw new Error(armResult.content[0].text);
+    const armed = JSON.parse(armResult.content[0].text) as {
+      active: boolean;
+      expires_at: string;
+      ttl_seconds: number;
+      warning: string;
+    };
+    if (!armed.active) throw new Error("active should be true after CONFIRM");
+    pass("schedule_cancel_all active", armed.active ? "true" : "false");
+    pass("schedule_cancel_all expires_at", armed.expires_at);
+    pass("schedule_cancel_all warning", armed.warning.length > 0 ? "present" : "MISSING");
+
+    // Immediately disarm so no orders are cancelled
+    const disarmResult = handleDisarmCancelTimer({ market_id: TEST_MARKET });
+    if (disarmResult.isError) throw new Error(disarmResult.content[0].text);
+    const disarmed = JSON.parse(disarmResult.content[0].text) as { disarmed: boolean };
+    pass("disarm_cancel_timer", disarmed.disarmed ? "timer cleared ✓" : "FAILED to disarm");
+  } catch (err) {
+    fail("schedule_cancel_all / disarm_cancel_timer", err);
+    failures++;
+  }
 }
 
 // ----------------------------------------------------------------
@@ -271,6 +494,8 @@ if (!client.hasAuth()) {
 section("Summary");
 if (failures === 0) {
   console.log("  All tools returned valid data from the live Buda API.");
+  console.log("  Coverage: simulate_order, calculate_position_size, get_market_sentiment,");
+  console.log("            get_technical_indicators, schedule_cancel_all/disarm (auth-gated if credentials set).");
 } else {
   console.error(`  ${failures} tool(s) failed. See errors above.`);
   process.exit(1);

package/test/unit.ts

@@ -666,7 +666,7 @@ await test("handleMarketSummary returns correct liquidity_rating from mocked API
 
 section("i. simulate_order");
 
-function makeMockFetchForSimulate(takerFee = "0.008"): typeof fetch {
+function makeMockFetchForSimulate(takerFee = "0.8"): typeof fetch {
   const mockTicker = {
     ticker: {
       market_id: "BTC-CLP",
@@ -720,7 +720,7 @@ await test("market buy: estimated_fill_price = min_ask, simulation: true", async
     assertEqual(parsed.simulation, true, "simulation flag must be true");
     assertEqual(parsed.estimated_fill_price, 65100000, "market buy fills at min_ask");
     assertEqual(parsed.order_type_assumed, "market", "order_type_assumed should be market");
-    assertEqual(parsed.fee_rate_pct, 0.8, "fee rate should be 0.8% for crypto");
+    assertEqual(parsed.fee_rate_pct, 0.8, "fee_rate_pct should be 0.8 for crypto (0.8% taker fee)");
   } finally {
     globalThis.fetch = savedFetch;
   }
@@ -758,14 +758,14 @@ await test("limit order: order_type_assumed = 'limit'", async () => {
 
 await test("stablecoin market uses 0.5% fee", async () => {
   const savedFetch = globalThis.fetch;
-  globalThis.fetch = makeMockFetchForSimulate("0.005");
+  globalThis.fetch = makeMockFetchForSimulate("0.5");
   try {
     const client = new BudaClient("https://www.buda.com/api/v2");
     const cache = new MemoryCache();
     const result = await handleSimulateOrder({ market_id: "BTC-CLP", side: "buy", amount: 1 }, client, cache);
     assert(!result.isError, "should not be an error");
     const parsed = JSON.parse(result.content[0].text) as { fee_rate_pct: number };
-    assertEqual(parsed.fee_rate_pct, 0.5, "fee_rate_pct should be 0.5 for stablecoin");
+    assertEqual(parsed.fee_rate_pct, 0.5, "fee_rate_pct should be 0.5 for stablecoin (0.5% taker fee)");
   } finally {
     globalThis.fetch = savedFetch;
   }
@@ -1024,7 +1024,7 @@ await test("technical indicators: insufficient candles returns warning", async (
     };
     assertEqual(parsed.warning, "insufficient_data", "should return insufficient_data warning");
     assertEqual(parsed.indicators, null, "indicators should be null");
-    assertEqual(parsed.minimum_required, 50, "minimum_required should be 50");
+    assertEqual(parsed.minimum_required, 20, "minimum_required should be 20");
   } finally {
     globalThis.fetch = savedFetch;
   }