@guiie/buda-mcp 1.2.1 → 1.3.0

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/market_summary.d.ts

@@ -0,0 +1,43 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { BudaClient } from "../client.js";
+import { MemoryCache } from "../cache.js";
+export declare const toolSchema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            market_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export interface MarketSummaryResult {
+    market_id: string;
+    last_price: number;
+    last_price_currency: string;
+    bid: number;
+    ask: number;
+    spread_pct: number;
+    volume_24h: number;
+    volume_24h_currency: string;
+    price_change_24h: number;
+    price_change_7d: number;
+    liquidity_rating: "high" | "medium" | "low";
+}
+interface MarketSummaryInput {
+    market_id: string;
+}
+export declare function handleMarketSummary({ market_id }: MarketSummaryInput, 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_summary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"market_summary.d.ts","sourceRoot":"","sources":["../../src/tools/market_summary.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;AAKrD,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAkBtB,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CAC7C;AAED,UAAU,kBAAkB;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,mBAAmB,CACvC,EAAE,SAAS,EAAE,EAAE,kBAAkB,EACjC,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,CA4DhF;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAWxF"}

package/dist/tools/market_summary.js

@@ -0,0 +1,81 @@
+import { z } from "zod";
+import { BudaApiError } from "../client.js";
+import { CACHE_TTL } from "../cache.js";
+import { validateMarketId } from "../validation.js";
+import { flattenAmount, getLiquidityRating } from "../utils.js";
+export const toolSchema = {
+    name: "get_market_summary",
+    description: "One-call summary of everything relevant about a market: last price, best bid/ask, spread %, " +
+        "24h volume, 24h and 7d price change, and a liquidity_rating ('high' / 'medium' / 'low' based on " +
+        "spread thresholds: < 0.3% = high, 0.3–1% = medium, > 1% = low). All prices and volumes are floats. " +
+        "Best first tool to call when a user asks about any specific market. " +
+        "Example: 'Give me a complete overview of the BTC-CLP market right now.'",
+    inputSchema: {
+        type: "object",
+        properties: {
+            market_id: {
+                type: "string",
+                description: "Market ID (e.g. 'BTC-CLP', 'ETH-COP', 'BTC-PEN').",
+            },
+        },
+        required: ["market_id"],
+    },
+};
+export async function handleMarketSummary({ market_id }, client, cache) {
+    try {
+        const validationError = validateMarketId(market_id);
+        if (validationError) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error: validationError, code: "INVALID_MARKET_ID" }) }],
+                isError: true,
+            };
+        }
+        const id = market_id.toLowerCase();
+        // Fetch ticker and volume in parallel
+        const [tickerData, volumeData] = await Promise.all([
+            cache.getOrFetch(`ticker:${id}`, CACHE_TTL.TICKER, () => client.get(`/markets/${id}/ticker`)),
+            client.get(`/markets/${id}/volume`),
+        ]);
+        const t = tickerData.ticker;
+        const v = volumeData.volume;
+        const lastPrice = flattenAmount(t.last_price);
+        const bid = parseFloat(t.max_bid[0]);
+        const ask = parseFloat(t.min_ask[0]);
+        const volume24h = flattenAmount(v.ask_volume_24h);
+        const spreadAbs = ask - bid;
+        const spreadPct = ask > 0 ? parseFloat(((spreadAbs / ask) * 100).toFixed(4)) : 0;
+        const result = {
+            market_id: t.market_id,
+            last_price: lastPrice.value,
+            last_price_currency: lastPrice.currency,
+            bid,
+            ask,
+            spread_pct: spreadPct,
+            volume_24h: volume24h.value,
+            volume_24h_currency: volume24h.currency,
+            price_change_24h: parseFloat((parseFloat(t.price_variation_24h) * 100).toFixed(4)),
+            price_change_7d: parseFloat((parseFloat(t.price_variation_7d) * 100).toFixed(4)),
+            liquidity_rating: getLiquidityRating(spreadPct),
+        };
+        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, cache) {
+    server.tool(toolSchema.name, toolSchema.description, {
+        market_id: z
+            .string()
+            .describe("Market ID (e.g. 'BTC-CLP', 'ETH-COP', 'BTC-PEN')."),
+    }, (args) => handleMarketSummary(args, client, cache));
+}
+//# sourceMappingURL=market_summary.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"markets.d.ts","sourceRoot":"","sources":["../../src/tools/markets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAa,MAAM,aAAa,CAAC;AAIrD,eAAO,MAAM,UAAU;;;;;;;;;;;;CActB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAsDxF"}
+{"version":3,"file":"markets.d.ts","sourceRoot":"","sources":["../../src/tools/markets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAa,MAAM,aAAa,CAAC;AAIrD,eAAO,MAAM,UAAU;;;;;;;;;;;;CAgBtB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAsDxF"}

package/dist/tools/markets.js

@@ -4,8 +4,10 @@ import { CACHE_TTL } from "../cache.js";
 import { validateMarketId } from "../validation.js";
 export const toolSchema = {
     name: "get_markets",
-    description: "List all available trading pairs on Buda.com, or get details for a specific market. " +
-        "Returns base/quote currencies, fees, and minimum order sizes.",
+    description: "Lists all available trading pairs on Buda.com, or returns details for a specific market " +
+        "(base/quote currencies, taker/maker fees as decimals, minimum order size in base currency, " +
+        "and fee discount tiers). Omit market_id to get all ~26 markets at once. " +
+        "Example: 'What is the taker fee and minimum order size for BTC-CLP?'",
     inputSchema: {
         type: "object",
         properties: {

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

@@ -1 +1 @@
-{"version":3,"file":"orderbook.d.ts","sourceRoot":"","sources":["../../src/tools/orderbook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAa,MAAM,aAAa,CAAC;AAIrD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;CAmBtB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAuDxF"}
+{"version":3,"file":"orderbook.d.ts","sourceRoot":"","sources":["../../src/tools/orderbook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAa,MAAM,aAAa,CAAC;AAIrD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;CAqBtB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAgExF"}

package/dist/tools/orderbook.js

@@ -4,8 +4,10 @@ import { CACHE_TTL } from "../cache.js";
 import { validateMarketId } from "../validation.js";
 export const toolSchema = {
     name: "get_orderbook",
-    description: "Get the current order book (bids and asks) for a Buda.com market. Returns sorted arrays of " +
-        "bids (buy orders) and asks (sell orders), each as [price, amount] pairs.",
+    description: "Returns the current order book for a Buda.com market as typed objects with float price and amount fields. " +
+        "Bids are sorted highest-price first; asks lowest-price first. " +
+        "Prices are in the quote currency; amounts are in the base currency. " +
+        "Example: 'What are the top 5 buy and sell orders for BTC-CLP right now?'",
     inputSchema: {
         type: "object",
         properties: {
@@ -44,9 +46,17 @@ export function register(server, client, cache) {
             const id = market_id.toLowerCase();
             const data = await cache.getOrFetch(`orderbook:${id}`, CACHE_TTL.ORDERBOOK, () => client.get(`/markets/${id}/order_book`));
             const book = data.order_book;
+            const bids = limit ? book.bids.slice(0, limit) : book.bids;
+            const asks = limit ? book.asks.slice(0, limit) : book.asks;
             const result = {
-                bids: limit ? book.bids.slice(0, limit) : book.bids,
-                asks: limit ? book.asks.slice(0, limit) : book.asks,
+                bids: bids.map(([price, amount]) => ({
+                    price: parseFloat(price),
+                    amount: parseFloat(amount),
+                })),
+                asks: asks.map(([price, amount]) => ({
+                    price: parseFloat(price),
+                    amount: parseFloat(amount),
+                })),
                 bid_count: book.bids.length,
                 ask_count: book.asks.length,
             };

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

@@ -1 +1 @@
-{"version":3,"file":"orders.d.ts","sourceRoot":"","sources":["../../src/tools/orders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AAIxD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;CA4BtB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAqEpE"}
+{"version":3,"file":"orders.d.ts","sourceRoot":"","sources":["../../src/tools/orders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AAKxD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;CA+BtB,CAAC;AAMF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAsGpE"}

package/dist/tools/orders.js

@@ -1,10 +1,14 @@
 import { z } from "zod";
 import { BudaApiError } from "../client.js";
 import { validateMarketId } from "../validation.js";
+import { flattenAmount } from "../utils.js";
 export const toolSchema = {
     name: "get_orders",
-    description: "Get orders for a given Buda.com market. Filter by state (pending, active, traded, canceled). " +
-        "Requires BUDA_API_KEY and BUDA_API_SECRET environment variables.",
+    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. Supports pagination via per and page. " +
+        "Requires BUDA_API_KEY and BUDA_API_SECRET. " +
+        "Example: 'Show my open limit orders on BTC-CLP.'",
     inputSchema: {
         type: "object",
         properties: {
@@ -28,6 +32,9 @@ export const toolSchema = {
         required: ["market_id"],
     },
 };
+function flattenAmountField(amount) {
+    return flattenAmount(amount);
+}
 export function register(server, client) {
     server.tool(toolSchema.name, toolSchema.description, {
         market_id: z
@@ -68,11 +75,42 @@ export function register(server, client) {
             if (page !== undefined)
                 params.page = page;
             const data = await client.get(`/markets/${market_id.toLowerCase()}/orders`, Object.keys(params).length > 0 ? params : undefined);
+            const orders = data.orders.map((o) => {
+                const amount = flattenAmountField(o.amount);
+                const originalAmount = flattenAmountField(o.original_amount);
+                const tradedAmount = flattenAmountField(o.traded_amount);
+                const totalExchanged = flattenAmountField(o.total_exchanged);
+                const paidFee = flattenAmountField(o.paid_fee);
+                const limitPrice = o.limit ? flattenAmountField(o.limit) : null;
+                return {
+                    id: o.id,
+                    type: o.type,
+                    state: o.state,
+                    created_at: o.created_at,
+                    market_id: o.market_id,
+                    fee_currency: o.fee_currency,
+                    price_type: o.price_type,
+                    order_type: o.order_type,
+                    client_id: o.client_id,
+                    limit_price: limitPrice ? limitPrice.value : null,
+                    limit_price_currency: limitPrice ? limitPrice.currency : null,
+                    amount: amount.value,
+                    amount_currency: amount.currency,
+                    original_amount: originalAmount.value,
+                    original_amount_currency: originalAmount.currency,
+                    traded_amount: tradedAmount.value,
+                    traded_amount_currency: tradedAmount.currency,
+                    total_exchanged: totalExchanged.value,
+                    total_exchanged_currency: totalExchanged.currency,
+                    paid_fee: paidFee.value,
+                    paid_fee_currency: paidFee.currency,
+                };
+            });
             return {
                 content: [
                     {
                         type: "text",
-                        text: JSON.stringify({ orders: data.orders, meta: data.meta }, null, 2),
+                        text: JSON.stringify({ orders, meta: data.meta }, null, 2),
                     },
                 ],
             };

package/dist/tools/price_history.js

@@ -10,9 +10,9 @@ export const toolSchema = {
     name: "get_price_history",
     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 (open/high/low/close/volume) price history for a Buda.com market. " +
-        "Candle timestamps are UTC bucket boundaries (e.g. '2026-04-10T12:00:00.000Z' for 1h). " +
-        "Supports 1h, 4h, and 1d candle periods.",
+        "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. " +
+        "Example: 'Show me the hourly BTC-CLP price chart for the past 24 hours.'",
     inputSchema: {
         type: "object",
         properties: {
@@ -86,22 +86,22 @@ export function register(server, client, _cache) {
                 if (!buckets.has(bucketStart)) {
                     buckets.set(bucketStart, {
                         time: new Date(bucketStart).toISOString(),
-                        open: price,
-                        high: price,
-                        low: price,
-                        close: price,
-                        volume: amount,
+                        open: p,
+                        high: p,
+                        low: p,
+                        close: p,
+                        volume: v,
                         trade_count: 1,
                     });
                 }
                 else {
                     const candle = buckets.get(bucketStart);
-                    if (p > parseFloat(candle.high))
-                        candle.high = price;
-                    if (p < parseFloat(candle.low))
-                        candle.low = price;
-                    candle.close = price;
-                    candle.volume = (parseFloat(candle.volume) + v).toFixed(8);
+                    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++;
                 }
             }

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

@@ -1 +1 @@
-{"version":3,"file":"spread.d.ts","sourceRoot":"","sources":["../../src/tools/spread.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAa,MAAM,aAAa,CAAC;AAIrD,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAetB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAuExF"}
+{"version":3,"file":"spread.d.ts","sourceRoot":"","sources":["../../src/tools/spread.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;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAuExF"}

package/dist/tools/spread.js

@@ -4,8 +4,10 @@ import { CACHE_TTL } from "../cache.js";
 import { validateMarketId } from "../validation.js";
 export const toolSchema = {
     name: "get_spread",
-    description: "Calculate the bid/ask spread for a Buda.com market. " +
-        "Returns the best bid, best ask, absolute spread, and spread as a percentage of the ask price.",
+    description: "Returns the best bid, best ask, absolute spread, and spread percentage for a Buda.com market. " +
+        "All prices are floats in the quote currency (e.g. CLP). spread_percentage is a float in percent " +
+        "(e.g. 0.15 means 0.15%). Use this to evaluate liquidity before placing a large order. " +
+        "Example: 'Is BTC-CLP liquid enough to buy 10M CLP without significant slippage?'",
     inputSchema: {
         type: "object",
         properties: {
@@ -52,12 +54,12 @@ export function register(server, client, cache) {
             const spreadPct = (spreadAbs / ask) * 100;
             const result = {
                 market_id: ticker.market_id,
-                currency,
-                best_bid: bid.toString(),
-                best_ask: ask.toString(),
-                spread_absolute: spreadAbs.toFixed(2),
-                spread_percentage: spreadPct.toFixed(4) + "%",
-                last_price: ticker.last_price[0],
+                price_currency: currency,
+                best_bid: bid,
+                best_ask: ask,
+                spread_absolute: parseFloat(spreadAbs.toFixed(2)),
+                spread_percentage: parseFloat(spreadPct.toFixed(4)),
+                last_price: parseFloat(ticker.last_price[0]),
             };
             return {
                 content: [{ type: "text", text: JSON.stringify(result, null, 2) }],

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

@@ -1 +1 @@
-{"version":3,"file":"ticker.d.ts","sourceRoot":"","sources":["../../src/tools/ticker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAa,MAAM,aAAa,CAAC;AAIrD,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAetB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAwCxF"}
+{"version":3,"file":"ticker.d.ts","sourceRoot":"","sources":["../../src/tools/ticker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAa,MAAM,aAAa,CAAC;AAKrD,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAiBtB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CA6DxF"}

package/dist/tools/ticker.js

@@ -2,10 +2,13 @@ import { z } from "zod";
 import { BudaApiError } from "../client.js";
 import { CACHE_TTL } from "../cache.js";
 import { validateMarketId } from "../validation.js";
+import { flattenAmount } from "../utils.js";
 export const toolSchema = {
     name: "get_ticker",
-    description: "Get the current ticker for a Buda.com market: last traded price, best bid/ask, " +
-        "24h volume, and price change over 24h and 7d.",
+    description: "Returns the current market snapshot for a Buda.com market: last traded price, best bid, " +
+        "best ask, 24h volume, and price change over 24h and 7d. All prices are floats in the quote " +
+        "currency (e.g. CLP for BTC-CLP). price_variation_24h is a decimal fraction (0.012 = +1.2%). " +
+        "Example: 'What is the current Bitcoin price in Chilean pesos?'",
     inputSchema: {
         type: "object",
         properties: {
@@ -33,8 +36,26 @@ export function register(server, client, cache) {
             }
             const id = market_id.toLowerCase();
             const data = await cache.getOrFetch(`ticker:${id}`, CACHE_TTL.TICKER, () => client.get(`/markets/${id}/ticker`));
+            const t = data.ticker;
+            const lastPrice = flattenAmount(t.last_price);
+            const minAsk = flattenAmount(t.min_ask);
+            const maxBid = flattenAmount(t.max_bid);
+            const volume = flattenAmount(t.volume);
+            const result = {
+                market_id: t.market_id,
+                last_price: lastPrice.value,
+                last_price_currency: lastPrice.currency,
+                min_ask: minAsk.value,
+                min_ask_currency: minAsk.currency,
+                max_bid: maxBid.value,
+                max_bid_currency: maxBid.currency,
+                volume: volume.value,
+                volume_currency: volume.currency,
+                price_variation_24h: parseFloat(t.price_variation_24h),
+                price_variation_7d: parseFloat(t.price_variation_7d),
+            };
             return {
-                content: [{ type: "text", text: JSON.stringify(data.ticker, null, 2) }],
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
             };
         }
         catch (err) {

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

@@ -1 +1 @@
-{"version":3,"file":"trades.d.ts","sourceRoot":"","sources":["../../src/tools/trades.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;CAwBtB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAyDzF"}
+{"version":3,"file":"trades.d.ts","sourceRoot":"","sources":["../../src/tools/trades.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;CA0BtB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAsEzF"}

package/dist/tools/trades.js

@@ -3,8 +3,10 @@ import { BudaApiError } from "../client.js";
 import { validateMarketId } from "../validation.js";
 export const toolSchema = {
     name: "get_trades",
-    description: "Get recent trade history for a Buda.com market. Each entry contains " +
-        "[timestamp_ms, amount, price, direction]. Direction is 'buy' or 'sell'.",
+    description: "Returns recent trade history for a Buda.com market as typed objects. Each entry has " +
+        "timestamp_ms (integer), amount (float, base currency), price (float, quote currency), " +
+        "and direction ('buy' or 'sell'). " +
+        "Example: 'What was the last executed price for BTC-CLP and was it a buy or sell?'",
     inputSchema: {
         type: "object",
         properties: {
@@ -56,8 +58,20 @@ export function register(server, client, _cache) {
             if (timestamp !== undefined)
                 params.timestamp = timestamp;
             const data = await client.get(`/markets/${market_id.toLowerCase()}/trades`, Object.keys(params).length > 0 ? params : undefined);
+            const t = data.trades;
+            const result = {
+                timestamp: t.timestamp,
+                last_timestamp: t.last_timestamp,
+                market_id: t.market_id,
+                entries: t.entries.map(([tsMs, amount, price, direction]) => ({
+                    timestamp_ms: parseInt(tsMs, 10),
+                    amount: parseFloat(amount),
+                    price: parseFloat(price),
+                    direction,
+                })),
+            };
             return {
-                content: [{ type: "text", text: JSON.stringify(data.trades, null, 2) }],
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
             };
         }
         catch (err) {

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

@@ -1 +1 @@
-{"version":3,"file":"volume.d.ts","sourceRoot":"","sources":["../../src/tools/volume.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAetB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAqCzF"}
+{"version":3,"file":"volume.d.ts","sourceRoot":"","sources":["../../src/tools/volume.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAgB,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK1C,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAgBtB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAwDzF"}

package/dist/tools/volume.js

@@ -1,10 +1,12 @@
 import { z } from "zod";
 import { BudaApiError } from "../client.js";
 import { validateMarketId } from "../validation.js";
+import { flattenAmount } from "../utils.js";
 export const toolSchema = {
     name: "get_market_volume",
-    description: "Get 24h and 7-day transacted volume for a Buda.com market. " +
-        "Returns ask (sell) and bid (buy) volumes in the market's base currency.",
+    description: "Returns 24h and 7-day transacted volume for a Buda.com market, split by buy (bid) and sell (ask) side. " +
+        "All volume values are floats in the base currency (e.g. BTC for BTC-CLP). " +
+        "Example: 'How much Bitcoin was sold on BTC-CLP in the last 24 hours?'",
     inputSchema: {
         type: "object",
         properties: {
@@ -31,8 +33,24 @@ export function register(server, client, _cache) {
                 };
             }
             const data = await client.get(`/markets/${market_id.toLowerCase()}/volume`);
+            const v = data.volume;
+            const ask24 = flattenAmount(v.ask_volume_24h);
+            const ask7d = flattenAmount(v.ask_volume_7d);
+            const bid24 = flattenAmount(v.bid_volume_24h);
+            const bid7d = flattenAmount(v.bid_volume_7d);
+            const result = {
+                market_id: v.market_id,
+                ask_volume_24h: ask24.value,
+                ask_volume_24h_currency: ask24.currency,
+                ask_volume_7d: ask7d.value,
+                ask_volume_7d_currency: ask7d.currency,
+                bid_volume_24h: bid24.value,
+                bid_volume_24h_currency: bid24.currency,
+                bid_volume_7d: bid7d.value,
+                bid_volume_7d_currency: bid7d.currency,
+            };
             return {
-                content: [{ type: "text", text: JSON.stringify(data.volume, null, 2) }],
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
             };
         }
         catch (err) {

package/dist/utils.d.ts

@@ -0,0 +1,17 @@
+import type { Amount } 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.
+ */
+export declare function flattenAmount(amount: Amount): {
+    value: number;
+    currency: string;
+};
+/**
+ * Returns a liquidity rating based on the bid/ask spread percentage.
+ * < 0.3%  → "high"
+ * 0.3–1%  → "medium"
+ * > 1%    → "low"
+ */
+export declare function getLiquidityRating(spreadPct: number): "high" | "medium" | "low";
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

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

package/dist/utils.js

@@ -0,0 +1,21 @@
+/**
+ * Flattens a Buda API Amount tuple [value_string, currency] into a typed object.
+ * All numeric strings are cast to float via parseFloat.
+ */
+export function flattenAmount(amount) {
+    return { value: parseFloat(amount[0]), currency: amount[1] };
+}
+/**
+ * Returns a liquidity rating based on the bid/ask spread percentage.
+ * < 0.3%  → "high"
+ * 0.3–1%  → "medium"
+ * > 1%    → "low"
+ */
+export function getLiquidityRating(spreadPct) {
+    if (spreadPct < 0.3)
+        return "high";
+    if (spreadPct <= 1.0)
+        return "medium";
+    return "low";
+}
+//# sourceMappingURL=utils.js.map

package/marketplace/README.md

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