@compass-labs/api-sdk 1.5.1 → 1.5.2

package/src/funcs/earnEarnManage.ts

@@ -0,0 +1,181 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { CompassApiSDKCore } from "../core.js";
+import { encodeJSON } from "../lib/encodings.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import * as components from "../models/components/index.js";
+import { CompassAPISDKError } from "../models/errors/compassapisdkerror.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Manage earn position
+ *
+ * @remarks
+ * Manage Earn Position in an Earn Account.
+ *
+ * Market Types:
+ * - VAULTS
+ * - AAVE
+ *
+ * If `DEPOSIT` is selected for `action`, tokens will be deposited to the market from the `owner`'s Earn Account.
+ *
+ * If `WITHDRAW` is selected, tokens will be withdrawn from the market to the `owner`'s Earn Account.
+ *
+ * A fee can be configured. This fee is deducted from the total `amount`. It can be expressed as a `FIXED` amount or a `PERCENTAGE`.
+ *
+ * The transaction can be gas-sponsored by an arbitrary wallet address. Where the owner of said wallet will sign, submit and pay the required gas for the transaction. If `gas_sponsorship` is set to `true`, EIP-712 typed data will be returned that must be signed by the `owner` and submitted to the 'Prepare gas-sponsored transaction' endpoint (`/gas_sponsorship/prepare`) where the `sender` of the transaction can be set.
+ */
+export function earnEarnManage(
+  client: CompassApiSDKCore,
+  request: components.EarnManageRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    components.EarnManageResponse,
+    | errors.HTTPValidationError
+    | CompassAPISDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: CompassApiSDKCore,
+  request: components.EarnManageRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      components.EarnManageResponse,
+      | errors.HTTPValidationError
+      | CompassAPISDKError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) => components.EarnManageRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = encodeJSON("body", payload, { explode: true });
+
+  const path = pathToFunc("/v2/earn/manage")();
+
+  const headers = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: "application/json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.apiKeyAuth);
+  const securityInput = secConfig == null ? {} : { apiKeyAuth: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "v2_earn_manage",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.apiKeyAuth,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "POST",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    body: body,
+    userAgent: client._options.userAgent,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    errorCodes: ["422", "4XX", "5XX"],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result] = await M.match<
+    components.EarnManageResponse,
+    | errors.HTTPValidationError
+    | CompassAPISDKError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, components.EarnManageResponse$inboundSchema),
+    M.jsonErr(422, errors.HTTPValidationError$inboundSchema),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req, { extraFields: responseFields });
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/funcs/earnEarnPositions.ts

@@ -27,7 +27,7 @@ import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
 
 /**
- * Get list of earn positions
+ * List earn positions
  *
  * @remarks
  * This endpoint fetches all Compass Earn positions.

package/src/funcs/{gaslessGaslessPreparePermit.ts → earnEarnPositionsPositionId.ts}

@@ -3,7 +3,7 @@
  */
 
 import { CompassApiSDKCore } from "../core.js";
-import { encodeJSON } from "../lib/encodings.js";
+import { encodeFormQuery, encodeSimple } from "../lib/encodings.js";
 import * as M from "../lib/matchers.js";
 import { compactMap } from "../lib/primitives.js";
 import { safeParse } from "../lib/schemas.js";
