@missionsquad/mcp-defillama 1.0.0 → 1.2.0

package/dist/handlers/defillama.types.d.ts

@@ -1,20 +1,127 @@
-export interface GetProtocolsInput {
+/** A 12-hour datetime string ("06/15/2024 03:30 PM", UTC assumed) or UNIX seconds. */
+export type DateTimeInput = string | number;
+/** Options that control response compaction (all optional). */
+export interface CompactInput {
+    /** Return the complete, untrimmed response instead of the compact default. */
+    full?: boolean;
 }
-export interface GetProtocolTvlInput {
+/** Adds a downsampling control for time-series responses. */
+export interface SeriesCompactInput extends CompactInput {
+    /** Max number of data points to keep (default 30). */
+    points?: number;
+}
+/** Adds an item cap for list responses. */
+export interface ListCompactInput extends CompactInput {
+    /** Max number of items to keep. */
+    limit?: number;
+}
+/** Query options shared by the DEX/options/fees overview & summary endpoints. */
+export interface OverviewOptionsInput extends CompactInput {
+    excludeTotalDataChart?: boolean;
+    excludeTotalDataChartBreakdown?: boolean;
+    dataType?: string;
+    /** Max number of chart points to keep (default 30). */
+    points?: number;
+    /** Max number of protocols to keep in the breakdown. */
+    limit?: number;
+}
+export interface GetProtocolsInput extends ListCompactInput {
+}
+export interface GetProtocolTvlInput extends SeriesCompactInput {
     protocol: string;
+    /** Include token-level balances/breakdowns in the response. */
+    includeTokens?: boolean;
+}
+export interface GetHistoricalChainTvlInput extends SeriesCompactInput {
 }
-export interface GetChainTvlInput {
+export interface GetChainTvlInput extends SeriesCompactInput {
     chain: string;
 }
+export interface GetCurrentProtocolTvlInput {
+    protocol: string;
+}
+export interface GetChainsInput extends ListCompactInput {
+}
 export interface GetTokenPricesInput {
     coins: string[];
 }
 export interface GetHistoricalPricesInput {
     coins: string[];
-    timestamp: number;
+    timestamp: DateTimeInput;
+}
+export interface GetBatchHistoricalPricesInput {
+    /** Map of coin identifier to an array of datetime strings or UNIX seconds. */
+    coins: Record<string, DateTimeInput[]>;
+    searchWidth?: string;
+}
+export interface GetPriceChartInput extends SeriesCompactInput {
+    coins: string[];
+    start?: DateTimeInput;
+    end?: DateTimeInput;
+    span?: number;
+    period?: string;
+    searchWidth?: string;
+}
+export interface GetPricePercentageChangeInput {
+    coins: string[];
+    timestamp?: DateTimeInput;
+    lookForward?: boolean;
+    period?: string;
+}
+export interface GetFirstPricesInput {
+    coins: string[];
 }
-export interface GetStablecoinsInput {
+export interface GetBlockInput {
+    chain: string;
+    timestamp: DateTimeInput;
+}
+export interface GetStablecoinsInput extends ListCompactInput {
+    includePrices?: boolean;
+}
+export interface GetStablecoinChartsAllInput extends SeriesCompactInput {
+    stablecoin?: number | string;
+}
+export interface GetStablecoinChartsChainInput extends SeriesCompactInput {
+    chain: string;
+    stablecoin?: number | string;
 }
-export interface GetStablecoinDataInput {
+export interface GetStablecoinDataInput extends SeriesCompactInput {
     asset: string;
+    /** Include token-level breakdowns in the response. */
+    includeTokens?: boolean;
+}
+export interface GetStablecoinChainsInput extends ListCompactInput {
+}
+export interface GetStablecoinPricesInput extends SeriesCompactInput {
+}
+export interface GetPoolsInput extends ListCompactInput {
+}
+export interface GetPoolChartInput extends SeriesCompactInput {
+    pool: string;
+}
+export interface GetDexsOverviewInput extends OverviewOptionsInput {
+}
+export interface GetDexsOverviewByChainInput extends OverviewOptionsInput {
+    chain: string;
+}
+export interface GetDexSummaryInput extends OverviewOptionsInput {
+    protocol: string;
+}
+export interface GetOptionsOverviewInput extends OverviewOptionsInput {
+}
+export interface GetOptionsOverviewByChainInput extends OverviewOptionsInput {
+    chain: string;
+}
+export interface GetOptionSummaryInput extends OverviewOptionsInput {
+    protocol: string;
+}
+export interface GetOpenInterestOverviewInput extends OverviewOptionsInput {
+}
+export interface GetFeesOverviewInput extends OverviewOptionsInput {
+}
+export interface GetFeesOverviewByChainInput extends OverviewOptionsInput {
+    chain: string;
+}
+export interface GetFeeSummaryInput extends OverviewOptionsInput {
+    protocol: string;
 }

package/dist/handlers/defillama.types.js

@@ -1,2 +1,5 @@
+// ---------------------------------------------------------------------------
+// Shared
+// ---------------------------------------------------------------------------
 export {};
 //# sourceMappingURL=defillama.types.js.map

package/dist/handlers/defillama.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"defillama.types.js","sourceRoot":"","sources":["../../src/handlers/defillama.types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"defillama.types.js","sourceRoot":"","sources":["../../src/handlers/defillama.types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,SAAS;AACT,8EAA8E"}

package/dist/handlers/transform.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Response transforms that make DefiLlama payloads small and model-friendly.
+ *
+ * Two passes run on every response:
+ *   1. compaction  — trim noisy fields, cap list lengths, downsample series.
+ *   2. humanizeDates — render UNIX date/timestamp fields as UTC datetime strings.
+ *
+ * Compaction is opt-out: pass `full: true` to get the untouched response.
+ */
+export interface CompactOptions {
+    /** Return the complete, untrimmed response. */
+    full?: boolean;
+    /** Max number of points to keep when downsampling a time series. */
+    points?: number;
+    /** Max number of items to keep for list endpoints. */
+    limit?: number;
+    /** Include token-level breakdowns (protocol/stablecoin detail endpoints). */
+    includeTokens?: boolean;
+}
+/** Evenly downsample an array to at most `max` items, always keeping the ends. */
+export declare function downsample<T>(arr: T[], max: number): T[];
+/** Recursively render date/timestamp fields as UTC datetime strings. */
+export declare function humanizeDates(value: any): any;
+export declare function compactProtocols(data: any, opts?: CompactOptions): any;
+export declare function compactProtocolTvl(data: any, opts?: CompactOptions): any;
+/** A plain time series (array of dated points), e.g. historical chain TVL. */
+export declare function compactSeries(data: any, opts?: CompactOptions): any;
+export declare function compactChains(data: any, opts?: CompactOptions): any;
+export declare function compactPools(data: any, opts?: CompactOptions): any;
+export declare function compactStablecoins(data: any, opts?: CompactOptions): any;
+/** /stablecoinchains is a per-chain entity list (not a time series). */
+export declare function compactStablecoinChains(data: any, opts?: CompactOptions): any;
+export declare function compactStablecoinData(data: any, opts?: CompactOptions): any;
+export declare function compactOverview(data: any, opts?: CompactOptions): any;

package/dist/handlers/transform.js

@@ -0,0 +1,241 @@
+/**
+ * Response transforms that make DefiLlama payloads small and model-friendly.
+ *
+ * Two passes run on every response:
+ *   1. compaction  — trim noisy fields, cap list lengths, downsample series.
+ *   2. humanizeDates — render UNIX date/timestamp fields as UTC datetime strings.
+ *
+ * Compaction is opt-out: pass `full: true` to get the untouched response.
+ */
+import { formatUnixToDateTime } from "./datetime.js";
+const DEFAULT_POINTS = 30;
+// ---------------------------------------------------------------------------
+// Generic helpers
+// ---------------------------------------------------------------------------
+const isObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+/** Evenly downsample an array to at most `max` items, always keeping the ends. */
+export function downsample(arr, max) {
+    if (!Array.isArray(arr) || max <= 0 || arr.length <= max)
+        return arr;
+    if (max === 1)
+        return [arr[arr.length - 1]];
+    const result = [];
+    const step = (arr.length - 1) / (max - 1);
+    for (let i = 0; i < max; i++) {
+        result.push(arr[Math.round(i * step)]);
+    }
+    return result;
+}
+/** Keep only the listed keys that are actually present on an object. */
+function pickFields(obj, fields) {
+    const out = {};
+    for (const key of fields) {
+        if (obj[key] !== undefined) {
+            out[key] = obj[key];
+        }
+    }
+    return out;
+}
+/** Downsample every array found anywhere in the structure (for chart payloads). */
+function deepDownsample(value, max) {
+    if (Array.isArray(value)) {
+        return downsample(value, max).map(item => deepDownsample(item, max));
+    }
+    if (isObject(value)) {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            out[k] = deepDownsample(v, max);
+        }
+        return out;
+    }
+    return value;
+}
+function trimList(arr, fields, limit, sortValue) {
+    let items = arr;
+    if (sortValue) {
+        items = [...arr].sort((a, b) => (sortValue(b) || 0) - (sortValue(a) || 0));
+    }
+    const sliced = items.slice(0, limit).map(item => (isObject(item) ? pickFields(item, fields) : item));
+    return { total: arr.length, returned: sliced.length, items: sliced };
+}
+/** Numeric magnitude of a stablecoin circulating object ({peggedUSD|peggedEUR|peggedVAR}). */
+function circulatingValue(c) {
+    if (typeof c === "number")
+        return c;
+    if (isObject(c))
+        return Number(c.peggedUSD ?? c.peggedEUR ?? c.peggedVAR ?? 0) || 0;
+    return 0;
+}
+/** Reduce a chainTvls map (flat numbers OR historical {tvl:[...]}) to current per-chain numbers. */
+function currentChainTvlMap(chainTvls) {
+    const out = {};
+    for (const [chain, v] of Object.entries(chainTvls)) {
+        if (typeof v === "number") {
+            out[chain] = v;
+        }
+        else if (isObject(v) && Array.isArray(v.tvl) && v.tvl.length) {
+            const last = v.tvl[v.tvl.length - 1];
+            const value = last?.totalLiquidityUSD ?? last?.tvl;
+            if (typeof value === "number")
+                out[chain] = value;
+        }
+    }
+    return out;
+}
+// ---------------------------------------------------------------------------
+// Date humanizing
+// ---------------------------------------------------------------------------
+const DATE_KEYS = new Set(["date", "timestamp", "t", "startTime", "endTime"]);
+// Plausible UNIX range (~2001 in seconds up to year ~5138 in seconds / ms).
+const looksLikeUnix = (n) => Number.isFinite(n) && Math.abs(n) >= 1e9;
+/** Recursively render date/timestamp fields as UTC datetime strings. */
+export function humanizeDates(value) {
+    if (Array.isArray(value)) {
+        return value.map(humanizeDates);
+    }
+    if (isObject(value)) {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            if (DATE_KEYS.has(k) && typeof v === "number" && looksLikeUnix(v)) {
+                out[k] = formatUnixToDateTime(v);
+            }
+            else {
+                out[k] = humanizeDates(v);
+            }
+        }
+        return out;
+    }
+    return value;
+}
+// ---------------------------------------------------------------------------
+// Endpoint-specific compactors
+// ---------------------------------------------------------------------------
+const PROTOCOL_FIELDS = [
+    "name", "symbol", "category", "chain", "chains", "tvl",
+    "change_1h", "change_1d", "change_7d", "mcap",
+];
+export function compactProtocols(data, opts = {}) {
+    if (opts.full || !Array.isArray(data))
+        return data;
+    const { total, returned, items } = trimList(data, PROTOCOL_FIELDS, opts.limit ?? 100, p => Number(p?.tvl) || 0);
+    return { total, returned, protocols: items };
+}
+export function compactProtocolTvl(data, opts = {}) {
+    if (opts.full || !isObject(data))
+        return data;
+    const points = opts.points ?? DEFAULT_POINTS;
+    const out = pickFields(data, [
+        "name", "symbol", "url", "category", "chains", "tvlPriceChange",
+    ]);
+    // Current per-chain TVL: prefer the API's `currentChainTvls`, otherwise derive
+    // it from `chainTvls` (which may be flat numbers or historical {tvl:[...]}).
+    if (isObject(data.currentChainTvls)) {
+        out.currentChainTvls = data.currentChainTvls;
+    }
+    else if (isObject(data.chainTvls)) {
+        const current = currentChainTvlMap(data.chainTvls);
+        if (Object.keys(current).length)
+            out.currentChainTvls = current;
+    }
+    // Aggregate TVL: the API may return `tvl` as a number or a historical series.
+    const series = Array.isArray(data.tvl) ? data.tvl
+        : Array.isArray(data.tvlList) ? data.tvlList
+            : undefined;
+    if (series) {
+        out.tvl = downsample(series, points);
+    }
+    else if (typeof data.tvl === "number") {
+        out.tvl = data.tvl;
+    }
+    if (opts.includeTokens) {
+        if (data.tokens !== undefined)
+            out.tokens = data.tokens;
+        if (Array.isArray(data.tokensInUsd))
+            out.tokensInUsd = downsample(data.tokensInUsd, points);
+    }
+    return out;
+}
+/** A plain time series (array of dated points), e.g. historical chain TVL. */
+export function compactSeries(data, opts = {}) {
+    if (opts.full)
+        return data;
+    return deepDownsample(data, opts.points ?? DEFAULT_POINTS);
+}
+const CHAIN_FIELDS = ["name", "tvl", "tokenSymbol", "chainId", "gecko_id"];
+export function compactChains(data, opts = {}) {
+    if (opts.full || !Array.isArray(data))
+        return data;
+    const { total, returned, items } = trimList(data, CHAIN_FIELDS, opts.limit ?? 200, c => Number(c?.tvl) || 0);
+    return { total, returned, chains: items };
+}
+const POOL_FIELDS = [
+    "pool", "chain", "project", "symbol", "tvlUsd",
+    "apy", "apyBase", "apyReward", "stablecoin", "ilRisk", "exposure",
+];
+export function compactPools(data, opts = {}) {
+    if (opts.full)
+        return data;
+    // /pools returns { status, data: [...] }.
+    const pools = isObject(data) && Array.isArray(data.data) ? data.data : data;
+    if (!Array.isArray(pools))
+        return data;
+    const { total, returned, items } = trimList(pools, POOL_FIELDS, opts.limit ?? 50, p => Number(p?.tvlUsd) || 0);
+    return { total, returned, pools: items };
+}
+const STABLECOIN_FIELDS = ["id", "name", "symbol", "pegType", "pegMechanism", "price", "circulating"];
+export function compactStablecoins(data, opts = {}) {
+    if (opts.full || !isObject(data) || !Array.isArray(data.peggedAssets))
+        return data;
+    const { total, returned, items } = trimList(data.peggedAssets, STABLECOIN_FIELDS, opts.limit ?? 100, s => circulatingValue(s?.circulating));
+    return { total, returned, peggedAssets: items };
+}
+const STABLECOIN_CHAIN_FIELDS = ["name", "gecko_id", "tokenSymbol", "totalCirculatingUSD"];
+/** /stablecoinchains is a per-chain entity list (not a time series). */
+export function compactStablecoinChains(data, opts = {}) {
+    if (opts.full || !Array.isArray(data))
+        return data;
+    const { total, returned, items } = trimList(data, STABLECOIN_CHAIN_FIELDS, opts.limit ?? 200, c => circulatingValue(c?.totalCirculatingUSD));
+    return { total, returned, chains: items };
+}
+export function compactStablecoinData(data, opts = {}) {
+    if (opts.full || !isObject(data))
+        return data;
+    const out = pickFields(data, [
+        "id", "name", "symbol", "pegType", "pegMechanism", "priceSource", "price",
+        "circulating", "circulatingPrevDay", "circulatingPrevWeek", "circulating7dAgo",
+        "chainCirculating", "delisted",
+    ]);
+    if (opts.includeTokens && Array.isArray(data.tokens)) {
+        out.tokens = downsample(data.tokens, opts.points ?? DEFAULT_POINTS);
+    }
+    return out;
+}
+const OVERVIEW_PROTOCOL_FIELDS = [
+    "name", "displayName", "category", "chains",
+    "total24h", "total7d", "total30d", "totalAllTime",
+    "change_1d", "change_7d", "change_1m",
+];
+const OVERVIEW_TOP_FIELDS = [
+    "total24h", "total7d", "total30d", "totalAllTime",
+    "change_1d", "change_7d", "change_1m",
+    "totalDataChart", "totalDataChartBreakdown",
+    "allChains", "chain", "protocols",
+];
+export function compactOverview(data, opts = {}) {
+    if (opts.full || !isObject(data))
+        return data;
+    const points = opts.points ?? DEFAULT_POINTS;
+    const out = pickFields(data, OVERVIEW_TOP_FIELDS);
+    if (Array.isArray(out.totalDataChart))
+        out.totalDataChart = downsample(out.totalDataChart, points);
+    if (Array.isArray(out.totalDataChartBreakdown))
+        out.totalDataChartBreakdown = downsample(out.totalDataChartBreakdown, points);
+    if (Array.isArray(out.protocols)) {
+        const { total, returned, items } = trimList(out.protocols, OVERVIEW_PROTOCOL_FIELDS, opts.limit ?? 50, p => Number(p?.total24h) || 0);
+        out.protocols = items;
+        out.totalProtocols = total;
+        out.returnedProtocols = returned;
+    }
+    return out;
+}
+//# sourceMappingURL=transform.js.map

package/dist/handlers/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../src/handlers/transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAarD,MAAM,cAAc,GAAG,EAAE,CAAC;AAE1B,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,MAAM,QAAQ,GAAG,CAAC,CAAU,EAA4B,EAAE,CACxD,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAE3D,kFAAkF;AAClF,MAAM,UAAU,UAAU,CAAI,GAAQ,EAAE,GAAW;IACjD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IACrE,IAAI,GAAG,KAAK,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAQ,EAAE,CAAC;IACvB,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,wEAAwE;AACxE,SAAS,UAAU,CAAgC,GAAM,EAAE,MAAgB;IACzE,MAAM,GAAG,GAAe,EAAE,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YAC1B,GAA2B,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,mFAAmF;AACnF,SAAS,cAAc,CAAC,KAAU,EAAE,GAAW;IAC7C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,GAAG,GAAwB,EAAE,CAAC;QACpC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3C,GAAG,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAKD,SAAS,QAAQ,CACf,GAAU,EACV,MAAgB,EAChB,KAAa,EACb,SAAqB;IAErB,IAAI,KAAK,GAAG,GAAG,CAAC;IAChB,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACrG,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AACvE,CAAC;AAED,8FAA8F;AAC9F,SAAS,gBAAgB,CAAC,CAAM;IAC9B,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC;IACpC,IAAI,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;IACpF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,oGAAoG;AACpG,SAAS,kBAAkB,CAAC,SAAc;IACxC,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACnD,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC1B,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC;aAAM,IAAI,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAE,CAAS,CAAC,GAAG,CAAC,IAAK,CAAS,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;YACjF,MAAM,IAAI,GAAI,CAAS,CAAC,GAAG,CAAE,CAAS,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACvD,MAAM,KAAK,GAAG,IAAI,EAAE,iBAAiB,IAAI,IAAI,EAAE,GAAG,CAAC;YACnD,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;QACpD,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;AAC9E,4EAA4E;AAC5E,MAAM,aAAa,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;AAE9E,wEAAwE;AACxE,MAAM,UAAU,aAAa,CAAC,KAAU;IACtC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,GAAG,GAAwB,EAAE,CAAC;QACpC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3C,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClE,GAAG,CAAC,CAAC,CAAC,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC;YACnC,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AAE9E,MAAM,eAAe,GAAG;IACtB,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK;IACtD,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM;CAC9C,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,IAAS,EAAE,OAAuB,EAAE;IACnE,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnD,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAChH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAS,EAAE,OAAuB,EAAE;IACrE,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,cAAc,CAAC;IAE7C,MAAM,GAAG,GAAwB,UAAU,CAAC,IAAI,EAAE;QAChD,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,gBAAgB;KAChE,CAAC,CAAC;IAEH,+EAA+E;IAC/E,6EAA6E;IAC7E,IAAI,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACpC,GAAG,CAAC,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC;IAC/C,CAAC;SAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM;YAAE,GAAG,CAAC,gBAAgB,GAAG,OAAO,CAAC;IAClE,CAAC;IAED,8EAA8E;IAC9E,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG;QAC/C,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO;YAC5C,CAAC,CAAC,SAAS,CAAC;IACd,IAAI,MAAM,EAAE,CAAC;QACX,GAAG,CAAC,GAAG,GAAG,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;SAAM,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;QACxC,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IACrB,CAAC;IAED,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACxD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC;YAAE,GAAG,CAAC,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC9F,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,aAAa,CAAC,IAAS,EAAE,OAAuB,EAAE;IAChE,IAAI,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAC3B,OAAO,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,IAAI,cAAc,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAE3E,MAAM,UAAU,aAAa,CAAC,IAAS,EAAE,OAAuB,EAAE;IAChE,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnD,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7G,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,WAAW,GAAG;IAClB,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ;IAC9C,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU;CAClE,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,IAAS,EAAE,OAAuB,EAAE;IAC/D,IAAI,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAC3B,0CAA0C;IAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/G,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC3C,CAAC;AAED,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;AAEtG,MAAM,UAAU,kBAAkB,CAAC,IAAS,EAAE,OAAuB,EAAE;IACrE,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IACnF,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,QAAQ,CACzC,IAAI,CAAC,YAAY,EAAE,iBAAiB,EAAE,IAAI,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC,EAAE,WAAW,CAAC,CAC/F,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,uBAAuB,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,qBAAqB,CAAC,CAAC;AAE3F,wEAAwE;AACxE,MAAM,UAAU,uBAAuB,CAAC,IAAS,EAAE,OAAuB,EAAE;IAC1E,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnD,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,QAAQ,CACzC,IAAI,EAAE,uBAAuB,EAAE,IAAI,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAChG,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAS,EAAE,OAAuB,EAAE;IACxE,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,MAAM,GAAG,GAAwB,UAAU,CAAC,IAAI,EAAE;QAChD,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,OAAO;QACzE,aAAa,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,kBAAkB;QAC9E,kBAAkB,EAAE,UAAU;KAC/B,CAAC,CAAC;IACH,IAAI,IAAI,CAAC,aAAa,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACrD,GAAG,CAAC,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,cAAc,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,wBAAwB,GAAG;IAC/B,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ;IAC3C,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc;IACjD,WAAW,EAAE,WAAW,EAAE,WAAW;CACtC,CAAC;AAEF,MAAM,mBAAmB,GAAG;IAC1B,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc;IACjD,WAAW,EAAE,WAAW,EAAE,WAAW;IACrC,gBAAgB,EAAE,yBAAyB;IAC3C,WAAW,EAAE,OAAO,EAAE,WAAW;CAClC,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,IAAS,EAAE,OAAuB,EAAE;IAClE,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,cAAc,CAAC;IAC7C,MAAM,GAAG,GAAwB,UAAU,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;IAEvE,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QAAE,GAAG,CAAC,cAAc,GAAG,UAAU,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IACnG,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;QAAE,GAAG,CAAC,uBAAuB,GAAG,UAAU,CAAC,GAAG,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;IAE9H,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QACjC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,wBAAwB,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QACtI,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC;QACtB,GAAG,CAAC,cAAc,GAAG,KAAK,CAAC;QAC3B,GAAG,CAAC,iBAAiB,GAAG,QAAQ,CAAC;IACnC,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/handlers/utils.d.ts

@@ -11,3 +11,11 @@ export declare const createErrorResponse: (message: string) => ToolResultSchema;
  * @returns A ToolResultSchema with the success message
  */
 export declare const createSuccessResponse: (message: string) => ToolResultSchema;
+/**
+ * Utility function to return structured data as a compact (minified) JSON
+ * response. Compact JSON keeps the payload small and directly parseable by
+ * model clients, unlike a prose-prefixed, pretty-printed blob.
+ * @param data Any JSON-serializable value
+ * @returns A ToolResultSchema wrapping the serialized data
+ */
+export declare const jsonResponse: (data: unknown) => ToolResultSchema;

package/dist/handlers/utils.js

@@ -26,4 +26,20 @@ export const createSuccessResponse = (message) => {
         isError: false
     };
 };
+/**
+ * Utility function to return structured data as a compact (minified) JSON
+ * response. Compact JSON keeps the payload small and directly parseable by
+ * model clients, unlike a prose-prefixed, pretty-printed blob.
+ * @param data Any JSON-serializable value
+ * @returns A ToolResultSchema wrapping the serialized data
+ */
+export const jsonResponse = (data) => {
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify(data)
+            }],
+        isError: false
+    };
+};
 //# sourceMappingURL=utils.js.map

package/dist/handlers/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/handlers/utils.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAAe,EAAoB,EAAE;IACvE,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,OAAO;aACd,CAAC;QACF,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,OAAe,EAAoB,EAAE;IACzE,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,OAAO;aACd,CAAC;QACF,OAAO,EAAE,KAAK;KACf,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/handlers/utils.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAAe,EAAoB,EAAE;IACvE,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,OAAO;aACd,CAAC;QACF,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,OAAe,EAAoB,EAAE;IACzE,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,OAAO;aACd,CAAC;QACF,OAAO,EAAE,KAAK;KACf,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAa,EAAoB,EAAE;IAC9D,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;aAC3B,CAAC;QACF,OAAO,EAAE,KAAK;KACf,CAAC;AACJ,CAAC,CAAC"}

package/dist/index.js

@@ -5,7 +5,7 @@ import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprot
 import { handlers, tools } from "./tools.js";
 const server = new Server({
     name: "mcp-defillama",
-    version: "1.0.0",
+    version: "1.2.0",
 }, {
     capabilities: {
         tools: {}