@lendwise/mcp 0.1.2 → 0.1.3

package/dist/core/graphql/queries.d.ts

@@ -28,6 +28,8 @@ export interface RewardItem {
 export interface MarketState {
     supplyAssetsUsd: number | null;
     utilizationRate: number | null;
+    /** Borrow snapshots only — supply documents don't select it, so it's absent there. */
+    borrowAssetsUsd?: number | null;
 }
 export interface Quality {
     status: string;
@@ -42,6 +44,10 @@ export interface SnapshotRow {
     apy: ApyBreakdown;
     market: MarketState;
     quality: Quality;
+    /** Accepted collateral assets — borrow snapshots only, absent on supply rows. */
+    collaterals?: {
+        symbol: string;
+    }[];
     product: {
         protocol: {
             provider: string;
@@ -116,6 +122,17 @@ export interface ProductRow {
 }
 export declare const PRODUCT_FACETS = "\n  query ProductFacets($filters: ProductFilters) {\n    productFacets(filters: $filters) {\n      assets {\n        symbol\n        count\n      }\n      chains {\n        id\n        name\n        count\n      }\n      protocols {\n        name\n        count\n      }\n    }\n  }\n";
 export declare const LATEST_SUPPLY_APY = "\n  query LatestSupplyApy($filters: LatestFilters, $first: Int) {\n    latestSupplyApy(\n      filters: $filters\n      first: $first\n      orderBy: apyNet\n      orderDirection: desc\n    ) {\n      \n  items {\n    hour\n    productId\n    asset\n    chainId\n    apy {\n      base\n      rewards\n      fees\n      net\n    }\n    market {\n      supplyAssetsUsd\n      utilizationRate\n    }\n    quality {\n      status\n      count\n      expectedCount\n    }\n    product {\n      protocol {\n        provider\n        name\n        chain {\n          id\n          name\n        }\n      }\n    }\n  }\n  pagination {\n    count\n    countTotal\n    limit\n    skip\n  }\n\n    }\n  }\n";
+/**
+ * Current best borrow markets. Borrow net APY is a COST (base + fees − rewards),
+ * so the cheapest market has the LOWEST net — the opposite of supply.
+ *
+ * `orderDirection: asc` is set explicitly as defense in depth. Upstream now
+ * defaults `latestBorrowApy` to asc too (best-first, kind-aware), so this only
+ * restates that default — but pinning it here keeps the ranking correct even if
+ * that default is ever changed back, and makes the intent legible at the call
+ * site rather than depending on a server-side convention.
+ */
+export declare const LATEST_BORROW_APY = "\n  query LatestBorrowApy($filters: LatestBorrowFilters, $first: Int) {\n    latestBorrowApy(\n      filters: $filters\n      first: $first\n      orderBy: apyNet\n      orderDirection: asc\n    ) {\n      \n  items {\n    hour\n    productId\n    asset\n    chainId\n    apy {\n      base\n      rewards\n      fees\n      net\n    }\n    market {\n      supplyAssetsUsd\n      borrowAssetsUsd\n      utilizationRate\n    }\n    quality {\n      status\n      count\n      expectedCount\n    }\n    collaterals {\n      symbol\n    }\n    product {\n      protocol {\n        provider\n        name\n        chain {\n          id\n          name\n        }\n      }\n    }\n  }\n  pagination {\n    count\n    countTotal\n    limit\n    skip\n  }\n\n    }\n  }\n";
 /**
  * Latest snapshot for an explicit set of products — the optimizer's APY source.
  *
@@ -131,3 +148,10 @@ export declare const LATEST_SUPPLY_BY_PRODUCTS = "\n  query LatestSupplyByProduc
  */
 export declare const MARKET_DETAILS = "\n  query MarketDetails($productId: String!) {\n    products(filters: { productId: $productId }, first: 1) {\n      items {\n        id\n        kind\n        asset {\n          symbol\n          name\n          address\n          decimals\n        }\n        protocol {\n          provider\n          type\n          version\n          name\n          chain {\n            id\n            name\n          }\n          address\n          meta\n        }\n        collaterals {\n          symbol\n          name\n          ltv\n          lltv\n          canBeCollateral\n        }\n      }\n    }\n    latestSupplyApy(filters: { productId: $productId }, first: 1) {\n      \n  items {\n    hour\n    productId\n    asset\n    chainId\n    apy {\n      base\n      rewards\n      fees\n      net\n      rewardItems {\n        token {\n          symbol\n        }\n        apy\n        source\n        program\n      }\n    }\n    market {\n      supplyAssetsUsd\n      utilizationRate\n    }\n    quality {\n      status\n      count\n      expectedCount\n    }\n    product {\n      protocol {\n        provider\n        name\n        chain {\n          id\n          name\n        }\n      }\n    }\n  }\n\n    }\n    latestBorrowApy(filters: { productId: $productId }, first: 1) {\n      \n  items {\n    hour\n    productId\n    asset\n    chainId\n    apy {\n      base\n      rewards\n      fees\n      net\n      rewardItems {\n        token {\n          symbol\n        }\n        apy\n        source\n        program\n      }\n    }\n    market {\n      supplyAssetsUsd\n      utilizationRate\n    }\n    quality {\n      status\n      count\n      expectedCount\n    }\n    product {\n      protocol {\n        provider\n        name\n        chain {\n          id\n          name\n        }\n      }\n    }\n  }\n\n    }\n  }\n";
 export declare const MARKET_HISTORY = "\n  query MarketHistory($productId: String!, $range: String!) {\n    supplyApyDaily(\n      filters: { productId: $productId, range: $range }\n      first: 500\n      orderBy: time\n      orderDirection: asc\n    ) {\n      items {\n        date\n        apy {\n          net\n          base\n          rewards\n        }\n      }\n      pagination {\n        count\n        countTotal\n      }\n    }\n  }\n";
+/**
+ * The borrow-side twin of MARKET_HISTORY. Same daily shape and the same
+ * mean/stddev question — but for borrow the stat measures how much the *cost*
+ * moves, not the yield. A stable borrow rate is the signal a fixed-horizon
+ * borrower needs.
+ */
+export declare const BORROW_HISTORY = "\n  query BorrowHistory($productId: String!, $range: String!) {\n    borrowApyDaily(\n      filters: { productId: $productId, range: $range }\n      first: 500\n      orderBy: time\n      orderDirection: asc\n    ) {\n      items {\n        date\n        apy {\n          net\n          base\n          rewards\n        }\n      }\n      pagination {\n        count\n        countTotal\n      }\n    }\n  }\n";

package/dist/core/graphql/queries.js

@@ -81,6 +81,77 @@ export const LATEST_SUPPLY_APY = /* GraphQL */ `
     }
   }
 `;
+/**
+ * Borrow rows carry two fields supply rows don't: `borrowAssetsUsd` (how much of
+ * the pool is drawn) and the `collaterals` accepted against the loan. Selecting
+ * them here — not on the shared supply fragment — is deliberate: a supply market
+ * state has no `borrowAssetsUsd`, so asking for it there is a schema error.
+ */
+const BORROW_SNAPSHOT_FIELDS = /* GraphQL */ `
+  items {
+    hour
+    productId
+    asset
+    chainId
+    apy {
+      base
+      rewards
+      fees
+      net
+    }
+    market {
+      supplyAssetsUsd
+      borrowAssetsUsd
+      utilizationRate
+    }
+    quality {
+      status
+      count
+      expectedCount
+    }
+    collaterals {
+      symbol
+    }
+    product {
+      protocol {
+        provider
+        name
+        chain {
+          id
+          name
+        }
+      }
+    }
+  }
+  pagination {
+    count
+    countTotal
+    limit
+    skip
+  }
+`;
+/**
+ * Current best borrow markets. Borrow net APY is a COST (base + fees − rewards),
+ * so the cheapest market has the LOWEST net — the opposite of supply.
+ *
+ * `orderDirection: asc` is set explicitly as defense in depth. Upstream now
+ * defaults `latestBorrowApy` to asc too (best-first, kind-aware), so this only
+ * restates that default — but pinning it here keeps the ranking correct even if
+ * that default is ever changed back, and makes the intent legible at the call
+ * site rather than depending on a server-side convention.
+ */
+export const LATEST_BORROW_APY = /* GraphQL */ `
+  query LatestBorrowApy($filters: LatestBorrowFilters, $first: Int) {
+    latestBorrowApy(
+      filters: $filters
+      first: $first
+      orderBy: apyNet
+      orderDirection: asc
+    ) {
+      ${BORROW_SNAPSHOT_FIELDS}
+    }
+  }
+`;
 /**
  * Latest snapshot for an explicit set of products — the optimizer's APY source.
  *
@@ -205,3 +276,32 @@ export const MARKET_HISTORY = /* GraphQL */ `
     }
   }
 `;
+/**
+ * The borrow-side twin of MARKET_HISTORY. Same daily shape and the same
+ * mean/stddev question — but for borrow the stat measures how much the *cost*
+ * moves, not the yield. A stable borrow rate is the signal a fixed-horizon
+ * borrower needs.
+ */
+export const BORROW_HISTORY = /* GraphQL */ `
+  query BorrowHistory($productId: String!, $range: String!) {
+    borrowApyDaily(
+      filters: { productId: $productId, range: $range }
+      first: 500
+      orderBy: time
+      orderDirection: asc
+    ) {
+      items {
+        date
+        apy {
+          net
+          base
+          rewards
+        }
+      }
+      pagination {
+        count
+        countTotal
+      }
+    }
+  }
+`;

package/dist/core/tools/find-best-markets.d.ts

@@ -1,5 +1,9 @@
 import { z } from 'zod';
 export declare const findBestMarketsArgs: {
+    kind: z.ZodDefault<z.ZodEnum<{
+        supply: "supply";
+        borrow: "borrow";
+    }>>;
     asset: z.ZodOptional<z.ZodString>;
     chainId: z.ZodOptional<z.ZodNumber>;
     protocol: z.ZodOptional<z.ZodEnum<{
@@ -7,25 +11,34 @@ export declare const findBestMarketsArgs: {
         morpho: "morpho";
         compound: "compound";
     }>>;
+    collateral: z.ZodOptional<z.ZodString>;
     minTvlUsd: z.ZodDefault<z.ZodNumber>;
     limit: z.ZodDefault<z.ZodNumber>;
 };
 /**
- * Current best supply markets by net APY. Reads the server-side latest-snapshot
- * query, so the ranking and the TVL floor are both applied in Postgres — this
- * never pages the catalogue and reduces client-side.
+ * Current best markets, either side of the book.
+ *
+ * Both kinds read a server-side latest-snapshot query, so the ranking and the
+ * TVL floor are applied in Postgres — this never pages the catalogue. The two
+ * sides rank in opposite directions: supply by highest net APY (most earned),
+ * borrow by lowest (cheapest cost). That inversion lives in the GraphQL
+ * documents (`LATEST_BORROW_APY` sends `orderDirection: asc`), so here we only
+ * pick the document.
  */
 export declare function findBestMarkets(raw: unknown): Promise<{
     disclaimer: string;
     warning?: string | undefined;
     hint?: string | undefined;
     query: {
+        kind: "supply" | "borrow";
         asset: string | undefined;
         chainId: number | undefined;
         protocol: "aave" | "morpho" | "compound" | undefined;
+        collateral: string | undefined;
         minTvlUsd: number;
         limit: number;
     };
+    ranking: string;
     matched: number;
     returned: number;
     markets: import("./shared.js").DescribedMarket[];

package/dist/core/tools/find-best-markets.js

@@ -1,9 +1,14 @@
 import { z } from 'zod';
 import { DEFAULT_MIN_TVL_USD, NOT_ADVICE } from '../config.js';
 import { gql } from '../graphql/client.js';
-import { LATEST_SUPPLY_APY, } from '../graphql/queries.js';
+import { LATEST_BORROW_APY, LATEST_SUPPLY_APY, } from '../graphql/queries.js';
 import { describeRow, isUnreliable } from './shared.js';
 export const findBestMarketsArgs = {
+    kind: z
+        .enum(['supply', 'borrow'])
+        .default('supply')
+        .describe('supply = earn yield (best = highest net APY). borrow = take a loan ' +
+        '(best = LOWEST net APY, i.e. cheapest cost). Defaults to supply.'),
     asset: z
         .string()
         .optional()
@@ -13,30 +18,54 @@ export const findBestMarketsArgs = {
         .enum(['aave', 'morpho', 'compound'])
         .optional()
         .describe('Protocol provider.'),
+    collateral: z
+        .string()
+        .optional()
+        .describe('Borrow only: filter by collateral asset symbol (e.g. WETH). Valid values ' +
+        'come from the `collaterals` on returned borrow rows, not guessed. ' +
+        'Ignored when kind is supply.'),
     minTvlUsd: z
         .number()
         .nonnegative()
         .default(DEFAULT_MIN_TVL_USD)
-        .describe('Minimum supplied TVL in USD. Defaults to $1M — in a thinner market the ' +
-        'headline APY is mostly noise. Lower it deliberately, not by accident.'),
+        .describe('Minimum supplied pool depth in USD. Defaults to $1M — in a thinner ' +
+        'market the headline rate is mostly noise (and, for borrow, the pool ' +
+        'may be too shallow to draw from). Lower it deliberately, not by accident.'),
     limit: z.number().int().min(1).max(50).default(10),
 };
 const Args = z.object(findBestMarketsArgs);
 /**
- * Current best supply markets by net APY. Reads the server-side latest-snapshot
- * query, so the ranking and the TVL floor are both applied in Postgres — this
- * never pages the catalogue and reduces client-side.
+ * Current best markets, either side of the book.
+ *
+ * Both kinds read a server-side latest-snapshot query, so the ranking and the
+ * TVL floor are applied in Postgres — this never pages the catalogue. The two
+ * sides rank in opposite directions: supply by highest net APY (most earned),
+ * borrow by lowest (cheapest cost). That inversion lives in the GraphQL
+ * documents (`LATEST_BORROW_APY` sends `orderDirection: asc`), so here we only
+ * pick the document.
  */
 export async function findBestMarkets(raw) {
-    const { asset, chainId, protocol, minTvlUsd, limit } = Args.parse(raw);
-    const data = await gql(LATEST_SUPPLY_APY, {
-        filters: { asset, chainId, protocol, minTvlUsd },
-        first: limit,
-    });
-    const { items, pagination } = data.latestSupplyApy;
+    const { kind, asset, chainId, protocol, collateral, minTvlUsd, limit } = Args.parse(raw);
+    const isBorrow = kind === 'borrow';
+    const document = isBorrow ? LATEST_BORROW_APY : LATEST_SUPPLY_APY;
+    // `collateral` is a borrow-only filter; sending it on the supply side would be
+    // rejected by the schema, so it's dropped there rather than passed through.
+    const filters = {
+        asset,
+        chainId,
+        protocol,
+        minTvlUsd,
+        ...(isBorrow ? { collateral } : {}),
+    };
+    const data = await gql(document, { filters, first: limit });
+    // Exactly one key is present — the one for the document we sent.
+    const { items, pagination } = (isBorrow ? data.latestBorrowApy : data.latestSupplyApy);
     const markets = items.map(describeRow);
     return {
-        query: { asset, chainId, protocol, minTvlUsd, limit },
+        query: { kind, asset, chainId, protocol, collateral, minTvlUsd, limit },
+        ranking: isBorrow
+            ? 'By net borrow cost APY, cheapest first — lower is better.'
+            : 'By net supply APY, highest first.',
         matched: pagination.countTotal,
         returned: markets.length,
         markets,

package/dist/core/tools/get-market-details.d.ts

@@ -62,6 +62,8 @@ export declare function getMarketDetails(raw: unknown): Promise<{
         };
         tvlUsd: number | null;
         utilizationRate: number | null;
+        borrowedUsd?: number | null;
+        collaterals?: string[];
         asOf: string;
         quality: {
             status: string;

package/dist/core/tools/get-market-history.d.ts

@@ -1,6 +1,10 @@
 import { z } from 'zod';
 export declare const getMarketHistoryArgs: {
     productId: z.ZodString;
+    kind: z.ZodDefault<z.ZodEnum<{
+        supply: "supply";
+        borrow: "borrow";
+    }>>;
     range: z.ZodDefault<z.ZodEnum<{
         "7d": "7d";
         "30d": "30d";
@@ -9,14 +13,17 @@ export declare const getMarketHistoryArgs: {
     }>>;
 };
 /**
- * Daily net-APY series plus its mean / stddev / min / max.
+ * Daily net-APY series plus its mean / stddev / min / max, for either side.
  *
  * The stats are the deliverable, not the series. A snapshot cannot distinguish a
- * durable 6% from a 12% reward spike that ends next week; a 180-day standard
- * deviation can. That is the signal a 6-month horizon actually needs.
+ * durable rate from a reward spike that ends next week; a 180-day standard
+ * deviation can. For supply that stability is the yield you can count on; for
+ * borrow it is the cost you can count on. Same maths, opposite reading — hence
+ * the kind-dependent interpretation copy.
  */
 export declare function getMarketHistory(raw: unknown): Promise<{
     productId: string;
+    kind: "supply" | "borrow";
     range: "7d" | "30d" | "90d" | "180d";
     observations: number;
     hint: string;
@@ -26,6 +33,7 @@ export declare function getMarketHistory(raw: unknown): Promise<{
     series?: undefined;
 } | {
     productId: string;
+    kind: "supply" | "borrow";
     range: "7d" | "30d" | "90d" | "180d";
     observations: number;
     netApy: {

package/dist/core/tools/get-market-history.js

@@ -1,10 +1,15 @@
 import { z } from 'zod';
 import { NOT_ADVICE } from '../config.js';
 import { gql } from '../graphql/client.js';
-import { MARKET_HISTORY } from '../graphql/queries.js';
+import { BORROW_HISTORY, MARKET_HISTORY } from '../graphql/queries.js';
 import { stats } from '../stats.js';
 export const getMarketHistoryArgs = {
     productId: z.string().min(1).describe('Exact productId from find_best_markets.'),
+    kind: z
+        .enum(['supply', 'borrow'])
+        .default('supply')
+        .describe('Which side to chart. Must match the productId — a borrow productId ends ' +
+        'in :borrow. Defaults to supply.'),
     range: z
         .enum(['7d', '30d', '90d', '180d'])
         .default('90d')
@@ -12,31 +17,40 @@ export const getMarketHistoryArgs = {
 };
 const Args = z.object(getMarketHistoryArgs);
 /**
- * Daily net-APY series plus its mean / stddev / min / max.
+ * Daily net-APY series plus its mean / stddev / min / max, for either side.
  *
  * The stats are the deliverable, not the series. A snapshot cannot distinguish a
- * durable 6% from a 12% reward spike that ends next week; a 180-day standard
- * deviation can. That is the signal a 6-month horizon actually needs.
+ * durable rate from a reward spike that ends next week; a 180-day standard
+ * deviation can. For supply that stability is the yield you can count on; for
+ * borrow it is the cost you can count on. Same maths, opposite reading — hence
+ * the kind-dependent interpretation copy.
  */
 export async function getMarketHistory(raw) {
-    const { productId, range } = Args.parse(raw);
-    const data = await gql(MARKET_HISTORY, { productId, range });
-    const items = data.supplyApyDaily.items;
+    const { productId, kind, range } = Args.parse(raw);
+    const isBorrow = kind === 'borrow';
+    const document = isBorrow ? BORROW_HISTORY : MARKET_HISTORY;
+    const data = await gql(document, { productId, range });
+    // Exactly one key is present — the one for the document we sent.
+    const items = (isBorrow ? data.borrowApyDaily : data.supplyApyDaily).items;
     // Non-finite APYs (Postgres double precision can hold NaN) are dropped, not
     // returned — a NaN in a series poisons every stat computed from it.
     const netStats = stats(items.map((d) => d.apy.net));
     if (!netStats) {
         return {
             productId,
+            kind,
             range,
             observations: 0,
             hint: 'No usable daily history for this product in that range. It may be ' +
-                'newly tracked — try a shorter range.',
+                'newly tracked, or the productId may not match the requested kind ' +
+                '(a borrow productId ends in :borrow). Try a shorter range.',
             disclaimer: NOT_ADVICE,
         };
     }
+    const volatile = netStats.mean > 0 && netStats.stddev / Math.abs(netStats.mean) > 0.5;
     return {
         productId,
+        kind,
         range,
         observations: netStats.count,
         netApy: {
@@ -45,9 +59,12 @@ export async function getMarketHistory(raw) {
             min: netStats.min,
             max: netStats.max,
         },
-        interpretation: netStats.mean > 0 && netStats.stddev / Math.abs(netStats.mean) > 0.5
-            ? 'Volatile: the spread is large relative to the mean, so the current ' +
-                'APY is a poor predictor of what you would actually earn.'
+        interpretation: volatile
+            ? isBorrow
+                ? 'Volatile: the spread is large relative to the mean, so the current ' +
+                    'rate is a poor predictor of what you would actually pay.'
+                : 'Volatile: the spread is large relative to the mean, so the current ' +
+                    'APY is a poor predictor of what you would actually earn.'
             : 'Relatively stable over this window.',
         series: items.map((d) => ({
             date: d.date,

package/dist/core/tools/shared.d.ts

@@ -16,6 +16,10 @@ export interface DescribedMarket {
     };
     tvlUsd: number | null;
     utilizationRate: number | null;
+    /** Borrow rows only: value currently drawn from the pool. Absent for supply. */
+    borrowedUsd?: number | null;
+    /** Borrow rows only: accepted collateral symbols. Absent for supply. */
+    collaterals?: string[];
     /** Snapshot time — every response says how fresh it is. */
     asOf: string;
     quality: {

package/dist/core/tools/shared.js

@@ -32,6 +32,15 @@ export function describeRow(row) {
         },
         tvlUsd: finite(row.market.supplyAssetsUsd),
         utilizationRate: finite(row.market.utilizationRate),
+        // Borrow-only fields, keyed off what the document actually selected rather
+        // than a passed-in kind: a supply document omits both, a borrow one carries
+        // them, so their presence on the row is the ground truth.
+        ...(row.market.borrowAssetsUsd !== undefined
+            ? { borrowedUsd: finite(row.market.borrowAssetsUsd) }
+            : {}),
+        ...(row.collaterals !== undefined
+            ? { collaterals: row.collaterals.map((c) => c.symbol) }
+            : {}),
         asOf: row.hour,
         quality: reliability(row),
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lendwise/mcp",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Unified view for lending markets, one standard — MCP server to compare and optimize DeFi supply/borrow across Aave, Morpho and Compound.",
   "license": "MIT",
   "type": "module",