@compass-labs/api-sdk 0.1.2 → 0.1.3

package/src/mcp-server/server.ts

@@ -89,7 +89,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "CompassApiSDK",
-    version: "0.1.2",
+    version: "0.1.3",
   });
 
   const client = new CompassApiSDKCore({
@@ -119,10 +119,10 @@ export function createMCPServer(deps: {
   const register = { tool, resource, resourceTemplate, prompt };
   void register; // suppress unused warnings
 
-  tool(tool$aaveV3StdRate);
+  tool(tool$aaveV3Rate);
   tool(tool$aaveV3AvgRate);
+  tool(tool$aaveV3StdRate);
   tool(tool$aaveV3ReserveOverview);
-  tool(tool$aaveV3Rate);
   tool(tool$aaveV3TokenPrice);
   tool(tool$aaveV3LiquidityChange);
   tool(tool$aaveV3UserPositionSummary);

package/src/mcp-server/tools/aaveV3AvgRate.ts

@@ -12,9 +12,9 @@ const args = {
 
 export const tool$aaveV3AvgRate: ToolDefinition<typeof args> = {
   name: "aave-v3-avg-rate",
-  description: `Average interest rates
+  description: `Interest Rates: time average
 
-Returns time averaged Interest Rates for Aave Reserves.`,
+Provides time-weighted averages of deposit and borrow rates for Aave reserves.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await aaveV3AvgRate(

package/src/mcp-server/tools/aaveV3Rate.ts

@@ -12,7 +12,7 @@ const args = {
 
 export const tool$aaveV3Rate: ToolDefinition<typeof args> = {
   name: "aave-v3-rate",
-  description: `Interest rates
+  description: `Interest Rates: now
 
 Returns the latest APY and APR rates for a specified token on Aave, for both
 deposits and loans.

package/src/mcp-server/tools/aaveV3StdRate.ts

@@ -12,9 +12,10 @@ const args = {
 
 export const tool$aaveV3StdRate: ToolDefinition<typeof args> = {
   name: "aave-v3-std-rate",
-  description: `Standard deviation of interest rates
+  description: `Interest Rates: standard deviation
 
-Returns the standard deviation of Interest Rates for Aave Reserves over time.`,
+Returns the historical standard deviation of lending and borrowing rates for Aave
+reserves, illustrating market volatility.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await aaveV3StdRate(

package/src/sdk/aavev3.ts

@@ -22,16 +22,29 @@ import { unwrapAsync } from "../types/fp.js";
 
 export class AaveV3 extends ClientSDK {
   /**
-   * Standard deviation of interest rates
+   * Interest Rates: now
    *
    * @remarks
-   * Returns the standard deviation of Interest Rates for Aave Reserves over time.
+   * Returns the latest APY and APR rates for a specified token on Aave, for both
+   * deposits and loans.
+   *
+   * **Annual percentage yield (APY)** is the yearly return/cost after continuous
+   * compounding of the per-second rate stored on-chain. This value is the same value as
+   * seen the on [app.aave.com](
+   * https://app.aave.com/)
+   * but more up-to-date as it is taken directly from the
+   * blockchain every time this endpoint is called.
+   *
+   * **Annual percentage rate (APR)** is the yearly simple interest rate (no
+   * compounding).
+   *
+   * For APY/APR on loans Aave offers both stable and fixed rates on certain tokens.
    */
-  async stdRate(
-    request: operations.AaveStdRateRequest,
+  async rate(
+    request: operations.AaveRateRequest,
     options?: RequestOptions,
-  ): Promise<components.AaveSTDRateResponse> {
-    return unwrapAsync(aaveV3StdRate(
+  ): Promise<components.AaveRateResponse> {
+    return unwrapAsync(aaveV3Rate(
       this,
       request,
       options,
@@ -39,10 +52,10 @@ export class AaveV3 extends ClientSDK {
   }
 
   /**
-   * Average interest rates
+   * Interest Rates: time average
    *
    * @remarks
-   * Returns time averaged Interest Rates for Aave Reserves.
+   * Provides time-weighted averages of deposit and borrow rates for Aave reserves.
    */
   async avgRate(
     request: operations.AaveAvgRateRequest,
@@ -56,21 +69,17 @@ export class AaveV3 extends ClientSDK {
   }
 
   /**
-   * Reserve overview
+   * Interest Rates: standard deviation
    *
    * @remarks
-   * Returns key metrics for Aave Reserves:
-   * - Total Supplied (TVL) in USD
-   * - Total Borrowed in USD
-   * - Utilization Ratio
-   *
-   * See below for more info:
+   * Returns the historical standard deviation of lending and borrowing rates for Aave
+   * reserves, illustrating market volatility.
    */
-  async reserveOverview(
-    request: operations.AaveReserveOverviewRequest,
+  async stdRate(
+    request: operations.AaveStdRateRequest,
     options?: RequestOptions,
-  ): Promise<components.AaveReserveOverviewResponse> {
-    return unwrapAsync(aaveV3ReserveOverview(
+  ): Promise<components.AaveSTDRateResponse> {
+    return unwrapAsync(aaveV3StdRate(
       this,
       request,
       options,
@@ -78,29 +87,21 @@ export class AaveV3 extends ClientSDK {
   }
 
   /**
-   * Interest rates
+   * Reserve overview
    *
    * @remarks
-   * Returns the latest APY and APR rates for a specified token on Aave, for both
-   * deposits and loans.
-   *
-   * **Annual percentage yield (APY)** is the yearly return/cost after continuous
-   * compounding of the per-second rate stored on-chain. This value is the same value as
-   * seen the on [app.aave.com](
-   * https://app.aave.com/)
-   * but more up-to-date as it is taken directly from the
-   * blockchain every time this endpoint is called.
-   *
-   * **Annual percentage rate (APR)** is the yearly simple interest rate (no
-   * compounding).
+   * Returns key metrics for Aave Reserves:
+   * - Total Supplied (TVL) in USD
+   * - Total Borrowed in USD
+   * - Utilization Ratio
    *
-   * For APY/APR on loans Aave offers both stable and fixed rates on certain tokens.
+   * See below for more info:
    */
-  async rate(
-    request: operations.AaveRateRequest,
+  async reserveOverview(
+    request: operations.AaveReserveOverviewRequest,
     options?: RequestOptions,
-  ): Promise<components.AaveRateResponse> {
-    return unwrapAsync(aaveV3Rate(
+  ): Promise<components.AaveReserveOverviewResponse> {
+    return unwrapAsync(aaveV3ReserveOverview(
       this,
       request,
       options,