@@ -22,22 +22,23 @@ import {
 import * as errors from "../models/errors/index.js";
 import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
 import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
 import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
 
 /**
- * Prepare gasless funding
+ * Get individual earn position
  *
  * @remarks
- * ADD DESCRIPTION HERE
+ * This endpoint fetches a single Compass Earn position by its encoded ID.
  */
-export function gaslessGaslessPreparePermit(
+export function earnEarnPositionsPositionId(
   client: CompassApiSDKCore,
-  request: components.PreparePermitRequest,
+  request: operations.V2EarnPositionsPositionIdRequest,
   options?: RequestOptions,
 ): APIPromise<
   Result<
-    components.PreparePermitResponse,
+    components.EarnPositionResponse,
     | errors.HTTPValidationError
     | CompassAPISDKError
     | ResponseValidationError
@@ -58,12 +59,12 @@ export function gaslessGaslessPreparePermit(
 
 async function $do(
   client: CompassApiSDKCore,
-  request: components.PreparePermitRequest,
+  request: operations.V2EarnPositionsPositionIdRequest,
   options?: RequestOptions,
 ): Promise<
   [
     Result<
-      components.PreparePermitResponse,
+      components.EarnPositionResponse,
       | errors.HTTPValidationError
       | CompassAPISDKError
       | ResponseValidationError
@@ -79,19 +80,31 @@ async function $do(
 > {
   const parsed = safeParse(
     request,
-    (value) => components.PreparePermitRequest$outboundSchema.parse(value),
+    (value) =>
+      operations.V2EarnPositionsPositionIdRequest$outboundSchema.parse(value),
     "Input validation failed",
   );
   if (!parsed.ok) {
     return [parsed, { status: "invalid" }];
   }
   const payload = parsed.value;
-  const body = encodeJSON("body", payload, { explode: true });
+  const body = null;
 
-  const path = pathToFunc("/v2/gasless/prepare_permit")();
+  const pathParams = {
+    position_id: encodeSimple("position_id", payload.position_id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+
+  const path = pathToFunc("/v2/earn/positions/{position_id}")(pathParams);
+
+  const query = encodeFormQuery({
+    "days": payload.days,
+    "user_address": payload.user_address,
+  });
 
   const headers = new Headers(compactMap({
-    "Content-Type": "application/json",
     Accept: "application/json",
   }));
 
@@ -102,7 +115,7 @@ async function $do(
   const context = {
     options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
-    operationID: "v2_gasless_prepare_permit",
+    operationID: "v2_earn_positions_{position_id}",
     oAuth2Scopes: null,
 
     resolvedSecurity: requestSecurity,
@@ -116,10 +129,11 @@ async function $do(
 
   const requestRes = client._createRequest(context, {
     security: requestSecurity,
-    method: "POST",
+    method: "GET",
     baseURL: options?.serverURL,
     path: path,
     headers: headers,
+    query: query,
     body: body,
     userAgent: client._options.userAgent,
     timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
@@ -145,7 +159,7 @@ async function $do(
   };
 
   const [result] = await M.match<
-    components.PreparePermitResponse,
+    components.EarnPositionResponse,
     | errors.HTTPValidationError
     | CompassAPISDKError
     | ResponseValidationError
@@ -156,7 +170,7 @@ async function $do(
     | UnexpectedClientError
     | SDKValidationError
   >(
-    M.json(200, components.PreparePermitResponse$inboundSchema),
+    M.json(200, components.EarnPositionResponse$inboundSchema),
     M.jsonErr(422, errors.HTTPValidationError$inboundSchema),
     M.fail("4XX"),
     M.fail("5XX"),

package/src/funcs/earnEarnTransfer.ts

@@ -26,10 +26,17 @@ import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
 
 /**
- * Fund earn account
+ * Transfer tokens to/from account
  *
  * @remarks
- * ADD DESCRIPTION HERE
+ * Transfer tokens to and from a Compass Earn Account.
+ *
+ * If `DEPOSIT`'` is selected, tokens will be transferred from the `owner`'s wallet into their Earn Account.
+ *
+ * If `WITHDRAW` is selected, tokens will be transferred from the `owner`'s Earn Account into their wallet.
+ *
+ * If a gas-sponsored `DEPOSIT` transfer is desired for a given token, a one-time Permit2 allowance must be set before proceeding. This is common practice for many other applications and, for many users, this one-time allowance will already have been set for the token they would like to transfer.
+ * Once the one-time allowance is set for a given token, EIP-712 typed data will be returned and can be signed off-chain by the user. This signature can then be submitted to the 'Prepare gas-sponsored transaction' endpoint (`/gas_sponsorship/prepare`).
  */
 export function earnEarnTransfer(
   client: CompassApiSDKCore,

package/src/funcs/{earnEarnWithdraw.ts → earnEarnVaults.ts}

@@ -3,7 +3,7 @@
  */
 
 import { CompassApiSDKCore } from "../core.js";
-import { encodeJSON } from "../lib/encodings.js";
+import { encodeFormQuery } from "../lib/encodings.js";
 import * as M from "../lib/matchers.js";
 import { compactMap } from "../lib/primitives.js";
 import { safeParse } from "../lib/schemas.js";
@@ -22,22 +22,23 @@ import {
 import * as errors from "../models/errors/index.js";
 import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
 import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
 import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
 
 /**
- * Withdraw earn position
+ * List vaults
  *
  * @remarks
- * ADD DESCRIPTION HERE
+ * This endpoint fetches a curated list of DeFi vaults.
  */
-export function earnEarnWithdraw(
+export function earnEarnVaults(
   client: CompassApiSDKCore,
-  request: components.EarnWithdrawRequest,
+  request: operations.V2EarnVaultsRequest,
   options?: RequestOptions,
 ): APIPromise<
   Result<
-    components.EarnWithdrawResponse,
+    components.VaultsListResponse,
     | errors.HTTPValidationError
     | CompassAPISDKError
     | ResponseValidationError
@@ -58,12 +59,12 @@ export function earnEarnWithdraw(
 
 async function $do(
   client: CompassApiSDKCore,
-  request: components.EarnWithdrawRequest,
+  request: operations.V2EarnVaultsRequest,
   options?: RequestOptions,
 ): Promise<
   [
     Result<
-      components.EarnWithdrawResponse,
+      components.VaultsListResponse,
       | errors.HTTPValidationError
       | CompassAPISDKError
       | ResponseValidationError
@@ -79,19 +80,26 @@ async function $do(
 > {
   const parsed = safeParse(
     request,
-    (value) => components.EarnWithdrawRequest$outboundSchema.parse(value),
+    (value) => operations.V2EarnVaultsRequest$outboundSchema.parse(value),
     "Input validation failed",
   );
   if (!parsed.ok) {
     return [parsed, { status: "invalid" }];
   }
   const payload = parsed.value;
-  const body = encodeJSON("body", payload, { explode: true });
+  const body = null;
 
-  const path = pathToFunc("/v2/earn/withdraw")();
+  const path = pathToFunc("/v2/earn/vaults")();
+
+  const query = encodeFormQuery({
+    "chain": payload.chain,
+    "direction": payload.direction,
+    "limit": payload.limit,
+    "offset": payload.offset,
+    "order_by": payload.order_by,
+  });
 
   const headers = new Headers(compactMap({
-    "Content-Type": "application/json",
     Accept: "application/json",
   }));
 
@@ -102,7 +110,7 @@ async function $do(
   const context = {
     options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
-    operationID: "v2_earn_withdraw",
+    operationID: "v2_earn_vaults",
     oAuth2Scopes: null,
 
     resolvedSecurity: requestSecurity,
@@ -116,10 +124,11 @@ async function $do(
 
   const requestRes = client._createRequest(context, {
     security: requestSecurity,
-    method: "POST",
+    method: "GET",
     baseURL: options?.serverURL,
     path: path,
     headers: headers,
+    query: query,
     body: body,
     userAgent: client._options.userAgent,
     timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
@@ -145,7 +154,7 @@ async function $do(
   };
 
   const [result] = await M.match<
-    components.EarnWithdrawResponse,
+    components.VaultsListResponse,
     | errors.HTTPValidationError
     | CompassAPISDKError
     | ResponseValidationError
@@ -156,7 +165,7 @@ async function $do(
     | UnexpectedClientError
     | SDKValidationError
   >(
-    M.json(200, components.EarnWithdrawResponse$inboundSchema),
+    M.json(200, components.VaultsListResponse$inboundSchema),
     M.jsonErr(422, errors.HTTPValidationError$inboundSchema),
     M.fail("4XX"),
     M.fail("5XX"),

package/src/funcs/{gaslessGaslessApproveTransfer.ts → gasSponsorshipGasSponsorshipApproveTransfer.ts}

@@ -26,12 +26,21 @@ import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
 
 /**
- * Approve transfer
+ * Approve token transfer
  *
  * @remarks
- * ADD DESCRIPTION HERE
+ * Prepare a one-time permit2 approval transaction for a given token.
+ *
+ * This is only required if the `owner` would like to transfer tokens from their wallet to their Earn Account with gas-sponsorship.
+ *
+ * This approval transaction itself can be submitted with gas-sponsorship.
+ * In this case, EIP-712 typed data will be returned and should be signed by the `owner` off-chain.
+ * This signature can then be submitted to the 'Prepare gas-sponsored transaction' endpoint (`/gas_sponsorship/prepare`).
+ * Gas-sponsored approvals can only be achieved by ERC-20 tokens that support permit (EIP-2612).
+ * Some tokens, like USDT and WETH, do not allow for this behavior.
+ * In the case of non-permit tokens, the one-time approval transaction can be submitted in the conventional manner where the `owner` must sign, submit and pay gas for the transaction.
  */
-export function gaslessGaslessApproveTransfer(
+export function gasSponsorshipGasSponsorshipApproveTransfer(
   client: CompassApiSDKCore,
   request: components.ApproveTransferRequest,
   options?: RequestOptions,
@@ -88,7 +97,7 @@ async function $do(
   const payload = parsed.value;
   const body = encodeJSON("body", payload, { explode: true });
 
-  const path = pathToFunc("/v2/gasless/approve_transfer")();
+  const path = pathToFunc("/v2/gas_sponsorship/approve_transfer")();
 
   const headers = new Headers(compactMap({
     "Content-Type": "application/json",
@@ -102,7 +111,7 @@ async function $do(
   const context = {
     options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
-    operationID: "v2_gasless_approve_transfer",
+    operationID: "v2_gas_sponsorship_approve_transfer",
     oAuth2Scopes: null,
 
     resolvedSecurity: requestSecurity,

package/src/funcs/{gaslessGaslessSponsorGas.ts → gasSponsorshipGasSponsorshipPrepare.ts}

@@ -26,12 +26,16 @@ import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
 
 /**
- * Send Compass Gasless Transaction
+ * Prepare gas-sponsored transaction
  *
  * @remarks
- * ADD DESCRIPTION HERE
+ * Prepare a gas-sponsored transaction to be signed and submitted by `sender`.
+ *
+ * The `owner` submits their off-chain signature of EIP-712 typed data along with the data itself.
+ *
+ * The `sender` will sign and submit the transaction returned from this endpoint, effectively sponsoring the gas for the transaction on behalf of the `owner`.
  */
-export function gaslessGaslessSponsorGas(
+export function gasSponsorshipGasSponsorshipPrepare(
   client: CompassApiSDKCore,
   request: components.SponsorGasRequest,
   options?: RequestOptions,
@@ -88,7 +92,7 @@ async function $do(
   const payload = parsed.value;
   const body = encodeJSON("body", payload, { explode: true });
 
-  const path = pathToFunc("/v2/gasless/sponsor_gas")();
+  const path = pathToFunc("/v2/gas_sponsorship/prepare")();
 
   const headers = new Headers(compactMap({
     "Content-Type": "application/json",
@@ -102,7 +106,7 @@ async function $do(
   const context = {
     options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
-    operationID: "v2_gasless_sponsor_gas",
+    operationID: "v2_gas_sponsorship_prepare",
     oAuth2Scopes: null,
 
     resolvedSecurity: requestSecurity,

package/src/lib/config.ts

@@ -61,8 +61,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "0.0.1",
-  sdkVersion: "1.1.2",
-  genVersion: "2.753.7",
+  sdkVersion: "1.1.3",
+  genVersion: "2.755.6",
   userAgent:
-    "speakeasy-sdk/typescript 1.1.2 2.753.7 0.0.1 @compass-labs/api-sdk",
+    "speakeasy-sdk/typescript 1.1.3 2.755.6 0.0.1 @compass-labs/api-sdk",
 } as const;

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

@@ -19,7 +19,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "1.1.2",
+    currentVersion: "1.1.3",
   },
 });
 

package/src/mcp-server/server.ts

@@ -35,10 +35,11 @@ import { tool$aerodromeSlipstreamAerodromeSlipstreamPoolPrice } from "./tools/ae
 import { tool$aerodromeSlipstreamAerodromeSlipstreamSwapBuyExactly } from "./tools/aerodromeSlipstreamAerodromeSlipstreamSwapBuyExactly.js";
 import { tool$aerodromeSlipstreamAerodromeSlipstreamSwapSellExactly } from "./tools/aerodromeSlipstreamAerodromeSlipstreamSwapSellExactly.js";
 import { tool$earnEarnCreateAccount } from "./tools/earnEarnCreateAccount.js";
-import { tool$earnEarnDeposit } from "./tools/earnEarnDeposit.js";
+import { tool$earnEarnManage } from "./tools/earnEarnManage.js";
 import { tool$earnEarnPositions } from "./tools/earnEarnPositions.js";
+import { tool$earnEarnPositionsPositionId } from "./tools/earnEarnPositionsPositionId.js";
 import { tool$earnEarnTransfer } from "./tools/earnEarnTransfer.js";
-import { tool$earnEarnWithdraw } from "./tools/earnEarnWithdraw.js";
+import { tool$earnEarnVaults } from "./tools/earnEarnVaults.js";
 import { tool$erc4626VaultsVaultsDeposit } from "./tools/erc4626VaultsVaultsDeposit.js";
 import { tool$erc4626VaultsVaultsVault } from "./tools/erc4626VaultsVaultsVault.js";
 import { tool$erc4626VaultsVaultsWithdraw } from "./tools/erc4626VaultsVaultsWithdraw.js";
@@ -46,9 +47,8 @@ import { tool$ethenaEthenaDeposit } from "./tools/ethenaEthenaDeposit.js";
 import { tool$ethenaEthenaRequest } from "./tools/ethenaEthenaRequest.js";
 import { tool$ethenaEthenaUnstake } from "./tools/ethenaEthenaUnstake.js";
 import { tool$ethenaEthenaVault } from "./tools/ethenaEthenaVault.js";
-import { tool$gaslessGaslessApproveTransfer } from "./tools/gaslessGaslessApproveTransfer.js";
-import { tool$gaslessGaslessPreparePermit } from "./tools/gaslessGaslessPreparePermit.js";
-import { tool$gaslessGaslessSponsorGas } from "./tools/gaslessGaslessSponsorGas.js";
+import { tool$gasSponsorshipGasSponsorshipApproveTransfer } from "./tools/gasSponsorshipGasSponsorshipApproveTransfer.js";
+import { tool$gasSponsorshipGasSponsorshipPrepare } from "./tools/gasSponsorshipGasSponsorshipPrepare.js";
 import { tool$morphoMorphoBorrow } from "./tools/morphoMorphoBorrow.js";
 import { tool$morphoMorphoDeposit } from "./tools/morphoMorphoDeposit.js";
 import { tool$morphoMorphoMarket } from "./tools/morphoMorphoMarket.js";
@@ -111,7 +111,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "CompassApiSDK",
-    version: "1.1.2",
+    version: "1.1.3",
   });
 
   const client = new CompassApiSDKCore({
@@ -220,14 +220,14 @@ export function createMCPServer(deps: {
   tool(tool$ethenaEthenaRequest);
   tool(tool$ethenaEthenaUnstake);
   tool(tool$wildcatWildcatMarket);
-  tool(tool$gaslessGaslessApproveTransfer);
-  tool(tool$gaslessGaslessPreparePermit);
-  tool(tool$gaslessGaslessSponsorGas);
+  tool(tool$gasSponsorshipGasSponsorshipPrepare);
+  tool(tool$gasSponsorshipGasSponsorshipApproveTransfer);
   tool(tool$earnEarnPositions);
+  tool(tool$earnEarnPositionsPositionId);
+  tool(tool$earnEarnVaults);
   tool(tool$earnEarnCreateAccount);
   tool(tool$earnEarnTransfer);
-  tool(tool$earnEarnDeposit);
-  tool(tool$earnEarnWithdraw);
+  tool(tool$earnEarnManage);
 
   return server;
 }

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

@@ -14,7 +14,17 @@ export const tool$earnEarnCreateAccount: ToolDefinition<typeof args> = {
   name: "earn-earn-create-account",
   description: `Create earn account
 
-ADD DESCRIPTION HERE`,
+Create a Compass Earn Account.
+
+Before creating Earn positions you must create a Compass Earn Account. This account will be associated with the \`owner\` wallet address.
+
+Only the \`owner\` has the authority to sign transactions for this account. This can be done in one of two ways:
+
+1) The \`owner\` signs an unsigned transaction and submits to the network for execution. The \`owner\` covers the cost of gas in this case.
+
+2) The \`owner\` does an off-chain EIP-712 signature and submits this signature to the 'Prepare gas-sponsored transaction' endpoint (\`/gas_sponsorship/prepare\`).
+
+The creation of an Earn Account itself can be a gas-sponsored transaction by setting the \`sender\` to the wallet which will sign and send the transaction.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await earnEarnCreateAccount(